Apps
Help Zh
# 帮助 — 文档浏览器
四个标签页:手册(语言手册)、参考(逐符号 API 文档)、
应用(各应用包自带的帮助)和 上下文(编辑器光标所在关键字/符号的文档)。
通过面板名称面板的“帮助”操作显式打开某个应用的帮助(位于该应用标题栏左上角);
它会切换到“应用”标签页并选中该应用。聚焦某个应用不再自动切换此面板。
应用帮助位于各应用包内的 `help/` 目录(`help/help.md` 是主页,其他 `.md`
文件是附加文档)。“应用”索引通过扫描已配置的包根目录发现,
因此新安装的、带有 `help/` 目录的应用会自动出现。
## 按键绑定
| 按键 | 操作 |
|-----|--------|
| `Up` | 向上滚动内容 |
| `Down` | 向下滚动内容 |
| `Page Up` | 向上滚动 10 行 |
| `Page Down` | 向下滚动 10 行 |
| `Home` | 滚动到文档顶部 |
| `End` | 滚动到文档底部 |
| `Ctrl+P` | 切换固定 — 固定后帮助停留在当前主题,忽略焦点/光标变化 |
| `Ctrl+Page Up` / `Ctrl+Page Down` | 切换标签页(手册 / 参考 / 应用 / 上下文) |
| `/` | 在面板底部打开文档内搜索框 |
| `Ctrl+Shift+/` | 在水平分屏中打开查找面板,用选中的词(双击)、否则用文档内查询、否则用上下文符号搜索 `*.md` 文档 |
| `i` | 打开当前标签页的索引对话框(手册 / 参考 / 应用) |
### 文档内搜索(`/`)
`/` 在底部一行打开搜索框,并在你输入时搜索当前标签页的文档。
匹配逐行高亮,视图会滚动到当前匹配项。
| 按键 | 操作 |
|-----|--------|
| `Enter` | 跳到下一个匹配项 |
| `Shift+Enter` | 跳到上一个匹配项 |
| `Left` / `Right` / `Home` / `End` | 移动查询光标 |
| `Backspace` / `Delete` | 编辑查询 |
| `Escape` | 关闭搜索框并清除高亮 |
### 鼠标
| 操作 | 行为 |
|--------|----------|
| 鼠标滚轮 | 滚动内容 |
| 单击某行 | 选中该行(Ctrl+Enter 求值,Ctrl+C 复制) |
| 双击某个词 | 选中该词 — `Ctrl+Shift+/` 搜索它,`Ctrl+C` 复制它 |
| 单击索引标题 | 打开当前标签页的索引对话框 |
| Ctrl+单击链接 | 跟随文档链接,或在编辑器中打开源文件链接 |
## 功能
- 手册、参考和应用标签页,每个都有增量搜索索引对话框(`i`)
- “应用”标签页扫描各包中的 `help/` 目录并渲染每个应用的文档
- 上下文帮助自动跟随编辑器光标
- 固定以锁定当前帮助内容(Ctrl+P)
- 带匹配导航的文档内搜索(`/`)
- 对手册、参考和应用语料库的全文搜索/近似搜索
- 直接从面板菜单编辑帮助文件
## 饼图菜单
聚焦帮助面板时,按住饼图触发键(默认 Super;用
`[config/set "ui/pie-trigger" :f1]` 更改),悬停到中心以展开,然后在某个扇区上松开:
| 方向 | 扇区 | 按键 | 操作 |
|-----|-------|-----|--------|
| 北 | 固定 / 取消固定 | `p` | 切换固定(标签随固定状态变化) |
| 东北 | 下一页 | `f` | 历史前进 |
| 东 | 参考 | `r` | 参考标签页 |
| 东南 | 应用 | `a` | 应用标签页 |
| 南 | 上下文 | `c` | 上下文标签页 |
| 西 | 手册 | `m` | 手册标签页 |
| 西北 | 上一页 | `b` | 历史后退 |