发布不止于参考页面的内容
用 Docs、Blog、Case、Book 与发布页面分别回答读者的不同需求。
5 发布不止于参考页面的内容
用 Docs、Blog、Case、Book 与发布页面分别回答读者的不同需求。
同一个站点可以发布多种知识，而不必把它们强行塞进同一种布局。内容类型选择页面外壳， front matter 变体则在同一外壳内调整呈现。
让发布界面匹配读者
- Docs 回答任务或参考问题，并显示它在内容树中的位置。
- Blog 是带日期、作者、分类法、订阅源与分享能力的文章。
- Case 说明真实站点如何应用主题。
- Book 章节组成有意设计的阅读顺序，并提供稳定交叉引用。
- 发布注记把版本、迁移方法与验证证据连接起来。
配置 Blog 家族
普通 Blog 分区可以选择行列表、卡片或表格。需要沉浸式开场的分区仍然保留同一类型， 只改变四个相互独立的呈现键：
这就是沉浸式阅读所演示的契约。没有第二种 Article 类型， 也没有被复制的发布流水线。
把样例变成 Case 案例
Case 索引使用 Blog 卡片形式，每个内部页面则先说明站点、源码、语言模式、规模与 OINK 能力， 再链接到线上成果。保留内部说明页，能让 showcase 成为文档的一部分，而不只是一面外链标识墙。
让 Book 与 Docs 相互补充
参考页面保持完备，并能独立搜索。教程则从参考中选出一条路径，每次只引入一项决策， 在读者需要完整参数表时再链接回参考文档。
完整演练将使用同一组源事实，新增一篇文章、一个 Case 案例与一篇短 Book 章节， 再比较三者的阅读体验。