OINK 发布注记
每篇发布说明记录对应版本发布时的要求与验收结果。当前开发、CI 与发布测试统一使用 Hugo Extended 0.168.0,详见工具链契约。
当前版本为 OINK 1.5.1:修复双列视图,纠正 RSS 与 Print 聚合输出,
稳定导航标识,强化安全回退与搜索排序,并统一 32 套语言目录的术语。它保留 1.4.0 的本地搜索、
本地图表阅读、表格阅读、博客画廊、组件精修以及 1.5.0 的译文阅读器。统一使用 Hugo Extended 0.168.0,
保留可见告警,禁止启用 --panicOnWarning 或 HUGO_PANICONWARNING,无需额外安装 Sass 编译器。
1.3.1 引入的改动及其作者见阅读修复与贡献者致谢。
OINK 1.5.1 — 双列视图修复与发布输出正确性
稳定双列视图,修正 RSS 与 Print 输出,并强化 1.5.0 审查后的导航、校验、搜索与无障碍行为。
OINK 1.5.0 — 译文并排阅读
按需开启双语视图,把页面与译文并排阅读,并按共同标题同步滚动。
OINK 1.4.0 — 表格、图表与搜索更好用了
按需展开大表格,本地绘制与查看图表,改进中英文搜索,新增博客画廊并统一组件细节。
OINK 1.3.2 — 恢复仅依赖 Hugo 的构建
移除强制 Dart Sass 依赖,所有维护中的站点统一使用 Hugo Extended 0.168.0,保留可见告警。
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 1.5.1 — 双列视图修复与发布输出正确性
稳定双列视图,修正 RSS 与 Print 输出,并强化 1.5.0 审查后的导航、校验、搜索与无障碍行为。
OINK 1.5.0 — 译文并排阅读
按需开启双语视图,把页面与译文并排阅读,并按共同标题同步滚动。
OINK 1.4.0 — 表格、图表与搜索更好用了
按需展开大表格,本地绘制与查看图表,改进中英文搜索,新增博客画廊并统一组件细节。
OINK 1.3.2 — 恢复仅依赖 Hugo 的构建
移除强制 Dart Sass 依赖,所有维护中的站点统一使用 Hugo Extended 0.168.0,保留可见告警。
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 1.5.1 — 双列视图修复与发布输出正确性
OINK 1.5.1 是继 1.5.0 之后的维护版本,发布了双语阅读器上线后积累的审查修正:阅读器统一改名为 Duo View(双列视图),加载和同步状态更清晰,静态输出也重新守住各自的格式边界。同时修正 导航标识、安全回退、搜索排序、无障碍与本地化细节。已有的 params.ui.compare 与 compare_translations 配置保持有效,无需迁移内容。 v1.5.1 发布于 2026-11-06 查看发布 源码 · tar.gz 源码 · zip pgsty/oink …
OINK 1.5.1 是继 1.5.0 之后的维护版本,发布了双语阅读器上线后积累的审查修正:阅读器统一改名为 Duo View(双列视图),加载和同步状态更清晰,静态输出也重新守住各自的格式边界。同时修正 导航标识、安全回退、搜索排序、无障碍与本地化细节。已有的 params.ui.compare 与 compare_translations 配置保持有效,无需迁移内容。 v1.5.1 发布于 2026-11-06 查看发布 源码 · tar.gz 源码 · zip pgsty/oink …
-
OINK 1.5.0 — 译文并排阅读
OINK 1.5.0 为多语言站点新增按需开启的双语视图。读者、作者和译者可以把当前页面与已有 译文并排打开,让两侧保持在同一章节附近。该功能默认关闭,不开启的站点生成的页面与输出 保持不变。本文档站已升级至 OINK 1.5.0,并在 Docs 与博客页面默认开启双语视图——直接按 B 或点击本页右上角的「打开双语视图」按钮即可现场体验。 v1.5.0 发布于 2026-11-04 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 双语视图 只需一个站点参数即可开启: …
OINK 1.5.0 为多语言站点新增按需开启的双语视图。读者、作者和译者可以把当前页面与已有 译文并排打开,让两侧保持在同一章节附近。该功能默认关闭,不开启的站点生成的页面与输出 保持不变。本文档站已升级至 OINK 1.5.0,并在 Docs 与博客页面默认开启双语视图——直接按 B 或点击本页右上角的「打开双语视图」按钮即可现场体验。 v1.5.0 发布于 2026-11-04 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 双语视图 只需一个站点参数即可开启: …
-
OINK 1.4.0 — 表格、图表与搜索更好用了
OINK 1.4.0 主要改善技术文档的阅读体验:大表格可以按需展开,Mermaid 与 PlantUML 共用图表查看器,本地搜索更好地处理中文和中英混合查询。这次还加入博客画廊, 统一了常用组件的间距、边框与操作反馈。 v1.4.0 发布于 2026-10-26 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 表格:需要时再展开 多数表格放在正文里就够用。少数需要更大阅读空间的表格,在下方加上 .expand 即可。 鼠标移入或键盘聚焦时,右上角出现一个小按钮;触屏 …
OINK 1.4.0 主要改善技术文档的阅读体验:大表格可以按需展开,Mermaid 与 PlantUML 共用图表查看器,本地搜索更好地处理中文和中英混合查询。这次还加入博客画廊, 统一了常用组件的间距、边框与操作反馈。 v1.4.0 发布于 2026-10-26 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 表格:需要时再展开 多数表格放在正文里就够用。少数需要更大阅读空间的表格,在下方加上 .expand 即可。 鼠标移入或键盘聚焦时,右上角出现一个小按钮;触屏 …
-
OINK 1.3.2 — 恢复仅依赖 Hugo 的构建
OINK 1.3.2 撤回了 1.3.1 引入的强制 Dart Sass 安装要求。普通站点构建与预览使用 Hugo Extended 及其内置 LibSass。主样式、ReDoc 样式、深色语法高亮和项目 SCSS 钩子继续可用。1.3.1 中独立的可读性修复与 FileTree 修复全部保留。 v1.3.2 发布于 2026-10-18 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 保留的阅读体验修复 本版本保留 1.3.1 引入的社区修复: Markmap:节点 …
OINK 1.3.2 撤回了 1.3.1 引入的强制 Dart Sass 安装要求。普通站点构建与预览使用 Hugo Extended 及其内置 LibSass。主样式、ReDoc 样式、深色语法高亮和项目 SCSS 钩子继续可用。1.3.1 中独立的可读性修复与 FileTree 修复全部保留。 v1.3.2 发布于 2026-10-18 查看发布 源码 · tar.gz 源码 · zip pgsty/oink 保留的阅读体验修复 本版本保留 1.3.1 引入的社区修复: Markmap:节点 …
-
OINK 1.3.1 — 阅读体验修复
当前版本:OINK 1.3.2 1.3.2 发布说明已取代本版本的编译器配置: 使用 Hugo Extended 0.168.0、内置 LibSass 并保留可见告警。 无需为 OINK 安装 Dart Sass,也不要启用告警致命构建。下文保留 1.3.1 发布时的要求。 OINK 1.3.1 修复四类阅读问题,默认保留紧凑布局,同时将构建基线升级至 Hugo Extended 0.168.0 和 独立 Dart Sass 1.105.2,使用 Go 1.27.2 验证。CI 自动跟随 Go …
当前版本:OINK 1.3.2 1.3.2 发布说明已取代本版本的编译器配置: 使用 Hugo Extended 0.168.0、内置 LibSass 并保留可见告警。 无需为 OINK 安装 Dart Sass,也不要启用告警致命构建。下文保留 1.3.1 发布时的要求。 OINK 1.3.1 修复四类阅读问题,默认保留紧凑布局,同时将构建基线升级至 Hugo Extended 0.168.0 和 独立 Dart Sass 1.105.2,使用 Go 1.27.2 验证。CI 自动跟随 Go …
-
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 查看发布 源码 · …