Upgrade Hugo and the theme module (HugoBlox -> kit)

[shunk031]

背景

• mise.toml で hugo-extended = "0.136.5" に固定されている。2026-07 時点の Hugo 最新版は 0.164 系であり、約 1 年半分のギャップがある。
• .github/dependabot.yml は github-actions と gomod の 2 エコシステムのみを監視対象にしており、mise.toml に書かれた Hugo バージョンは Dependabot の自動更新対象外になっている。
• 加えて、本サイトが利用している Hugo Modules 上のテーマ (hugo-blox-builder 系列) は、upstream で HugoBlox/kit への移行が進んでいる。
• ローカルの layouts/ 配下にあるテーマ override は blox-core v0.3.1 時点の実装のコピーであり、モジュール更新時に壊れるリスクが高い。このリスクは PR fix(layouts): repair gravatar URL, a11y issues, and remove dead templates #376 のレビューで実コードを確認済みで、特に以下の2ファイルはテーマの authors/list.html から静的に参照されているため影響範囲が広い:
  • layouts/partials/blocks/about.biography.html
  • layouts/partials/blocks/v1/about.html

提案

以下の段階的なアップグレード計画を検討する。

1. Hugo 本体の段階的な更新: 0.136.5 → 直近の LTS/安定版 → 最新版、という形で一度に大きくジャンプせず、ビルド・レイアウトの崩れがないか各段階で確認しながら進める。
2. override の対応確認: Hugo / テーマのバージョンを上げるたびに、layouts/partials/blocks/about.biography.html と layouts/partials/blocks/v1/about.html を含む override 一式が新しいテーマの構造と整合しているかを確認する。
3. 将来的な HugoBlox/kit への移行の検討: upstream の移行が完了・安定した段階で、hugo-blox-builder から kit への切り替えを別タスクとして評価する (override 全体の書き直しが必要になる可能性が高いため、影響範囲の大きい作業として切り出す)。

mise.toml のバージョン追従の仕組み化

mise.toml 内の Hugo バージョンは現状 Dependabot の監視対象外なので、以下のような自動更新の仕組みを検討する。

• Renovate の mise マネージャ を導入し、mise.toml の hugo-extended バージョンを自動検知・PR 作成させる。
• Renovate 導入までの間の暫定対応として、Dependabot の設定ファイルに手動更新のリマインダー的な仕組み (定期的な issue 起票など) を検討してもよい。

未確定事項

• Hugo / テーマのどのバージョンを最終ターゲットにするか (最新追従 or LTS 追従) はメンテナンスコストとのバランスで要判断。
• kit への移行タイミングは upstream の安定度合いを見て判断する。

[shunk031]

メモ：kit にするといろいろアップデート大変な気がする

[shunk031]

PR #386 で Hugo 0.136.5 → 0.155.3 への段階的アップグレードを実施しました (CI green)。

0.156.0 以降へ進めないブロッカー: blox-bootstrap/v5@v5.9.7 の layouts/shortcodes/table.html:29 が Hugo v0.156.0 で削除された getCSV を呼んでおり、このサイトが table shortcode を使っていなくてもテンプレートのパース時点でビルドが失敗します。v5.9.7 は blox-bootstrap の最終リリース (Go module proxy で確認) のため hugo mod get -u では解決できず、これ以上のアップグレードには HugoBlox kit への移行が必要です。

発見した実リグレッション (修正済み): Hugo ≥0.153 は YAML frontmatter の非負整数を uint64 でデコードするため、テーマの render_view.html (int/int64 のみ対応) で数値 view: 指定が壊れ、Publications ページが citation レイアウトを失っていました。view: compact / view: citation の文字列指定に変更して回避しています。

フォローアップ候補: (1) kit 移行 (0.156+ の解禁)、(2) Hugo 0.158+ で languages.en.languageCode → locale の非推奨対応、(3) 追加した renovate.json (mise マネージャ) による Hugo 自動更新の運用確認。

詳細な検証結果 (バージョン別の pass/fail 表、819 ページのビルド同一性検証) は PR #386 の本文を参照してください。