跳转到主要内容

OINK 1.3.2 — 恢复仅依赖 Hugo 的构建

移除强制 Dart Sass 依赖,恢复 Hugo Extended 0.166.0 作为最低版本和默认版本,并接受 Hugo 0.168 的 LibSass 警告。

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 程序、Node.js 或 npm。

Hugo Extended 0.168.0 同样可以构建和预览站点。它会报告上游 LibSass 弃用 警告,这条警告允许出现并保持可见。如果使用 --panicOnWarning,该警告会使 构建失败;严格发布门禁请使用 0.166.0。OINK 不屏蔽其他警告。

默认 Hugo 版本保持固定。后续升级必须保持普通用户的依赖边界。如果 Hugo 新版本 移除内置 LibSass,需要另行评估兼容方案。

升级

更新模块版本:

hugo mod get github.com/pgsty/oink@v1.3.2

提交更新后的 go.mod 和 go.sum。移除仅为 OINK 1.3.1 添加的 Sass 安装步骤, 将默认 Hugo workflow 版本设为 0.166.0。使用 vendor 主题的站点还需刷新对应副本。

现有内容、外观设置和项目 SCSS 定制不需要迁移。详情参见 工具链契约。

验证

主题的编译检查在 PATH 中没有 Sass 程序的环境下,构建真实的主样式和 ReDoc 样式,并验证项目变量、项目样式钩子与深色 Chroma 调色板。Hugo 0.166.0 使用严格 警告检查;独立的 0.168.0 用例只接受已知的上游 LibSass 弃用警告。