索引经验
从项目日志中萃取的「怎么建立链接和发现」经验。
术语用 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 保留在左栏)