功能一览
这一页说的是本站点作为「手册载体」比长图、比 PDF 多出来的东西,以及手册本身覆盖的范围。
站点能力
| 能力 | 长图 / PDF | 本站 |
|---|---|---|
| 全文搜索 | ✗ 只能靠眼睛翻 | ✓ 本地索引,毫秒级 |
| 章节锚点 | ✗ | ✓ 每节独立链接,可单独发人 |
| 目录导航 | ✗ | ✓ 左侧常驻 + 右侧本页目录 |
| 深色模式 | ✗ | ✓ 记住你的选择 |
| 手机适配 | 需要反复缩放 | ✓ 响应式,正文不横向滚动 |
| 复制命令 | ✗ 手打 | ✓ 代码块一键复制 |
| 修订 | 重做全套图 | ✓ 改一行 Markdown |
手册覆盖范围
| 章节 | 小节数 | 说明 |
|---|---|---|
| 一、安装与基础配置 | 2 | 装软件、装插件、六项初始设置 |
| 二、界面与布局 | 1 | 双栏结构、区域分工、宽度取舍 |
| 三、核心功能详解 | 8 | 搜索 · 标签 · 快捷方式 · 日历 · 预览 · 图谱 · 属性 · 文件夹 |
| 四、键盘快捷键 | 3 | 导航 · 多选 · 自定义 |
| 五、真实使用场景 | 5 | 五个可直接套用的工作流 |
| 六、Vault 配置清单 | 1 | 设置项逐条过 |
| 七、同步与本地存储 | 1 | 六种方案对比与冲突处理 |
| 八、快速命令参考 | 1 | 命令与搜索语法速查 |
| 维护与查漏 | 3 | 备份 · 自查 · 常见问题 |
还没做、但可以加的
- 交互式清单:勾选式自查表,勾完给出结论,而不是让你自己对
- 配置生成器:按你的使用习惯,输出一份可粘贴的设置建议
- 场景视频:每个场景配一段 30 秒录屏
- 更新日志:每章修订记录,方便对比新旧版本
这些都是纯前端能力,不需要后端,随时能加。
技术底座
- VitePress —— Markdown 写内容,构建成静态 HTML
- Cloudflare Pages —— 全球 CDN,免费额度够用
- 本地搜索索引 —— 构建时生成,不依赖任何外部服务,断网也能搜