跳到主要内容

第一版可审阅 content recipe

内容站

通过保留目录形状的内容对象,并声明明确的 list/detail 呈现合同来添加 content collection。

这是可审阅的 content-site sequence,不声称当前 CLI 已有一条一键 content-site scaffold。第一版 board 如实记录这个缺口,而不是发明一条路径。

建立一个完整 vertical slice

  1. 从已验证的信息站点基础开始。
  2. content/articles/<slug>/content.md 下加入两个对象,每个都有真实 front matter 和读者正文。
  3. 加入一个 page/collection layout,声明未过滤的 /content/articles/ source。
  4. 把完整 source 值绑定给带明确 empty state 的 component。
  5. 在每个声明的 locale 中确认一条 list result 和一条 detail route。

只有该 slice 可用后,才加 sort、limit、tag、related object 或 archive。每一项都会改变 selection 或 route 行为,应各自有 build/browser 观察。

核心边界

内容对象仍是 source of truth。list page 选择对象,不拥有 article copy;detail route 呈现一个对象,不把它的 metadata 复制到 site configuration。这样一个对象能出现在 list、related-reading band、topic page 或未来 surface 中,而不用移动原文件。

对象形状见 内容对象、metadata 与 locale;query contract 见 把内容绑定到页面。在 clean-agent vertical slice 确实对目标 runtime 跑过前,本 board 不发布假的“下载一份完整博客” fixture。