博客
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 为现有博客外壳增加沉浸式呈现，用题图、作者、系列、三种索引形态和分享条 补全博客发布能力，并以安全告警取代会中止整个构建的模板错误。
在 Blog 布局中实现沉浸式阅读
四个 front matter 键即可把普通 Blog 页面切换为阅读优先的版式： 以全幅 Hero 开场，再用随文大纲栏承接正文。
Oink 0.5.0 — 组件 API v5 与收敛后的配置
Oink 0.5.0 用原生 Markdown 形态取代大多数 shortcode，把全部配置键与 front matter 键收敛到三条规则上，删除 0.x 兼容层，并附带把 0.4 站点改写到位的迁移工具。 每一个旧键、旧形态、旧 shortcode 都会让构建失败并指出替代写法，而不是被静默忽略。
Oink 0.4.0 — 面向完整发布流程的场景组件体系
Oink 0.4.0 在一个合并发布中交付连续阅读与发布界面、可复用 Landing 页面、 带稳定引用的 Book 出版能力，以及键盘优先的站点外壳。
Oink 0.3.0 — 写作、导航与更轻的页面
Oink 0.3.0 带来增强代码块与代码分组、日常内容组件、嵌套导航与命令面板、 语义化字体预设，并从每个页面移除了 jQuery。
Oink 0.2.0：更丰富的内容与更精致的呈现
Oink 0.2.0 新增可组合首页分区、跟随颜色模式的图片、字标、可导航组件面板与 steps 短代码，并改进终端录像与版本发布内容的呈现体验。
OINK 实现预览正式亮相
OINK 将直接定制的 Docsy 代码库演化为本地优先、仅依赖 Hugo 的文档主题，并提供多语言基础设施与可复用内容组件。
OINK 实施日记：从复制外壳到统一主题
记录 OINK 实现预览背后的技术决策、迁移方法、安全边界、测试与文档工作。
Oink 0.1.0：稳定的本地优先基础
Oink 的首个稳定版本将实现预览完善为可直接使用的 Hugo 模块，提供响应式页面外壳、多语言基础设施、本地优先组件与更扎实的无障碍基线。
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 为现有博客外壳增加沉浸式呈现，用题图、作者、系列、三种索引形态和分享条 补全博客发布能力，并以安全告警取代会中止整个构建的模板错误。
在 Blog 布局中实现沉浸式阅读
四个 front matter 键即可把普通 Blog 页面切换为阅读优先的版式： 以全幅 Hero 开场，再用随文大纲栏承接正文。
Oink 0.5.0 — 组件 API v5 与收敛后的配置
Oink 0.5.0 用原生 Markdown 形态取代大多数 shortcode，把全部配置键与 front matter 键收敛到三条规则上，删除 0.x 兼容层，并附带把 0.4 站点改写到位的迁移工具。 每一个旧键、旧形态、旧 shortcode 都会让构建失败并指出替代写法，而不是被静默忽略。
Oink 0.4.0 — 面向完整发布流程的场景组件体系
Oink 0.4.0 在一个合并发布中交付连续阅读与发布界面、可复用 Landing 页面、 带稳定引用的 Book 出版能力，以及键盘优先的站点外壳。
Oink 0.3.0 — 写作、导航与更轻的页面
Oink 0.3.0 带来增强代码块与代码分组、日常内容组件、嵌套导航与命令面板、 语义化字体预设，并从每个页面移除了 jQuery。
Oink 0.2.0：更丰富的内容与更精致的呈现
Oink 0.2.0 新增可组合首页分区、跟随颜色模式的图片、字标、可导航组件面板与 steps 短代码，并改进终端录像与版本发布内容的呈现体验。
OINK 实现预览正式亮相
OINK 将直接定制的 Docsy 代码库演化为本地优先、仅依赖 Hugo 的文档主题，并提供多语言基础设施与可复用内容组件。
OINK 实施日记：从复制外壳到统一主题
记录 OINK 实现预览背后的技术决策、迁移方法、安全边界、测试与文档工作。
Oink 0.1.0：稳定的本地优先基础
Oink 的首个稳定版本将实现预览完善为可直接使用的 Hugo 模块，提供响应式页面外壳、多语言基础设施、本地优先组件与更扎实的无障碍基线。
-
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 题图和随正文起步的流式大纲轨道。 …
-
在 Blog 布局中实现沉浸式阅读
本页直接由标准 Blog 布局渲染，无需新增专门的内容类型。只需四个 front matter 键 就能切换版式；也可以在栏目 cascade 中统一配置： featured_image: hero # 题图作为全幅开场背景 toc_style: flow # 更宽的大纲栏从正文起点开始 toc_taxonomies: false # 右栏只保留大纲 sidebar_enabled: false Hero 开场 带有题图的页面可以用它作为开场。hero 会把图片铺满视口顶部， 将标题下移留出空间 …
本页直接由标准 Blog 布局渲染，无需新增专门的内容类型。只需四个 front matter 键 就能切换版式；也可以在栏目 cascade 中统一配置： featured_image: hero # 题图作为全幅开场背景 toc_style: flow # 更宽的大纲栏从正文起点开始 toc_taxonomies: false # 右栏只保留大纲 sidebar_enabled: false Hero 开场 带有题图的页面可以用它作为开场。hero 会把图片铺满视口顶部， 将标题下移留出空间 …
-
Oink 0.5.0 — 组件 API v5 与收敛后的配置
Oink 0.5.0 是 API 冻结版本。它包含 1.0 线将要冻结的全部变更：组件 API v5 （原生 Markdown 形态优先，29 个 shortcode 作为完整形态）、按三条规则收敛的配置键与 front matter 键、主题产出物统一的命名空间、0.x 兼容层与无人使用的 Docsy 遗留物的 删除，以及能把 0.4 站点改写到位的迁移工具。任何被退役的键、形态或 shortcode 都会让构建失败，并在错误信息里给出替代写法。 对每一个 0.4 站点来说这都是破坏性升级。请 …
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 — 面向完整发布流程的场景组件体系
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 输出会保留理 …
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 输出会保留理 …
-
Oink 0.3.0 — 写作、导航与更轻的页面
v0.3.0 发布于 2026-08-12 查看发布 源码 · tar.gz 源码 · zip pgsty/oink Oink 0.3.0 是围绕写作与导航的一个版本。写页面时，代码块有了现代化的呈现，并补齐了一组每天都会用到的小组件；读页面时，多了嵌套导航与命令面板；而所有页面都实实在在变轻了——jQuery 已被移除。 模块路径、最低 Hugo 版本以及 Hugo-only 的消费者构建方式均未改变。有三项改动可能影响既有站点，详见破坏性变更。 版本亮点 代码块与代码分组 普通围栏代码块现 …
v0.3.0 发布于 2026-08-12 查看发布 源码 · tar.gz 源码 · zip pgsty/oink Oink 0.3.0 是围绕写作与导航的一个版本。写页面时，代码块有了现代化的呈现，并补齐了一组每天都会用到的小组件；读页面时，多了嵌套导航与命令面板；而所有页面都实实在在变轻了——jQuery 已被移除。 模块路径、最低 Hugo 版本以及 Hugo-only 的消费者构建方式均未改变。有三项改动可能影响既有站点，详见破坏性变更。 版本亮点 代码块与代码分组 普通围栏代码块现 …
-
Oink 0.2.0：更丰富的内容与更精致的呈现
v0.2.0 发布于 2026-08-10 查看发布 源码 · tar.gz 源码 · zip pgsty/oink Oink 0.2.0 聚焦读者与作者最常接触的界面：首页、品牌呈现、博客发现、分区索引与操作指南。Oink 项目站点也同步更新为更清晰的双语参考文档。 模块路径、最低 Hugo 版本以及消费端仅依赖 Hugo 的构建方式均保持不变。唯一可能影响现有站点的配置改名，详见破坏性变更。 发布亮点 首页与品牌 首页现在可以通过有序 sections 列表组合 12 种内置分区。字符串会 …
v0.2.0 发布于 2026-08-10 查看发布 源码 · tar.gz 源码 · zip pgsty/oink Oink 0.2.0 聚焦读者与作者最常接触的界面：首页、品牌呈现、博客发现、分区索引与操作指南。Oink 项目站点也同步更新为更清晰的双语参考文档。 模块路径、最低 Hugo 版本以及消费端仅依赖 Hugo 的构建方式均保持不变。唯一可能影响现有站点的配置改名，详见破坏性变更。 发布亮点 首页与品牌 首页现在可以通过有序 sections 列表组合 12 种内置分区。字符串会 …
-
OINK 实现预览正式亮相
今天，我们发布 OINK 实现预览：它从 Docsy 直接演进而来，提供统一的产品页面骨架、仅依赖 Hugo 的站点构建、本地优先的浏览器依赖、通用多语言框架，以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这次预览完成了首个正式标签与 Cloudflare Pages 生产部署之前的实现与文档里程碑。 为什么需要 OINK？ 多个成熟的文档站此前各自复制了相同的 Docsy 布局、导航、搜索代码、SCSS、JavaScript 与短代码。每当修复一个共性问题，都必须在多个仓库里重复改动 …
今天，我们发布 OINK 实现预览：它从 Docsy 直接演进而来，提供统一的产品页面骨架、仅依赖 Hugo 的站点构建、本地优先的浏览器依赖、通用多语言框架，以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这次预览完成了首个正式标签与 Cloudflare Pages 生产部署之前的实现与文档里程碑。 为什么需要 OINK？ 多个成熟的文档站此前各自复制了相同的 Docsy 布局、导航、搜索代码、SCSS、JavaScript 与短代码。每当修复一个共性问题，都必须在多个仓库里重复改动 …
-
OINK 实施日记：从复制外壳到统一主题
OINK 源于一个现实痛点：手头的多个生产文档站本就同源，却把公共实现拆成了散落各处的复制文件。虽然前台外观看着一致，日常维护却要在多个仓库里来回同步。 这篇日记记录我们如何把散落的站点覆盖项收敛为一套统一主题，重点交代背后的技术取舍、迁移演练与测试设计。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前，我们先写清产品必须是什么： 从 Docsy 直接演化而来的独立主题； 唯一标准外壳，而不是可切换皮肤； Hugo Extended 是消费端唯一构建依赖； 所有主题自带浏览器资源 …
OINK 源于一个现实痛点：手头的多个生产文档站本就同源，却把公共实现拆成了散落各处的复制文件。虽然前台外观看着一致，日常维护却要在多个仓库里来回同步。 这篇日记记录我们如何把散落的站点覆盖项收敛为一套统一主题，重点交代背后的技术取舍、迁移演练与测试设计。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前，我们先写清产品必须是什么： 从 Docsy 直接演化而来的独立主题； 唯一标准外壳，而不是可切换皮肤； Hugo Extended 是消费端唯一构建依赖； 所有主题自带浏览器资源 …
-
Oink 0.1.0：稳定的本地优先基础
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 或更高版本。消费站点 …
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 或更高版本。消费站点 …