OINK 文档
为文档、博客、书籍与 API 参考建立统一的技术内容站点，共用导航、多语言与搜索。
第一次使用 OINK，请从 Starter 预览一个可运行的站点，再替换成 自己的内容。正文用 Markdown 编写，Hugo Extended 负责构建；采用 Hugo Modules 时还需要 Go 解析主题模块。主题内置资源无需 CDN，也不需要 npm 构建流程。
当前发布版本为 v1.2.0。已有站点可查看 1.2 发布说明与升级指南。
五条入口
- 快速上手 — 创建 OINK Starter 仓库，建立本地基线，分层定制并部署。
- 组件总览 — 每个组件一页，先给源码再给渲染效果。
- 使用 OINK 创作优美的内容 — 正在完善的实战教程；前三章覆盖预览、内容结构与页面创作。
- 案例 — 把生产站点拆解成可复用的设计与迁移模式。
- 设计与开发 — 面向 OINK 维护者的契约、已接受决策、研究证据与候选提案。
按任务导航
| 你要做的事 | 去哪 |
|---|---|
| 判断是否适用 | OINK 是什么 |
| 安装并预览 | 快速上手 |
| 写一页文档 | 编写页面 |
| 把目录树变成侧栏 | 组织内容 |
| 查组件写法 | 组件总览 |
| 改站名、Logo、配色与字体 | 品牌外观 |
| 查某个配置键的默认值 | 配置总览 |
| 做双语或多语言站 | 多语言 |
| 跟随练习建站与写作 | 使用 OINK 创作优美的内容 |
| 研究生产环境实现 | 案例 |
| 部署到线上 | 发布上线 |
| 升级版本或从 Docsy 迁移 | 版本升级 |
| 维护主题、审查契约或编写 PRD | 设计与开发 |
Docs 的七个栏目按阅读顺序排列：了解、上手、写内容、查组件、改站点、管发布，最后理解并维护其背后的契约与设计记录。
一套从 Docsy 演化而来的本地优先 Hugo 文档框架：组件在 Markdown 中仍然可读，资源随主题分发，十五个生产站点持续验证它。
从官方 OINK Starter 建立可运行的本地基线，再依次定制内容、语言、品牌、集成与部署。
写文档页、博客、书籍、发布页与 API 文档：一页文档长什么样，内容怎么组织。
写文档时可用的全部组件，一个组件一页，例子由浅入深，参数表在页尾。
站点级配置：品牌、导航、布局、搜索、多语言、多版本、打印与 Agent 输出。
站点从本机到线上的运维事项：本地预览、发布上线、评论、分析与 SEO、版本升级与排错。
在唯一的双语专栏中管理 OINK 维护者契约、已接受决策、带日期的研究记录与候选提案。
面向 Hugo 站点的可选 OINK 命令行工具草案介绍。