跳转到主要内容

使用 Oink 创作优美的内容

一本实战教程:用 OINK 创作清晰、优美且易于维护的技术内容。

《使用 Oink 创作优美的内容》是 OINK 参考文档的教程伴侣。参考文档解释每个参数和组件的作用; 本书则沿着一个真实站点的轨迹,从第一次本地预览走到评审与发布。

前三章已放入可直接操作的内容。后续章节在完整演练写作期间,会刻意展示 Book 的草稿状态。

目录

图目录

  1. 图 1-1 — 第一个里程碑是读者能打开的站点,而不是一份仅仅看起来正确的配置文件。

表目录

  1. 表 2-1 — 同一个显式顺序被导航、翻页与生成目录共同使用。
  2. 表 6-1 — 每种交付状态都有自己的证据与交接要求。
  3. 表 A-1 — 同一棵内容树可以生成多种面向不同用途的 Book 输出。

公式目录

  1. 公式 3.1 — 清晰度、准确性或一致性中任何一项降为零,整个页面就会失败。

示例目录

  1. 示例 3-1 — 一份只包含稳定标题、摘要和树中位置的页面契约。

阅读方式

第一次建站时,请按顺序阅读第 1–3 章;开始打磨对外呈现与发布流程后, 再回到第 4–6 章。附录则汇总全书使用的 front matter 模式,便于直接复用。

安装唯一必需的工具,启动本地预览,在调整设计前先建立可见的基线。

让目录、分区索引、页面包与权重共同构成可预期的阅读与导航顺序。

把散文、提示块、代码、媒体、表格与数学公式组合在一起,而不把页面变成组件目录。

把稳固的内容结构变成一份可辨识、响应式且双语对齐的出版物。

用 Docs、Blog、Case、Book 与发布页面分别回答读者的不同需求。

区分本地预览、仓库集成、主题发布与站点部署,并用对应证据验证每一种状态。

可复制调整的 Book 根页、章节、沉浸式 Blog 文章与整书输出契约。