Hugo on OINK 文档主题

Hugo 0.158.0–0.164.x 升级指南

Tue, 28 Jul 2026 00:00:00 +0000

本文是 Docsy 0.16.0 发布文章的配套指南；后者说明了 0.16.0 要求并验证过的 Hugo 版本。

升级摘要

以下情况适合阅读本指南：
- 升级到 Docsy 0.16.0；
- 只升级 Hugo。
审阅 BREAKING 变更：
- 由 Hugo 管理的 Node 工具要求 Node 22+；
- HTML 内容与符号链接的安全规则发生变化。
审阅 弃用项：
- 语言配置与模板 API；
- 图片处理配置与模板 API。
可以快速浏览：
- Markdown 链接转义；
- 图片 URL 变动；
- 模板与 Module 清理；
- 更快的构建与更严格的模板；
- 重要变化。
准备好后，直接阅读升级到 Hugo 0.164.0。

语言 API 弃用项（0.158.0）

Hugo 0.158.0 重命名了若干语言配置项和模板方法。按照 Hugo 的弃用时间线，旧名称会先记录弃用通知，随后升级为警告，最终变为错误。

Hugo 0.152.0–0.155.x 升级指南

Mon, 09 Feb 2026 00:00:00 +0000

本文总结 Hugo 0.152.0 至 0.155.3 的破坏性变更与重要变化，是 Docsy 0.14.0 与 0.13.0 发布和升级指南的配套文章。

升级摘要

本指南重点说明 Hugo 0.152.0–0.155.x 的破坏性变更，以及可能需要执行的操作。

审阅 BREAKING 变更：
- YAML yes/no Token 变为字符串
- 多维站点的构建顺序发生变化
审阅 弃用项（不具破坏性，但建议处理）：
- Mount 的 lang 选项已弃用
- includeFiles/excludeFiles 已弃用
可以快速浏览：
- 已知问题与修复
- 重要变化
准备好后，直接阅读升级到 Hugo 0.155.x

YAML yes/no Token 变为字符串（0.152.0）

0.152.0（2025-10-21）升级到更现代的 YAML 库，导致配置文件和页面 Front Matter 中某些 Token 的解释方式发生破坏性变化。