索引经验

从项目日志中萃取的「怎么建立链接和发现」经验。


术语用 wikilink,不用独立索引文件

经验: Obsidian 的 [[wikilink]] 就是索引。Quartz 自动把它渲染为可点击链接,并在图谱中生成关联边。不需要手动维护索引页。

  • 首次出现术语:[[入流亡所策展/术语库/入流亡所|入流亡所]]
  • 后续出现:直接写文字,不再重复链接(避免图谱过密)

日志条目: 2026-05-24 · 架构 + 壳 · 主公 MD 规范 + Quartz CrawlLinks


图谱依赖 wikilink,不依赖标签

经验: Quartz 图谱的边来自 wikilink,不是标签。要让两个术语关联,必须在正文或 frontmatter 里写 [[目标]],光靠标签不够。

日志条目: 2026-05-24 · 架构 + 壳 · 技术验证(图谱节点 click)


索引页自动生成

经验: Quartz 的 FolderPage + TagPage + ContentIndex 自动生成目录页、标签页、站点地图。不需要手写任何索引 MD。

日志条目: 2026-05-14 ~ 2026-05-23 · 基础设施 · quartz.config.ts emitters 配置

框架页作为设计快照

经验: 每次重大样式变更后,重新生成框架页 HTML 作为当前设计状态的视觉索引。它独立于 Quartz 构建,可无需本地环境直接预览。

用途:

  • 非技术协作者审查样式
  • 回溯历史设计版本
  • 新角色快速了解当前视觉状态

日志条目: 2026-05-24 · 布局重构(框架页协作流)


站点 MOC:Explorer 自动索引

经验: Quartz Explorer 组件按文件夹层级自动生成导航树,无需手动维护目录页。Explorer 的行为(link/folder 导航模式、默认折叠状态)在 quartz.layout.ts 中配置。

日志条目: 2026-05-24 · 布局重构(Explorer 保留在左栏)