OINK

OINK 1.0.0 是稳定性里程碑，不是临发布前重置 API。它把整个 0.x 周期形成的组件、 配置、内容、输出与维护者契约提升为第一个主版本。本说明汇总 v0.8.0..v1.0.0 范围内的全部主题修改；0.8.0 已经交付的 Agent 输出与反向链接是比较基线，不会再 冒充 1.0 新功能重复计算。 已经使用 0.8.0、0.8.1 或 0.8.2 的站点不需要迁移内容或配置。把模块固定到新版本， 执行 warning 即失败的严格构建，再像任何主题升级一样检查真实渲染即可。 …

OINK 0.8.2 是一次模块元数据兼容性发布。它不修改模板、资产、组件 API、配置键、 内容语法或任何渲染输出。已经使用 0.8.1 的站点不需要迁移内容。 v0.8.2 发布于 2026-08-29 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 主题模块现在声明 Go 1.26，而不是 Go 1.27。 Hugo 官方主题构建器可以在固定的 Go 1.26 与 GOTOOLCHAIN=local 环境中导入 OINK。 Hugo Extended …

OINK 0.8.1 收口了两个小而具体的渲染问题，并让项目的公开展示与 0.8.0 已经交付的框架能力保持一致。它没有修改组件 API、配置键、内容语法或兼容性下限。 现有 0.8.0 站点只需升级模块固定版本，不需要迁移内容。 v0.8.1 发布于 2026-08-29 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 一个页面单独渲染为 Print 时，现在与普通页面保持完全相同的标题和脚注 ID。 分区与整书 Print 仍会给这些页面局部 ID 增加命名空 …

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

Oink 0.7.1 不改动任何组件 API，也不需要修改内容。它修复了对 0.7.0 主线外部审查发现的 代码问题：一个真实的隐私外泄、一类会直接中断构建的配置值，以及三个从未被告知 “非 HTML 输出"存在的组件。 v0.7.1 发布于 2026-08-26 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 Swagger UI 不再联系在线 validator。已发布的 API 页面每次被浏览都会发出一个第三方请求，现在不会了。 写在站点配置里的 URL，现 …

Oink 0.7.0 没有改动任何组件 API。它只做两件读者真正长时间面对的事——页面周围的外壳 与页面上的字——并补完了一个从来没有被设计过、只是继承下来的围栏。 v0.7.0 发布于 2026-08-25 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 params.ui.theme_color 让板块拥有自己的强调色，作用于外壳的底色，而非正文。 params.ui.fonts 覆盖全部七个字体角色；Book 不再自带字体。 mermaid 围栏是一张图： …

Oink 0.6.0 保留 0.5 确立的组件 API，集中改进它周围的系统：长文阅读、博客发现、 来源标注、版本发布、构建韧性，以及主题自身的可维护性。 本版本没有新增 article 类型，也没有第二套页面外壳。沉浸式阅读只是现有博客外壳的 一种配置，因此文章仍处于原有列表、订阅源、分类、系列与翻页序列中。 v0.6.0 发布于 2026-08-20 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 博客外壳新增全幅 hero 题图和随正文起步的流式大纲轨道。 …

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

Oink 0.4.0 完整交付场景组件体系。原始设计将 Reading & Release、Landing 与 Book 分别放在 0.4、0.5、0.6 三个里程碑中；公开版本将三条轨道合并到一个已签名的 v0.4.0 标签，让消费站接入一套连贯契约，而不是一串彼此依赖的预览版本。 本版本继续保持本地优先：消费站仍然只需 Hugo Extended 与 Go，不需要 Node.js、浏览器端 API 或 CDN。所有交互都采用渐进增强；HTML、打印、Markdown 与 RSS 输出会保留理 …

v0.3.0 发布于 2026-08-12 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 发布门禁：上面的标签必须能够公开解析，项目站必须固定到该精确标签，并且线上检查必须通过。在此之前，请把当前源码页面视为发布候选材料。 Oink 0.3.0 是围绕写作与导航的一个版本。写页面时，代码块有了现代化的呈现，并补齐了一组每天都会用到的小组件；读页面时，多了嵌套导航与命令面板；而所有页面都实实在在变轻了——jQuery 已被移除。 模块路径、最低 Hugo 版本以及 …

v0.2.0 发布于 2026-08-10 查看发布 源码 · tar.gz 源码 · zip pgsty/oink Oink 0.2.0 聚焦读者与作者最常接触的表面：首页、品牌呈现、博客发现、分区索引与操作指南。Oink 项目站点也同步成为更清晰的双语参考，用于说明主题的当前契约。 模块路径、最低 Hugo 版本以及消费端仅依赖 Hugo 的构建方式均保持不变。唯一可能影响现有站点的配置改名，详见破坏性变更。 发布亮点 首页与品牌 首页现在可以通过有序 sections 列表组合 12 种 …

今天，我们发布 OINK 实现预览：它从 Docsy 直接演化而来，提供唯一标准产品外壳、仅依赖 Hugo 的消费端构建、本地优先浏览器依赖、通用多语言框架，以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这是实现与文档里程碑，不是已经公开的版本化发行。最终公开品牌、模块与软件包身份、首个版本，以及生产 Cloudflare Pages 部署，仍是必须显式关闭的发布关卡。 为什么需要 OINK？ 多个成熟文档站分别复制了相同的 Docsy 布局、导航、搜索代码 …

v0.1.0 发布于 2026-08-08 查看发布 源码 · tar.gz 源码 · zip pgsty/oink Oink 0.1.0 是 Oink 主题的首个稳定版本。它包含 0.0.1 实现预览以及之后的稳定化工作：统一的文档页面外壳、消费端仅依赖 Hugo 的构建、本地优先的浏览器资源、基于 Hugo 原生对象的多语言行为，以及可复用的内容组件。 本版本继续使用模块路径 github.com/pgsty/oink，要求 Hugo Extended 0.160.1 或更高版本。消费站点 …