Hextra v0.12
Hextra v0.12.0 は、ページコンテキストメニュー、画像ズーム、刷新されたタブ、その他多くの新機能に加え、包括的な WCAG 2.2 AA アクセシビリティ改善と多数のバグ修正を提供します。
アップグレードガイド
ほとんどのサイトで破壊的変更はありません。Hugo Modules を使って更新してください:
hugo mod get -u github.com/imfing/hextraハイライト
- Markdown ソースのコピー・表示ができるページコンテキストメニュー
- タブ名指定とアイコンをサポートする刷新されたタブショートコード
- Markdown 画像のクリックズーム
- GoatCounter アナリティクス対応
- デスクトップでメインサイドバーを非表示にするオプション
- GitInfo による最終更新者の表示
- 前へ/次へナビゲーションの無効化オプション
- ブログ記事の年別アーカイブページ
- 用語集ショートコードとレイアウト
- llms.txt からのページ/セクション除外
- モバイルサイドバーの順序とラベルが
menu.mainに準拠 - CSS 変数オーバーライドによる安定したコンテンツ幅
- 包括的な WCAG 2.2 AA アクセシビリティ改善
新機能
ページコンテキストメニュー
ページコンテキストメニューはドロップダウンボタンを提供し、ページの内容を Markdown としてコピーしたり、生の Markdown ソースを表示できます。ドキュメントを生成 AI ツールに取り込むユーザーが増える中、クリーンな Markdown への素早いアクセスはますます有用です。テンプレート変数({url}、{title}、{markdown_url})を使ったカスタムリンクにより、「AI に質問」ショートカットなどのインテグレーションをメニューに直接組み込めます。
「Markdown として表示」および {markdown_url} 機能を利用するには、サイト設定で Markdown 出力フォーマットを有効にしてください:
outputs:
page: [html, markdown]
section: [html, rss, markdown]次にコンテキストメニューを設定します:
params:
page:
contextMenu:
enable: true
links:
- name: "Ask AI"
url: "https://example.com?content={markdown_url}"
icon: "sparkles"タブの刷新とアイコン対応
タブショートコードが刷新されました。各 tab ショートコードでタブ名を直接設定でき、オプションの icon パラメータでラベルの前にアイコンを表示できます。従来の構文も引き続きサポートされています。
{{< tabs >}}
{{< tab name="Photos" icon="photograph" >}}写真ライブラリを管理・整理します。{{< /tab >}}
{{< tab name="Music" icon="music-note" >}}お気に入りの曲を閲覧・再生します。{{< /tab >}}
{{< tab name="Videos" icon="film" >}}動画コンテンツを視聴・ストリーミングします。{{< /tab >}}
{{< /tabs >}}画像ズーム
medium-zoom を利用した新しい設定オプションで、Markdown 画像のクリックズームを有効にできます。
params:
imageZoom:
enable: trueGoatCounter アナリティクス
既存の Google Analytics、Umami、Matomo に加え、GoatCounter アナリティクスの組み込みサポートを追加しました。
メインサイドバーの非表示
新しいフロントマターパラメータにより、デスクトップでメインサイドバーを非表示にしてコンテンツを全幅表示できます。
---
title: My Page
sidebar:
hide: true
---最終更新者の表示
Hugo の GitInfo を使って、「最終更新日」と合わせて最終コミット者を表示します。
params:
displayUpdatedAuthor: true前へ/次へナビゲーションの無効化
サイト全体で前へ/次へナビゲーションボタンを無効にできます:
params:
page:
displayPagination: falseLLMs.txt 除外
フロントマターで llms: false を設定すると、個別のページやセクション全体を llms.txt 出力から除外できます。
---
title: "Private Page"
llms: false
---アーカイブページ
新しい組み込み archives レイアウトは、ブログ記事を年ごとにグループ化した時系列タイムラインで表示し、各タイトルの後にタグをインラインで表示します。
---
title: Archives
layout: archives
---用語集
サイト全体の用語集。専用のリストページとインライン定義用の term ショートコードを備えています。
アクセシビリティ
包括的な WCAG 2.2 AA アクセシビリティ改善 (#924):
- すべてのページに本文へスキップリンクと ARIA ランドマークロール
- すべてのインタラクティブウィジェット(テーマトグル、タブ、サイドバー、ファイルツリー、ドロップダウン、検索、メニュー)に ARIA 属性
- タブとテーマトグルのキーボードナビゲーション(矢印キー、Enter、Escape)
prefers-reduced-motionサポートとグローバルfocus-visibleスタイル- 全 21 ロケールに完全翻訳された 15 個の新しい i18n アクセシビリティキー
- ハードコードされた英語
aria-label文字列をすべて i18n ルックアップに置き換え
利便性の向上
- テーブルの読みやすさ向上のためのスタイル改善
- ヘッダーでの Markdown 属性サポート
- 多言語セクションランディングページでのアクティブリンク検出の改善
- カードショートコードで画像に
altパラメータをオプションでサポート - ページバンドル画像が OpenGraph メタデータでサポート
- コンテンツ幅がデフォルトで安定し、カスタムレイアウト用の CSS 変数オーバーライドをサポート
修正
- render-link での
relrefベースプレフィックスの二重付与を修正 - ステップ内にネストされたタブの描画を修正
- モバイルサイドバーの順序とラベルを
menu.mainに準拠 - サイドバーでの
search.enableの尊重 - モバイルドロップダウンでの
tocページパラメータの尊重 - FlexSearch のマッチハイライトと安全な DOM 操作の改善
- カードのサブタイトル位置の修正
- サブパスデプロイメントでの OG 画像パスの先頭スラッシュの処理
- FlexSearch が期待より少ない結果ページを返す問題の修正
- Umami アナリティクスのデフォルトファイルを
script.jsに変更 - Hugo v0.156.0+ での RSS author ルックアップの修正 (
.Site.Params.Author)
ドキュメントと i18n
- イタリア語ローカリゼーションを追加
- KaTeX ドキュメントへのリンクを追加
- details ショートコードのドキュメントを angle bracket 構文に更新
コントリビューター
このリリースは 11 名の新しいコントリビューターの貢献により実現しました:
- @ghac101 - Umami アナリティクスの修正、前へ/次へナビゲーションの無効化
- @pmarrapese - ヘッダーの Markdown 属性サポート
- @Bubbler-4 - details ショートコードのドキュメント
- @bloovis - FlexSearch の結果件数修正
- @AntoninPvr - カードのサブタイトル位置修正
- @illia-v - モバイル TOC と検索トグルの修正
- @gallochri - イタリア語ローカリゼーション
- @MatheusFlausino - LLMs.txt 除外
- @daniseijo - 最終更新者機能
- @confusedkernel - アーカイブページ
- @Fenyutanchan - Hugo v0.156.0 RSS author 互換性修正
さらに、継続的な貢献をいただいている @KStocky、@ldez、@kowyo、@torbjornbp、@yuri1969、@PrintN の各コントリビューターに感謝いたします。
完全な変更履歴: https://github.com/imfing/hextra/compare/v0.11.1...v0.12.0
