diff --git a/docs/src/content/docs/assets/features/code-action-rename.gif b/docs/src/content/docs/assets/features/code-action-rename.gif
new file mode 100644
index 000000000..a0e51d241
Binary files /dev/null and b/docs/src/content/docs/assets/features/code-action-rename.gif differ
diff --git a/docs/src/content/docs/assets/features/completion.gif b/docs/src/content/docs/assets/features/completion.gif
new file mode 100644
index 000000000..646398b6d
Binary files /dev/null and b/docs/src/content/docs/assets/features/completion.gif differ
diff --git a/docs/src/content/docs/assets/features/goto-def.gif b/docs/src/content/docs/assets/features/goto-def.gif
new file mode 100644
index 000000000..d8d7efb6d
Binary files /dev/null and b/docs/src/content/docs/assets/features/goto-def.gif differ
diff --git a/docs/src/content/docs/assets/features/inlay-hints.gif b/docs/src/content/docs/assets/features/inlay-hints.gif
new file mode 100644
index 000000000..d1b288b28
Binary files /dev/null and b/docs/src/content/docs/assets/features/inlay-hints.gif differ
diff --git a/docs/src/content/docs/assets/features/missing-port.gif b/docs/src/content/docs/assets/features/missing-port.gif
new file mode 100644
index 000000000..5753b5eda
Binary files /dev/null and b/docs/src/content/docs/assets/features/missing-port.gif differ
diff --git a/docs/src/content/docs/en/user-guide/daily-use/diagnostics.mdx b/docs/src/content/docs/en/user-guide/daily-use/diagnostics.mdx
index d965cd80d..fef5fdd9e 100644
--- a/docs/src/content/docs/en/user-guide/daily-use/diagnostics.mdx
+++ b/docs/src/content/docs/en/user-guide/daily-use/diagnostics.mdx
@@ -5,7 +5,7 @@ description: Use Vide diagnostics and handle refresh timing, stale results, and
import FeatureExample from '../../../../../components/FeatureExample.astro';
import VideLab from '../../../../../components/VideLab.astro';
-import codeActionsGif from '../../../assets/features/code-actions.gif';
+import missingPortGif from '../../../assets/features/missing-port.gif';
import { diagnosticFiles } from '../../../../../examples/dailyUse';
Diagnostics appear in the VS Code `Problems` panel and as editor underlines. Syntax and parse errors usually only need the current file; cross-file semantic diagnostics need project information such as `sources`, `include_dirs`, `defines`, and `libraries`.
@@ -25,22 +25,22 @@ If you need diagnostics while typing:
```
diff --git a/docs/src/content/docs/en/user-guide/daily-use/editing-assistance.mdx b/docs/src/content/docs/en/user-guide/daily-use/editing-assistance.mdx
index 32bdc6ddf..4b9bbb62e 100644
--- a/docs/src/content/docs/en/user-guide/daily-use/editing-assistance.mdx
+++ b/docs/src/content/docs/en/user-guide/daily-use/editing-assistance.mdx
@@ -5,7 +5,7 @@ description: Use completion, signature help, rename, port/parameter fixes, and d
import FeatureExample from '../../../../../components/FeatureExample.astro';
import VideLab from '../../../../../components/VideLab.astro';
-import codeActionsGif from '../../../assets/features/code-actions.gif';
+import codeActionRenameGif from '../../../assets/features/code-action-rename.gif';
import { editAidFiles } from '../../../../../examples/dailyUse';
Vide provides completion around instance connections, parameter assignments, expressions, preprocessor directives, and common RTL structures. Signature help shows target module parameters and ports while your cursor is in parameter or port lists.
@@ -13,21 +13,21 @@ Vide provides completion around instance connections, parameter assignments, exp
Related settings reference: [Signature Help](../../../advanced-guide/vscode-settings/#signature-help), [Diagnostics](../../../advanced-guide/vscode-settings/#diagnostics).
diff --git a/docs/src/content/docs/en/user-guide/daily-use/formatting.mdx b/docs/src/content/docs/en/user-guide/daily-use/formatting.mdx
index a01bc93a2..83cb160ba 100644
--- a/docs/src/content/docs/en/user-guide/daily-use/formatting.mdx
+++ b/docs/src/content/docs/en/user-guide/daily-use/formatting.mdx
@@ -3,34 +3,10 @@ title: Formatting
description: Use Verilog/SystemVerilog formatting and handle verible paths and arguments.
---
-import FeatureExample from '../../../../../components/FeatureExample.astro';
-import VideLab from '../../../../../components/VideLab.astro';
-import codeActionsGif from '../../../assets/features/code-actions.gif';
-import { formattingFiles } from '../../../../../examples/dailyUse';
-
Formatting entry points include VS Code's `Format Document`, `Format Selection`, and on-type formatting when pressing Enter. The only current formatter backend is `verible`, which calls the external `verible-verilog-format` executable; Vide does not bundle that tool.
Related settings reference: [Formatter and Formatting](../../../advanced-guide/vscode-settings/#formatter-and-formatting).
-
-
-
-
## Configure verible the First Time
If `verible-verilog-format` is already on the `PATH` seen by VS Code, formatting can work without extra settings. When unsure, configure an absolute path:
diff --git a/docs/src/content/docs/en/user-guide/daily-use/language-support.mdx b/docs/src/content/docs/en/user-guide/daily-use/language-support.mdx
index e26813546..779f12edf 100644
--- a/docs/src/content/docs/en/user-guide/daily-use/language-support.mdx
+++ b/docs/src/content/docs/en/user-guide/daily-use/language-support.mdx
@@ -5,7 +5,7 @@ description: Check how Vide recognizes Verilog/SystemVerilog files and where bas
import FeatureExample from '../../../../../components/FeatureExample.astro';
import VideLab from '../../../../../components/VideLab.astro';
-import codeActionsGif from '../../../assets/features/code-actions.gif';
+import completionGif from '../../../assets/features/completion.gif';
import { languageFiles } from '../../../../../examples/dailyUse';
The VS Code extension registers two language modes:
@@ -22,21 +22,21 @@ Diagnostics, go to definition, completion, hover, signature help, inlay hints, s
Related settings reference: [Semantic Tokens](../../../advanced-guide/vscode-settings/#semantic-tokens), [Files](../../../advanced-guide/vscode-settings/#files).
diff --git a/docs/src/content/docs/en/user-guide/daily-use/navigation.mdx b/docs/src/content/docs/en/user-guide/daily-use/navigation.mdx
index 335ec0563..da37667fe 100644
--- a/docs/src/content/docs/en/user-guide/daily-use/navigation.mdx
+++ b/docs/src/content/docs/en/user-guide/daily-use/navigation.mdx
@@ -5,7 +5,7 @@ description: Use definition, references, hover, and document highlights, and han
import FeatureExample from '../../../../../components/FeatureExample.astro';
import VideLab from '../../../../../components/VideLab.astro';
-import codeActionsGif from '../../../assets/features/code-actions.gif';
+import gotoDefGif from '../../../assets/features/goto-def.gif';
import { navigationFiles } from '../../../../../examples/dailyUse';
Vide provides these reading features:
@@ -18,21 +18,21 @@ Vide provides these reading features:
Related settings reference: [Scope](../../../advanced-guide/vscode-settings/#scope), [Semantic Tokens](../../../advanced-guide/vscode-settings/#semantic-tokens).
diff --git a/docs/src/content/docs/en/user-guide/daily-use/structure.mdx b/docs/src/content/docs/en/user-guide/daily-use/structure.mdx
index 972508c7c..bcdeecaa9 100644
--- a/docs/src/content/docs/en/user-guide/daily-use/structure.mdx
+++ b/docs/src/content/docs/en/user-guide/daily-use/structure.mdx
@@ -5,7 +5,7 @@ description: Use inlay hints, semantic highlighting, instance counts, outline, f
import FeatureExample from '../../../../../components/FeatureExample.astro';
import VideLab from '../../../../../components/VideLab.astro';
-import codeActionsGif from '../../../assets/features/code-actions.gif';
+import inlayHintsGif from '../../../assets/features/inlay-hints.gif';
import { structureFiles } from '../../../../../examples/dailyUse';
Structure help reduces the need to jump back and forth while reading RTL:
@@ -20,21 +20,21 @@ Structure help reduces the need to jump back and forth while reading RTL:
Related settings reference: [Inlay Hints](../../../advanced-guide/vscode-settings/#inlay-hints), [Lens](../../../advanced-guide/vscode-settings/#lens), [Semantic Tokens](../../../advanced-guide/vscode-settings/#semantic-tokens).
diff --git a/docs/src/content/docs/user-guide/daily-use/diagnostics.mdx b/docs/src/content/docs/user-guide/daily-use/diagnostics.mdx
index 3c660b6d1..588f6d27a 100644
--- a/docs/src/content/docs/user-guide/daily-use/diagnostics.mdx
+++ b/docs/src/content/docs/user-guide/daily-use/diagnostics.mdx
@@ -5,7 +5,7 @@ description: 使用 Vide 诊断,并处理诊断太频繁、不更新、规则
import FeatureExample from '../../../../components/FeatureExample.astro';
import VideLab from '../../../../components/VideLab.astro';
-import codeActionsGif from '../../assets/features/code-actions.gif';
+import missingPortGif from '../../assets/features/missing-port.gif';
import { diagnosticFiles } from '../../../../examples/dailyUse';
诊断会显示在 VS Code 的 `Problems` 面板和编辑器下划线里。语法错误、解析错误通常只需要当前文件;跨文件语义诊断需要项目配置里的 `sources`、`include_dirs`、`defines`、`libraries` 等信息。
@@ -25,22 +25,22 @@ import { diagnosticFiles } from '../../../../examples/dailyUse';
```
diff --git a/docs/src/content/docs/user-guide/daily-use/editing-assistance.mdx b/docs/src/content/docs/user-guide/daily-use/editing-assistance.mdx
index b8eca4987..6b78a6bf2 100644
--- a/docs/src/content/docs/user-guide/daily-use/editing-assistance.mdx
+++ b/docs/src/content/docs/user-guide/daily-use/editing-assistance.mdx
@@ -5,7 +5,7 @@ description: 使用补全、签名帮助、重命名、端口/参数修复和诊
import FeatureExample from '../../../../components/FeatureExample.astro';
import VideLab from '../../../../components/VideLab.astro';
-import codeActionsGif from '../../assets/features/code-actions.gif';
+import codeActionRenameGif from '../../assets/features/code-action-rename.gif';
import { editAidFiles } from '../../../../examples/dailyUse';
Vide 会在实例连接、参数赋值、表达式、预处理指令和常见 RTL 结构附近提供补全。把光标放在实例参数或端口列表里时,签名帮助会显示目标模块的参数和端口信息。
@@ -13,21 +13,21 @@ Vide 会在实例连接、参数赋值、表达式、预处理指令和常见 RT
相关设置参考:[Signature Help](../../../advanced-guide/vscode-settings/#signature-help)、[Diagnostics](../../../advanced-guide/vscode-settings/#diagnostics)。
diff --git a/docs/src/content/docs/user-guide/daily-use/formatting.mdx b/docs/src/content/docs/user-guide/daily-use/formatting.mdx
index 78aad0f55..4e08bd385 100644
--- a/docs/src/content/docs/user-guide/daily-use/formatting.mdx
+++ b/docs/src/content/docs/user-guide/daily-use/formatting.mdx
@@ -3,34 +3,10 @@ title: 格式化
description: 使用 Verilog/SystemVerilog 格式化,并处理 verible 路径和参数问题。
---
-import FeatureExample from '../../../../components/FeatureExample.astro';
-import VideLab from '../../../../components/VideLab.astro';
-import codeActionsGif from '../../assets/features/code-actions.gif';
-import { formattingFiles } from '../../../../examples/dailyUse';
-
格式化入口包括 VS Code 的 `Format Document`、`Format Selection` 和按 Enter 时的自动缩进行为。当前格式化后端只有 `verible`,会调用外部 `verible-verilog-format`;Vide 不随扩展打包这个工具。
相关设置参考:[Formatter 和 Formatting](../../../advanced-guide/vscode-settings/#formatter-和-formatting)。
-
-
-
-
## 第一次配置 verible
如果 `verible-verilog-format` 已经在 VS Code 进程可见的 `PATH` 中,可以直接使用格式化命令。如果不确定,建议写绝对路径:
diff --git a/docs/src/content/docs/user-guide/daily-use/language-support.mdx b/docs/src/content/docs/user-guide/daily-use/language-support.mdx
index 4df0e5ae0..ed7f1911f 100644
--- a/docs/src/content/docs/user-guide/daily-use/language-support.mdx
+++ b/docs/src/content/docs/user-guide/daily-use/language-support.mdx
@@ -5,7 +5,7 @@ description: 确认 Vide 如何识别 Verilog/SystemVerilog 文件,以及基
import FeatureExample from '../../../../components/FeatureExample.astro';
import VideLab from '../../../../components/VideLab.astro';
-import codeActionsGif from '../../assets/features/code-actions.gif';
+import completionGif from '../../assets/features/completion.gif';
import { languageFiles } from '../../../../examples/dailyUse';
VS Code 扩展会注册两类语言:
@@ -22,21 +22,21 @@ VS Code 扩展会注册两类语言:
相关设置参考:[Semantic Tokens](../../../advanced-guide/vscode-settings/#semantic-tokens)、[Files](../../../advanced-guide/vscode-settings/#files)。
diff --git a/docs/src/content/docs/user-guide/daily-use/navigation.mdx b/docs/src/content/docs/user-guide/daily-use/navigation.mdx
index bfa0c2548..58922e545 100644
--- a/docs/src/content/docs/user-guide/daily-use/navigation.mdx
+++ b/docs/src/content/docs/user-guide/daily-use/navigation.mdx
@@ -5,7 +5,7 @@ description: 使用跳转、引用、悬停和文档高亮,并处理跳转失
import FeatureExample from '../../../../components/FeatureExample.astro';
import VideLab from '../../../../components/VideLab.astro';
-import codeActionsGif from '../../assets/features/code-actions.gif';
+import gotoDefGif from '../../assets/features/goto-def.gif';
import { navigationFiles } from '../../../../examples/dailyUse';
Vide 提供这些阅读能力:
@@ -18,21 +18,21 @@ Vide 提供这些阅读能力:
相关设置参考:[Scope](../../../advanced-guide/vscode-settings/#scope)、[Semantic Tokens](../../../advanced-guide/vscode-settings/#semantic-tokens)。
diff --git a/docs/src/content/docs/user-guide/daily-use/structure.mdx b/docs/src/content/docs/user-guide/daily-use/structure.mdx
index 7c65894d5..a8391fce6 100644
--- a/docs/src/content/docs/user-guide/daily-use/structure.mdx
+++ b/docs/src/content/docs/user-guide/daily-use/structure.mdx
@@ -5,7 +5,7 @@ description: 使用行内提示、语义高亮、实例数量提示、大纲、
import FeatureExample from '../../../../components/FeatureExample.astro';
import VideLab from '../../../../components/VideLab.astro';
-import codeActionsGif from '../../assets/features/code-actions.gif';
+import inlayHintsGif from '../../assets/features/inlay-hints.gif';
import { structureFiles } from '../../../../examples/dailyUse';
结构辅助的目标是让 RTL 阅读更少依赖来回跳转:
@@ -20,21 +20,21 @@ import { structureFiles } from '../../../../examples/dailyUse';
相关设置参考:[Inlay Hints](../../../advanced-guide/vscode-settings/#inlay-hints)、[Lens](../../../advanced-guide/vscode-settings/#lens)、[Semantic Tokens](../../../advanced-guide/vscode-settings/#semantic-tokens)。
diff --git a/docs/src/content/docs/user-guide/index.mdx b/docs/src/content/docs/user-guide/index.mdx
index 2abebb57f..3ec3f3b87 100644
--- a/docs/src/content/docs/user-guide/index.mdx
+++ b/docs/src/content/docs/user-guide/index.mdx
@@ -5,7 +5,7 @@ description: 面向日常 RTL 编辑者的 Vide 使用路径。
import { CardGrid, LinkCard } from '@astrojs/starlight/components';
-用户手册只放日常使用会遇到的内容:安装扩展、打开工程、写项目配置、使用编辑器能力,并在功能说明旁边给出常见问题处理方式。需要替换服务器、安装本地 VSIX、看日志或做性能分析时,再进入 [进阶](../advanced-guide/)。
+欢迎使用 Vide!请阅读用户手册快速开始吧。