Cloudflare PagesのHugoのバージョンが古くてデプロイに失敗した

以前書いた通り、このサイトはHugoで構築している。

サーバーを、Cloudflare + GitLab Pagesの構成から、Cloudflare Pages単体の構成に移行した。

その時に、エラーが出てデプロイに失敗して躓いた。

Error: "/opt/buildhome/repo/themes/hugo-PaperMod/layouts/partials/toc.html:71:1": parse failed: template: partials/toc.html:71: illegal number syntax: "-"
Failed: build command exited with code: 255

原因

Cloudflare Pagesの初期状態ではHugoのバージョンが「0.54.0」だったため、古すぎてテーマが対応していなかった。

Known issues · Cloudflare Pages docs

Hugo builds automatically run an old version. To run the latest version of Hugo (for instance, 0.80.0), you’ll need to set an environment variable. Set HUGO_VERSION to 0.80.0 or the Hugo version of your choice.

設定の「環境変数」でバージョン指定を追加して解決。

# 例: 0.82.1 にしたいとき
HUGO_VERSION = 0.82.1

原因#

原因