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

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

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

OINK 1.3.2 撤回了 1.3.1 引入的强制 Dart Sass 安装要求。普通站点构建与预览使用
**Hugo Extended 及其内置 LibSass**。主样式、ReDoc 样式、深色语法高亮和项目
SCSS 钩子继续可用。1.3.1 中独立的可读性修复与 FileTree 修复全部保留。

## 构建要求 {#build-requirements}

**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，需要另行评估兼容方案。

## 升级 {#upgrade}

更新模块版本：

```sh
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 定制不需要迁移。详情参见
[工具链契约](/zh/docs/design/architecture/#hugo-toolchain)。

## 验证 {#validation}

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

---

反链：

- [文档](/zh/docs/)
- [版本升级](/zh/docs/admin/upgrade/)