Hugo の破壊的変更
Lastmod: 2025-08-12

hugo はテンプレーティング機能に破壊的変更を行うにもかかわらず、major バージョンが変わらない。とても困るので対処の方法を記録しておく。

0.134.0 で観測

Site.IsServer がdeprecated で、かわりに hugo.IsServerとエラーが出る。(まだ 0.135.0 じゃないのに。)

$ ./tmp/0.134.0/hugo
Start building sites …
hugo v0.134.0-77df7bbbff8ce6b56ed693270088de973a87d5ce linux/amd64 BuildDate=2024-09-03T09:54:22Z VendorInfo=gohugoio

ERROR deprecated: .Site.IsServer was deprecated in Hugo v0.120.0 and will be removed in Hugo 0.135.0. Use hugo.IsServer instead.
Total in 321 ms
Error: error building site: logged 1 error(s)

Breaking change introduced by v0.134.0

Page オブジェクトの .Summary の返す内容が、HTML のタグを含むようになってしまった。例えばコンテンツが markdown で、冒頭に次のように与えられたとき、

## head2

bodybodybody

v0.133.1 まで、Page.Summary は次のhtml(plaintext)を返していた。

head2 bodybodybody

これが v0.134.0 だと

<h2 id="head2">head2</h2>
<p>bodybodybody</p>

となってしまう。