
Hugo v0.147.0 リリースノートまとめ
Warning
※この記事は生成AIを使用して作成された記事です。(create by GPT-4o)
記事内容については未検証ですので参考程度にご活用ください
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
オプションを使用している場合、今回の修正により全画面表示が正しく動作するようになります。特に何か対応する必要はありませんが、アップデート前後で動作に差がないか確認しておくと良いでしょう。