使用 OINK 创作优美的内容
一本实战教程:用 OINK 创作清晰、优美且易于维护的技术内容。
《使用 OINK 创作优美的内容》是与 OINK 参考文档配套的动手实战教程。参考文档说明每个参数和组件的用法; 本书则围绕同一个 Starter 站点,从首次本地预览一步步带你完成双语内容创作、外观定制与生产发布。
阅读方式
从第 1 章:跑起第一个站点开始。全书六章沿用同一个 Starter 仓库,依次完成本地预览、新建双语页面、组合正文与组件、定制品牌与首页、选择内容发布形态, 以及上线前的生产构建校验。下方对象索引同时展示了 Book 的出版能力,可用于快速定位书中的插图、 表格、公式与代码示例。
目录
图目录
表目录
- 表 2-1 — 同一个显式顺序被导航、翻页与生成目录共同使用。
- 表 6-1 — 从本地预览到线上部署的四个验证阶段,以及各阶段留给下一步确认的事项。
- 表 A-1 — 同一棵内容树可以生成多种面向不同用途的 Book 输出。
公式目录
示例目录
安装前置工具,启动本地预览,在调整设计前先建立可见的基线。
让目录、分区索引、页面包与权重共同构成可预期的阅读与导航顺序。
把正文、提示块、代码、媒体、表格与数学公式组合在一起,而不把页面变成组件目录。
把稳固的内容结构变成一份可辨识、响应式且双语对齐的出版物。
用 Docs、Blog、Case、Book 与发布页面分别回答读者的不同需求。
用一套可重复的发布清单,依次检查本地预览、生产构建、主题升级与线上部署。
可复制调整的 Book 根页、章节、沉浸式 Blog 文章与整书输出契约。