升级 on OINK

升级到 Oink 0.4.0

Mon, 01 Jan 0001 00:00:00 +0000

Oink 0.4.0 是统一交付的场景组件版本。Reading & Release、Landing 与 Book 最初按 0.4、0.5、0.6 三条路线设计，但全部随单一公开标签 v0.4.0 发布。不要固定那些历史设计编号。

普通 Docsy 兼容内容、既有首页数据与模块路径保持兼容。升级工作主要是检查新的默认外壳行为，并替换两个已移除的 ICP 专用页脚参数。

创建升级分支并更新 Hugo 模块：

BASH

hugo mod get github.com/pgsty/oink@v0.4.0
hugo mod tidy
hugo mod graph | grep github.com/pgsty/oink

模块图必须解析到 github.com/pgsty/oink@v0.4.0，而不是伪版本或 main。Oink 0.4.0 要求 Hugo Extended 0.160.1 或更新版本，消费站仍然不需要 Node.js、PostCSS 或 CDN 流水线。

通过同级 checkout 开发时，请记住 go.work 会覆盖公开模块固定。把发布依赖判定为已验证前，应同时使用 GOWORK=off 与 HUGO_MODULE_WORKSPACE=off 单独验证公开标签。

docs、book 与 blog 现在默认带顺序翻页。文档和 Book 沿可见侧栏树前进，博客沿时间顺序前进。页面或分区刻意不属于任何序列时，可以退出：

Mon, 01 Jan 0001 00:00:00 +0000

生产站点应导入发布标签或不可变的 commit，绝不能跟随未固定版本的分支。在站点根目录，把 Oink 更新到指定 ref：

BASH

hugo mod get github.com/pgsty/oink@TARGET_VERSION
hugo mod tidy

请把 TARGET_VERSION 替换为发布注记指定的不可变标签，例如 v0.4.1。生产升级策略不要使用未限定版本的模块路径或 @latest。

如果要在不修改已提交模块版本的前提下测试本地 OINK checkout，请使用被忽略的 Go workspace：

BASH

go work init .
go work edit -replace=github.com/pgsty/oink=/absolute/path/to/oink
export HUGO_MODULE_WORKSPACE=go.work
hugo --gc --minify

不要把包含开发者机器专属绝对路径的 go.work 提交到仓库。

检查 Hugo 的依赖图：

BASH

hugo mod graph

确认主题解析到预期的标签、commit 或本地 replacement。OINK 不需要运行 hugo mod npm pack 或 npm install，因为浏览器依赖已经随主题提供。

Mon, 01 Jan 0001 00:00:00 +0000

OINK 旨在替换各站点复制的公共外壳、运行时与短代码，而无需批量重写普通正文。安全迁移应按依赖关系删除覆盖项，把产品专用行为留在站点，并在修改生产环境前先验证临时副本。

请在 go.mod 中固定已发布标签，或使用完整的版本化归档。预发布评估期间，Hugo Module 站点可以使用被忽略的 Go workspace，在不修改已提交模块版本的情况下解析本地 checkout：

BASH

go work init .
go work edit -replace=github.com/pgsty/oink=/absolute/path/to/oink
export HUGO_MODULE_WORKSPACE=go.work
hugo --gc --minify

站点的 hugo.yaml 导入 github.com/pgsty/oink；workspace 只替换本地 checkout。

把每个站点级文件归入以下四类之一：

layouts/、assets/、static/、配置与构建工作流必须一起检查。复制的短代码通常还伴随一份 JavaScript bundle、样式表、vendor 文件和 CI 安装步骤。

Mon, 01 Jan 0001 00:00:00 +0000