Update Hugo Version to 0.150 From 0.113

長らく放置していた hugo のバージョンを更新したところ、そのままでは起動できなかったので対応したことをメモしておく。

Hugo のバージョン更新

既存の hugo のバージョンは 0.113 で、これを最新の 0.150 に更新した。

❯ hugo version  
hugo v0.113.0+extended darwin/arm64 BuildDate=unknown

❯ brew upgrade hugo

❯ hugo version                                                                
hugo v0.150.1+extended+withdeploy darwin/arm64 BuildDate=2025-09-25T10:26:04Z VendorInfo=brew

そのままでは起動できない

ローカルで起動しようとすると、下記の Error および Warning が出て起動できなかった。

❯ hugo server -D
ERROR deprecated: site config key paginate was deprecated in Hugo v0.128.0 and subsequently removed. Use pagination.pagerSize instead.
WARN  deprecated: site config key services.twitter.disableInlineCSS was deprecated in Hugo v0.141.0 and will be removed in a future release. Use services.x.disableInlineCSS instead.

site config key paginate was deprecated

config.toml の paginate の設定が deprecated になったとのことなので、 公式ドキュメント を参考に pagination.pagerSize に変更した。

- paginate = 20
+ [pagination]
+   pagerSize = 20

site config key services.twitter.disableInlineCSS was deprecated

config.toml の services.twitter.disableInlineCSS の設定が deprecated になったとのことなので、 公式ドキュメント を参考に services.x.disableInlineCSS に変更した。

- [services.twitter]
+ [services.x]

その他の変更点

theme の指定

theme を認識してくれないようになったので、ローカル実行時およびビルド時に --theme オプションで指定するようにした。

site.IsServer の代わりに hugo.IsServer を使う

各所で site.IsServer を使っていたが、hugo.IsServer に変更した。

まとめ

Hugo のバージョンを更新した際に起動できなかったので、config.toml の設定を変更して無事に起動できるようになった。

定期的にアップデートしましょう。