创作内容 on OINK

编写页面

Mon, 01 Jan 0001 00:00:00 +0000

本页覆盖一页文档的完整写法：文件位置、front matter、标题锚点、链接、图片、草稿与页尾。前提是站点已能本地构建，尚未搭起时先看十分钟上手。

新建一页

页面是 content/ 下的 Markdown 文件，URL 由它在 content/ 里的位置决定：content/docs/install.md 发布为 /docs/install/。中文译文是同目录下的 .zh.md 同名文件，与英文页共享同一条逻辑路径。

组织内容

Mon, 01 Jan 0001 00:00:00 +0000

OINK 不需要单独配置导航：content/ 下的目录结构就是侧栏树。本页覆盖目录与文件的摆放、栏目首页、排序、图标、折叠、隐藏，以及多根侧栏。

一个目录是一个栏目（Hugo 称 section），目录里的 Markdown 文件是它的页面，嵌套目录是它的子栏目。侧栏按这棵树逐层渲染，顺序由 weight 决定，标签取 linkTitle，缺省时取 title。左侧这棵树的源码如下：

页面参数

Mon, 01 Jan 0001 00:00:00 +0000

本页是页面级参数的全表，只列 OINK 主题会读取的键。Hugo 自身的 front matter 字段（slug、url、build、sitemap、expiryDate 等）照常可用，语义见 Hugo 文档。站点级参数（hugo.yml 里的 params.*）见配置总览。

博客与文章

Mon, 01 Jan 0001 00:00:00 +0000

博客文章与文档页的正文写法相同，区别在外壳：文章带日期、作者、标签与封面图，列表按年份倒序排列，栏目带 RSS。本页覆盖博客栏目的建立、文章 front matter、封面图、列表分页与 Feed。

书籍出版

Mon, 01 Jan 0001 00:00:00 +0000

一本书是一棵 type: book 的内容树：目录决定章节顺序，front matter 决定章节编号，图 / 表 / 式 / 例各带一个手写编号与稳定锚点。交叉引用在四种输出里都能解析，书根页面可以生成整本打印 HTML。

发布与下载页

Mon, 01 Jan 0001 00:00:00 +0000

OINK 把发布事实集中在两处本地数据：页面 front matter 的 release_url 指明这一页对应哪个 GitHub 发布，data/download/<key>.yaml 记录安装方式。发布卡片、资产表、下载区块与索引页都从这两处推导。构建期不访问 GitHub，也不声称某个标签或资产已经存在。

API 文档

Mon, 01 Jan 0001 00:00:00 +0000

一页接口文档由一份 OpenAPI 规范加一个 shortcode 构成。Swagger UI 与 Redoc 两个运行时随主题分发（版本分别是 5.32.13 与 2.5.3，见仓库 VENDOR.json），页面用到才加载，构建与浏览都不访问外部服务。

创作内容 on OINK

编写页面

新建一页

组织内容

目录就是侧栏

页面参数

博客与文章

书籍出版

发布与下载页

API 文档