Oink 发布注记 on OINK

OINK 1.0.0：稳定契约、Starter 与正式发布

OINK — Sat, 29 Aug 2026 23:30:00 +0800

OINK 1.0.0 是稳定性里程碑，不是临发布前重置 API。它把整个 0.x 周期形成的组件、配置、内容、输出与维护者契约提升为第一个主版本。本说明汇总 v0.8.0..v1.0.0 范围内的全部主题修改；0.8.0 已经交付的 Agent 输出与反向链接是比较基线，不会再冒充 1.0 新功能重复计算。

OINK 0.8.2：面向 Hugo Themes 构建器的 Go 1.26 模块兼容性

OINK — Sat, 29 Aug 2026 21:00:00 +0800

OINK 0.8.2 是一次模块元数据兼容性发布。它不修改模板、资产、组件 API、配置键、内容语法或任何渲染输出。已经使用 0.8.1 的站点不需要迁移内容。

v0.8.2 · 2026-08-29

概览

主题模块现在声明 Go 1.26，而不是 Go 1.27。
Hugo 官方主题构建器可以在固定的 Go 1.26 与 GOTOOLCHAIN=local 环境中导入 OINK。
Hugo Extended 0.160.1 仍是公开兼容下限；OINK Starter 继续使用 Hugo Extended 0.165.0 构建。
OINK 不包含 Go 源码，也没有使用 Go 1.27 的语言或模块特性，因此降低 directive 只改变模块准入条件。

为什么需要这个补丁

OINK 0.8.1 使用 Go 1.27 构建和测试，因此 go.mod 声明了 go 1.27.0。但这个仓库是由模板和资产组成的 Hugo Module，并不是 Go 软件包。Hugo 官方主题流水线使用 Go 1.26，而且禁用自动工具链切换，因此会在读取主题元数据之前正确拒绝更高的 directive。

OINK 0.8.1：稳定的 Print 锚点、不被标题挤压的 Book 编号与完整发布材料

OINK — Sat, 29 Aug 2026 00:00:00 +0800

OINK 0.8.1 收口了两个小而具体的渲染问题，并让项目的公开展示与 0.8.0 已经交付的框架能力保持一致。它没有修改组件 API、配置键、内容语法或兼容性下限。现有 0.8.0 站点只需升级模块固定版本，不需要迁移内容。

Oink 0.8.0：整个栏目一次取走，侧栏直接当数据读，以及谁链到了这一页

OINK — Thu, 27 Aug 2026 00:00:00 +0800

Oink 0.8.0 不改动任何组件 API，也不需要修改内容。三项新增里有两项服务于以程序身份来读的访客。每一页本来就会多产出一份 .md，它服务的是已经知道自己要哪一页的 agent；而想读完整份手册的 agent，仍然只能一页一页地爬，边爬边发现链接。这两种新输出格式回答的是另一半问题：把整个栏目给我，以及在我开始抓之前，先告诉我这个站点里有什么。第三项是给作为人的读者的：页面右栏现在可以列出有哪些页面链接到它。

Oink 0.7.1：页面不再外泄，坏输入不再中断构建

OINK — Wed, 26 Aug 2026 00:00:00 +0800

Oink 0.7.1 不改动任何组件 API，也不需要修改内容。它修复了对 0.7.0 主线外部审查发现的代码问题：一个真实的隐私外泄、一类会直接中断构建的配置值，以及三个从未被告知 “非 HTML 输出"存在的组件。

Oink 0.7.0：主题色、统一的字体口径，以及终于能读的图

OINK — Tue, 25 Aug 2026 00:00:00 +0800

Oink 0.7.0 没有改动任何组件 API。它只做两件读者真正长时间面对的事——页面周围的外壳与页面上的字——并补完了一个从来没有被设计过、只是继承下来的围栏。

Oink 0.6.0：沉浸式博客、更稳健的构建、更精简的内部实现

OINK — Thu, 20 Aug 2026 00:00:00 +0800

Oink 0.6.0 保留 0.5 确立的组件 API，集中改进它周围的系统：长文阅读、博客发现、来源标注、版本发布、构建韧性，以及主题自身的可维护性。

本版本没有新增 article 类型，也没有第二套页面外壳。沉浸式阅读只是现有博客外壳的一种配置，因此文章仍处于原有列表、订阅源、分类、系列与翻页序列中。

Oink 0.5.0 — 组件 API v5 与收敛后的配置

OINK — Tue, 18 Aug 2026 00:00:00 +0800

Oink 0.5.0 是 API 冻结版本。它包含 1.0 线将要冻结的全部变更：组件 API v5 （原生 Markdown 形态优先，29 个 shortcode 作为完整形态）、按三条规则收敛的配置键与 front matter 键、主题产出物统一的命名空间、0.x 兼容层与无人使用的 Docsy 遗留物的删除，以及能把 0.4 站点改写到位的迁移工具。任何被退役的键、形态或 shortcode 都会让构建失败，并在错误信息里给出替代写法。

Oink 0.4.0 — 面向完整发布流程的场景组件体系

OINK — Fri, 14 Aug 2026 00:00:00 +0000

Oink 0.4.0 完整交付场景组件体系。原始设计将 Reading & Release、Landing 与 Book 分别放在 0.4、0.5、0.6 三个里程碑中；公开版本将三条轨道合并到一个已签名的 v0.4.0 标签，让消费站接入一套连贯契约，而不是一串彼此依赖的预览版本。

Oink 0.3.0 — 写作、导航与更轻的页面

OINK — Wed, 12 Aug 2026 00:00:00 +0000

v0.3.0 · 2026-08-12

发布门禁：上面的标签必须能够公开解析，项目站必须固定到该精确标签，并且线上检查必须通过。在此之前，请把当前源码页面视为发布候选材料。

Oink 0.2.0：更丰富的内容与更精致的呈现

OINK — Mon, 10 Aug 2026 00:00:00 +0000

v0.2.0 · 2026-08-10

Oink 0.2.0 聚焦读者与作者最常接触的表面：首页、品牌呈现、博客发现、分区索引与操作指南。Oink 项目站点也同步成为更清晰的双语参考，用于说明主题的当前契约。

Oink 0.1.0：稳定的本地优先基础

OINK — Sat, 08 Aug 2026 00:00:00 +0000

v0.1.0 · 2026-08-08

Oink 0.1.0 是 Oink 主题的首个稳定版本。它包含 0.0.1 实现预览以及之后的稳定化工作：统一的文档页面外壳、消费端仅依赖 Hugo 的构建、本地优先的浏览器资源、基于 Hugo 原生对象的多语言行为，以及可复用的内容组件。