发布日期: 2026-04-04
版本号: v0.160.0

Hugo 最新更新支持在构建样式表时通过 css.Build 注入 CSS 变量（例如来自配置的变量），同时所有渲染钩子均新增了更精确高效的 .Position 方法。本次更新修复了包括位置信息、链接中 & 符号双重转义以及脚本上下文中部分装饰器异常引号在内的若干问题；改进了测试框架替换了原有的 IntegrationTestBuilder，增强了 Goldmark 渲染钩子的 .Position 处理，并在 CSS 构建中支持通过 @import “hugo:vars” 引用自定义属性。此外，更新了多个依赖库版本，并修订了文档中的版本说明与安装指引。

更新内容 （中文）

现在您可以在使用 css.Build 构建时，将 CSS 变量（例如来自配置文件）注入样式表中。同时，所有渲染钩子现在都具备了 .Position 方法，其定位也变得更加准确和高效。

错误修复

  • 修复近期引入的一些 Position 相关问题 4e91e14c @bep #14710
  • markup/goldmark：修复链接 URL 中连接符的双重转义问题 dc9b51d2 @bep #14715
  • tpl：修复脚本上下文中部分装饰器产生的多余引号 43aad711 @bep #14711

改进

  • 全部：用 Test/TestE/TestRunning 替换 NewIntegrationTestBuilder 481baa08 @bep
  • tpl/css：在 css.Build 中支持通过 @import “hugo:vars” 导入 CSS 自定义属性 5d09b5e3 @bep #14699
  • 改进并扩展 Goldmark 渲染钩子中的 .Position 处理逻辑 303e443e @bep #14663
  • markup/goldmark：清理测试用例 638262ce @bep

依赖更新

  • build(deps): 将 github.com/magefile/mage 从 1.16.1 升级至 1.17.1 bf6e35a7 @dependabot[bot]
  • build(deps): 将 github.com/go-jose/go-jose/v4 从 4.1.3 升级至 4.1.4 0eda24e6 @dependabot[bot]
  • build(deps): 将 golang.org/x/image 从 0.37.0 升级至 0.38.0 beb57a68 @dependabot[bot]

文档更新

  • readme：修订版本说明和安装指引 9f1f1be0 @jmooring

更新内容 （原始）

Now you can inject CSS vars, e.g. from the configuration, into your stylesheets when building with css.Build. Also, now all the render hooks has a .Position method, now also more accurate and effective.

Bug fixes

  • Fix some recently introduced Position issues 4e91e14c @bep #14710
  • markup/goldmark: Fix double-escaping of ampersands in link URLs dc9b51d2 @bep #14715
  • tpl: Fix stray quotes from partial decorator in script context 43aad711 @bep #14711

Improvements

  • all: Replace NewIntegrationTestBuilder with Test/TestE/TestRunning 481baa08 @bep
  • tpl/css: Support @import “hugo:vars” for CSS custom properties in css.Build 5d09b5e3 @bep #14699
  • Improve and extend .Position handling in Goldmark render hooks 303e443e @bep #14663
  • markup/goldmark: Clean up test 638262ce @bep

Dependency Updates

  • build(deps): bump github.com/magefile/mage from 1.16.1 to 1.17.1 bf6e35a7 @dependabot[bot]
  • build(deps): bump github.com/go-jose/go-jose/v4 from 4.1.3 to 4.1.4 0eda24e6 @dependabot[bot]
  • build(deps): bump golang.org/x/image from 0.37.0 to 0.38.0 beb57a68 @dependabot[bot]

Documentation

  • readme: Revise edition descriptions and installation instructions 9f1f1be0 @jmooring

下载链接