Oink 发布注记
每篇发布说明记录对应版本当时的要求与验收结果。当前开发、CI 与发布测试统一使用 Hugo Extended 0.168.0，基线随稳定版更新。旧发布说明不构成当前支持要求， 请遵循工具链契约。
OINK 1.3.2 — 恢复仅依赖 Hugo 的构建
移除强制 Dart Sass 依赖，恢复 Hugo Extended 0.166.0 作为最低版本和默认版本，并接受 Hugo 0.168 的 LibSass 警告。
OINK 1.3.1 — 阅读体验修复
修复 Markmap 文字与 TOC 页脚避让，为技术表格和 FileTree 注释提供显式布局选项，并升级至 Hugo 0.168 与 Dart Sass。
OINK 1.3.0 — Expo 图片相册
Expo 为 OINK 带来基于页面资源的图片相册、三种布局和原图查看器，并修复导航、对话框与焦点行为。
OINK 1.2.0：四套风格，本地优先
OINK 1.2.0 带来 Paper、Slate、Ink、Terminal 四套风格，独立的风格与明暗切换、 本地字体、更清晰的搜索、一致的导航，以及更安全的书籍出版和站点维护工具。
OINK 1.1.0：原生多语言界面、导航与站点扩展
OINK 1.1.0 带来 32 份原生界面目录、分类法目录、可靠的侧栏状态、站点自定义 搜索动作，以及打印、键盘焦点和图片复制修复。
OINK 1.0.0：稳定契约、Starter 与正式发布
OINK 1.0.0 将现有知识发布契约定为稳定表面，并汇总 0.8.0 之后的全部主题修改： Print 与 Book 正确性、固定的 Go 1.27 与 Hugo 0.165.0 发布工具链、正式支持的 Starter，以及进入更广泛 Hugo 生态所需的公开元数据与展示素材。
OINK 0.8.2：面向 Hugo Themes 构建器的 Go 1.26 模块兼容性
OINK 0.8.2 把 Hugo Module 的 Go directive 从 1.27 降到 1.26，使包括 Hugo 官方主题流水线在内、使用 GOTOOLCHAIN=local 的构建器无需改变 Hugo 兼容下限或渲染行为就能导入主题。
OINK 0.8.1：稳定的 Print 锚点、不被标题挤压的 Book 编号与完整发布材料
OINK 0.8.1 是一次范围明确的维护版本：单页 Print 与普通 HTML 保持相同的标题与脚注锚点，过长的 Book 标题不再挤压侧栏编号，项目公开入口也改为从 OINK Starter 引导新站点。
Oink 0.8.0：整个栏目一次取走，侧栏直接当数据读，以及谁链到了这一页
Oink 0.8.0 为「以程序身份来读」的访客加了两种可选输出格式：把整个栏目装进一个文件的 全文包，以及以 JSON 发布的导航树；再加上静态反向链接，在右栏列出链接到本页的页面。 三者都默认关闭，不点名就不会出现。
Oink 0.7.1：页面不再外泄，坏输入不再中断构建
Oink 0.7.1 是一次安全与校验修补。Swagger UI 不再把你的 spec 地址发给第三方， 配错的参数会告警并回退而不是中断普通构建，OpenAPI 与终端录像组件也终于像其他组件一样， 在打印、Markdown 和 RSS 中表现正常。
Oink 0.7.0：主题色、统一的字体口径，以及终于能读的图
Oink 0.7.0 让每个板块通过外壳的底色拥有自己的强调色，把七个字体角色交给站点配置， 并把 mermaid 围栏变成一张真正的图：居中、切换深浅色就地重绘、可以按原始尺寸打开。
Oink 0.6.0：沉浸式博客、更稳健的构建、更精简的内部实现
Oink 0.6.0 为现有博客外壳增加沉浸式呈现，用题图、作者、系列、三种索引形态和分享条 补全博客发布能力，并以安全告警取代会中止整个构建的模板错误。
-
OINK 1.3.2 — 恢复仅依赖 Hugo 的构建
OINK 1.3.2 撤回了 1.3.1 引入的强制 Dart Sass 安装要求。普通站点构建与预览使用 Hugo Extended 及其内置 LibSass。主样式、ReDoc 样式、深色语法高亮和项目 SCSS 钩子继续可用。1.3.1 中独立的可读性修复与 FileTree 修复全部保留。 构建要求 Hugo Extended 0.166.0 是最低版本，也是开发与严格 CI 的默认版本。解析 Hugo Modules 时需要 Go；普通站点构建不需要额外的 Sass 程序 …
OINK 1.3.2 撤回了 1.3.1 引入的强制 Dart Sass 安装要求。普通站点构建与预览使用 Hugo Extended 及其内置 LibSass。主样式、ReDoc 样式、深色语法高亮和项目 SCSS 钩子继续可用。1.3.1 中独立的可读性修复与 FileTree 修复全部保留。 构建要求 Hugo Extended 0.166.0 是最低版本，也是开发与严格 CI 的默认版本。解析 Hugo Modules 时需要 Go；普通站点构建不需要额外的 Sass 程序 …
-
OINK 1.3.1 — 阅读体验修复
OINK 1.3.1 修复四类阅读问题，默认保留紧凑布局，同时将构建基线升级至 Hugo Extended 0.168.0 和 独立 Dart Sass 1.105.2，使用 Go 1.27.2 验证。CI 自动跟随 Go 和 Hugo 的最新稳定版，并记录实际版本。模块继续以 Go 1.27.0 为最低要求。 阅读体验修复 Markmap：节点文字跟随正文颜色，在明暗模式、视觉预设和恢复读者偏好时保持 可读；打印时保留白底深色文字。解决 #47。 TOC：固定右侧目录避让页脚，没有左侧栏的页面 …
OINK 1.3.1 修复四类阅读问题，默认保留紧凑布局，同时将构建基线升级至 Hugo Extended 0.168.0 和 独立 Dart Sass 1.105.2，使用 Go 1.27.2 验证。CI 自动跟随 Go 和 Hugo 的最新稳定版，并记录实际版本。模块继续以 Go 1.27.0 为最低要求。 阅读体验修复 Markmap：节点文字跟随正文颜色，在明暗模式、视觉预设和恢复读者偏好时保持 可读；打印时保留白底深色文字。解决 #47。 TOC：固定右侧目录避让页脚，没有左侧栏的页面 …
-
OINK 1.3.0 — Expo 图片相册
OINK 1.3.0 新增 Expo，与 Docs、Blog、Book 并列。一册相册就是一个 Hugo 叶子页面包：index.md 和同目录的图片。资源元数据提供标题、图注、署名、顺序和稳定图片链接，无需为每张图片单独创建网页或 YAML 文件。 OINK 1.3.0 以 Hugo Extended 0.166.0 作为最低版本，以及开发、CI 与发布测试的 统一基线。模块声明 Go 1.27.0。 主要变化 Expo 相册共用 OINK 侧栏、导航和外观控件。 展墙、卡片、无缝三种布局，保 …
OINK 1.3.0 新增 Expo，与 Docs、Blog、Book 并列。一册相册就是一个 Hugo 叶子页面包：index.md 和同目录的图片。资源元数据提供标题、图注、署名、顺序和稳定图片链接，无需为每张图片单独创建网页或 YAML 文件。 OINK 1.3.0 以 Hugo Extended 0.166.0 作为最低版本，以及开发、CI 与发布测试的 统一基线。模块声明 Go 1.27.0。 主要变化 Expo 相册共用 OINK 侧栏、导航和外观控件。 展墙、卡片、无缝三种布局，保 …
-
OINK 1.2.0：四套风格，本地优先
OINK 1.2.0 为同一份技术内容带来四套视觉风格： Paper、 Slate、 Ink 和 Terminal。Paper 成为默认外观，Slate 保留熟悉的 OINK 风格。读者可以 分别选择风格与明暗模式，字体和核心脚本仍从站点本地加载。 这次更新也改善了日常阅读与发布体验：中文搜索摘要更清晰，导航与元数据保持 一致，键盘和复制操作更可靠，PDF 导出与维护工具增加了保护。既有站点无需 批量迁移内容。 主要变化 同一份内容支持四套风格；Paper 成为默认，既有站点可选择 Slate …
OINK 1.2.0 为同一份技术内容带来四套视觉风格： Paper、 Slate、 Ink 和 Terminal。Paper 成为默认外观，Slate 保留熟悉的 OINK 风格。读者可以 分别选择风格与明暗模式，字体和核心脚本仍从站点本地加载。 这次更新也改善了日常阅读与发布体验：中文搜索摘要更清晰，导航与元数据保持 一致，键盘和复制操作更可靠，PDF 导出与维护工具增加了保护。既有站点无需 批量迁移内容。 主要变化 同一份内容支持四套风格；Paper 成为默认，既有站点可选择 Slate …
-
OINK 1.1.0：原生多语言界面、导航与站点扩展
OINK 1.1.0 是稳定 1.0 契约之后的第一个次版本：补齐原生界面翻译，让分类法根页 成为实用的导航目录，并处理社区对侧栏状态、键盘焦点、内容分组与搜索扩展的反馈。 现有 1.0 内容与配置不需要迁移源码。 概览 32 份原生界面目录：从 Docsy 继承的 31 个 locale 名称，加上通用 zh，均包含 相同的 194 条 OINK 消息，并采用各语言的复数规则。 分类法目录：标签、分类、作者与系列提供紧凑术语卡片、本地化页头，以及站点已 声明分类法之间的切换器。 可靠的导航：缓 …
OINK 1.1.0 是稳定 1.0 契约之后的第一个次版本：补齐原生界面翻译，让分类法根页 成为实用的导航目录，并处理社区对侧栏状态、键盘焦点、内容分组与搜索扩展的反馈。 现有 1.0 内容与配置不需要迁移源码。 概览 32 份原生界面目录：从 Docsy 继承的 31 个 locale 名称，加上通用 zh，均包含 相同的 194 条 OINK 消息，并采用各语言的复数规则。 分类法目录：标签、分类、作者与系列提供紧凑术语卡片、本地化页头，以及站点已 声明分类法之间的切换器。 可靠的导航：缓 …
-
OINK 1.0.0：稳定契约、Starter 与正式发布
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 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：面向 Hugo Themes 构建器的 Go 1.26 模块兼容性
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.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：稳定的 Print 锚点、不被标题挤压的 Book 编号与完整发布材料
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.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：整个栏目一次取走，侧栏直接当数据读，以及谁链到了这一页
Oink 0.8.0 不改动任何组件 API，也不需要修改内容。三项新增里有两项服务于以程序身份来读的访客。 每一页本来就会多产出一份 .md，它服务的是已经知道自己要哪一页的 agent； 而想读完整份手册的 agent，仍然只能一页一页地爬，边爬边发现链接。 这两种新输出格式回答的是另一半问题：把整个栏目给我，以及在我开始抓之前，先告诉我这个站点里有什么。 第三项是给作为人的读者的：页面右栏现在可以列出有哪些页面链接到它。 v0.8.0 发布于 2026-08-27 查看发布 源码 · …
Oink 0.8.0 不改动任何组件 API，也不需要修改内容。三项新增里有两项服务于以程序身份来读的访客。 每一页本来就会多产出一份 .md，它服务的是已经知道自己要哪一页的 agent； 而想读完整份手册的 agent，仍然只能一页一页地爬，边爬边发现链接。 这两种新输出格式回答的是另一半问题：把整个栏目给我，以及在我开始抓之前，先告诉我这个站点里有什么。 第三项是给作为人的读者的：页面右栏现在可以列出有哪些页面链接到它。 v0.8.0 发布于 2026-08-27 查看发布 源码 · …
-
Oink 0.7.1：页面不再外泄，坏输入不再中断构建
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.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：主题色、统一的字体口径，以及终于能读的图
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.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：沉浸式博客、更稳健的构建、更精简的内部实现
Oink 0.6.0 保留 0.5 确立的组件 API，集中改进它周围的系统：长文阅读、博客发现、 来源标注、版本发布、构建韧性，以及主题自身的可维护性。 本版本没有新增 article 类型，也没有第二套页面外壳。沉浸式阅读只是现有博客外壳的 一种配置，因此文章仍处于原有列表、订阅源、分类、系列与翻页序列中。 v0.6.0 发布于 2026-08-20 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 博客外壳新增全幅 hero 题图和随正文起步的流式大纲轨道。 …
Oink 0.6.0 保留 0.5 确立的组件 API，集中改进它周围的系统：长文阅读、博客发现、 来源标注、版本发布、构建韧性，以及主题自身的可维护性。 本版本没有新增 article 类型，也没有第二套页面外壳。沉浸式阅读只是现有博客外壳的 一种配置，因此文章仍处于原有列表、订阅源、分类、系列与翻页序列中。 v0.6.0 发布于 2026-08-20 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 概览 博客外壳新增全幅 hero 题图和随正文起步的流式大纲轨道。 …