Hugo v0.146.0 リリースノートまとめ

2025年4月25日にリリースされた Hugo v0.147.0 の主な更新内容をまとめます。既存ユーザー向けに 新機能・主な変更点・バグ修正・非推奨事項を分類し、プロジェクトへの影響や対応方法のヒントを解説します。

新機能

• images.Text の縦位置指定オプション追加
  画像操作機能 images.Text にテキストの縦位置を指定できる新オプション aligny が導入されました。従来からの alignx オプションと組み合わせることで、画像上のテキストを縦横とも中央に配置するなど、柔軟なレイアウトが可能になります。

主な変更点

• 設定（config）マージの改善
  デフォルト設定の適用順序が見直され、モジュールやテーマから読み込んだ設定をルートの設定により柔軟に統合できるようになりました。具体的には、config.toml 等で _merge = "deep" を指定すると、インポートしたモジュールやテーマの設定を深い階層までマージするようになります。これにより、複数サイトで共通設定を共有する際に、設定の上書きや階層構造が意図しない形で失われる問題を回避しやすくなります。詳細についてはドキュメントを参照してください。

• テーマスケルトンのテンプレート名調整
  テーマ作成用スケルトン (create/skeletons) において、一部テンプレートファイル名が変更されました。既存のカスタムテーマをインポートしている場合は、ファイル名の差分に注意してください。

バグ修正

• コードブロックレンダリング
  組み込みのコードブロックレンダリングを、カスタムの render-codeblock-*.html テンプレートよりも優先するよう修正されました。

• Vimeo/YouTube ショートコード
  allowFullScreen オプションの不具合が修正され、YouTube/Vimeo ショートコードで全画面表示が正しく機能するようになりました。

• 設定マージ (_merge) のバグ
  キーが存在しない場合の _merge 処理に関する不具合が修正されました。

• タイポ・文言修正
  ドキュメントやコード内の軽微な誤記やコメント表記の修正が行われました。

非推奨事項

今回のリリースでは、非推奨（deprecation）とされた機能は特にありません。既存の機能が削除・変更される予定も発表されていないため、現状のコードをそのまま継続利用できます。

影響と対応のヒント

• 画像テキスト配置の活用
  新しい aligny オプションにより、images.Text を使用した画像上のテキスト配置の自由度が高まりました。alignx と組み合わせて使うことで、テキストを画像の縦横中央に配置するレイアウトが簡単になります。必要に応じてショートコードやテンプレートの更新を検討してください。

• 設定統合の活用
  複数テーマやモジュールにまたがる設定を共通化している場合、config.toml に _merge = "deep" を追加すると良いでしょう。これにより、インポートした設定を階層構造のまままとめて取り込めます。ただし、マージ時に意図しない上書きが発生しないか、アップデート後に設定ファイルの挙動を確認してください。

• カスタムテンプレートの確認
  独自に作成した render-codeblock-*.html テンプレートなどがある場合、内部レンダリングの優先度変更によって出力結果が変わる可能性があります。新バージョンでサイトをビルドした際に、コードブロックの表示が期待通りかチェックしておくと安心です。

• ショートコードの挙動確認
  既存サイトで Vimeo/YouTube ショートコードの allowFullScreen オプションを使用している場合、今回の修正により全画面表示が正しく動作するようになります。特に何か対応する必要はありませんが、アップデート前後で動作に差がないか確認しておくと良いでしょう。

参考: Hugo v0.147.0 リリースノート（GitHub）

2025年2月26日にリリースされた Hugo v0.145.0 の主な更新内容をまとめます。既存ユーザー向けに 新機能・主な変更点・バグ修正・非推奨事項を分類し、プロジェクトへの影響や対応方法のヒントを解説します。

新機能

• transform.PortableText 関数の追加

  Sanity CMS との統合を容易にするため、transform.PortableText 関数が新たに導入されました。これにより、Sanity の Portable Text フォーマットを Hugo で直接処理できるようになります。

主な変更点

• _build フロントマターキーの非推奨化
  フロントマターの _build キーが非推奨となり、新たに build キーが推奨されるようになりました。今後のバージョンアップに備え、既存の _build キーを build に置き換えることを検討してください。

• Instagram ショートコードの HTTPS 化
  Instagram のショートコードで使用される JavaScript が HTTPS 経由で読み込まれるように変更され、セキュリティと互換性が向上しました。

• デフォルトソートの改善
  デフォルトのソート順が、バックエンドのファイル名ではなくページパスに基づくように変更されました。これにより、より直感的な並び順が実現されます。

バグ修正

• 関連コンテンツの問題修正
  コンテンツアダプターを使用した際に発生していた関連コンテンツの問題が修正されました。

• httpcache 設定の nil ポインターエラー修正
  httpcache 設定において、nil ポインターが原因で発生していたエラーが修正されました。

• --printPathWarnings オプションの修正
  templates.Defer を使用しているサイトで --printPathWarnings オプションが正しく機能しない問題が修正されました。

• ドキュメントのリンク修正
  README の Editions セクションにおける相対リンクの誤りが修正されました。

非推奨事項

• _build キーの非推奨化
  前述の通り、フロントマターの _build キーが非推奨となり、build キーの使用が推奨されます。既存のプロジェクトでは、早めの対応を検討してください。

影響と対応のヒント

• Sanity CMS との統合
  Sanity CMS を使用している場合、新たに追加された transform.PortableText 関数を活用することで、Portable Text フォーマットのデータを Hugo で直接処理できるようになります。これにより、データの取り込みと表示がよりスムーズになります。

• フロントマターの更新
  _build キーを使用している既存のコンテンツは、将来的な互換性のために build キーへの置き換えを検討してください。

• ショートコードの確認
  Instagram のショートコードを使用している場合、HTTPS 化に伴う影響がないか確認してください。特に、外部リソースの読み込みに関する設定やポリシーに注意が必要です。

• ソート順の確認
  デフォルトのソート順が変更されたことにより、ページの並び順に影響が出る可能性があります。必要に応じて、明示的なソート設定を追加してください。

参考: Hugo v0.145.0 リリースノート（GitHub）