hextra/docs/content/blog/v0.12.ja.md at 089c2fb5e19a119222046d48190ac980d42d9170

ray/hextra

Files

Xin 089c2fb5e1 chore: release blog for Hextra v0.12

* chore: release blog for Hextra v0.12

* Add v0.12 blog translations and proofreading updates

* Merge main into plan-release-v0.12.0 and update build script versions

* Update build environment versions in netlify.toml to HUGO 0.156.0, GO 1.26.0, and NODE 24.13.1

* chore: update banner messages in multiple languages to reflect the release of Hextra **v0.12** in hugo.yaml

* docs(blog): align v0.12 tabs example with image (Photos/Music/Videos)

* docs(blog): fix page context menu wording (dropdown, not right-click)

* docs(hugo): update version link from v0.9 to v0.11 in menu

2026-02-20 23:08:33 +00:00

9.7 KiB

Raw Blame History

title, date, authors, tags

title

date

authors

アップグレードガイド

ほとんどのサイトで破壊的変更はありません。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}、{markdownUrl}）を使ったカスタムリンクにより、「AI に質問」ショートカットなどのインテグレーションをメニューに直接組み込めます。

「Markdown として表示」および {markdownUrl} 機能を利用するには、サイト設定で Markdown 出力フォーマットを有効にしてください:

outputs:
  page: [html, markdown]
  section: [html, rss, markdown]

次にコンテキストメニューを設定します:

params:
  page:
    contextMenu:
      enable: true
      links:
        - name: "Ask AI"
          url: "https://example.com?content={markdownUrl}"
          icon: "sparkles"

タブの刷新とアイコン対応

[タブショートコード]({{% relref "docs/guide/shortcodes/tabs" %}})が刷新されました。各 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: true

GoatCounter アナリティクス

既存の Google Analytics、Umami、Matomo に加え、GoatCounter アナリティクスの組み込みサポートを追加しました。

メインサイドバーの非表示

新しいフロントマターパラメータにより、デスクトップでメインサイドバーを非表示にしてコンテンツを全幅表示できます。

---
title: My Page
sidebar:
  hide: true
---

最終更新者の表示

Hugo の GitInfo を使って、「最終更新日」と合わせて最終コミット者を表示します。

params:
  displayUpdatedAuthor: true

前へ/次へナビゲーションの無効化

サイト全体で前へ/次へナビゲーションボタンを無効にできます:

params:
  page:
    displayPagination: false

LLMs.txt 除外

フロントマターで llms: false を設定すると、個別のページやセクション全体を llms.txt 出力から除外できます。

---
title: "Private Page"
llms: false
---

アーカイブページ

新しい組み込み archives レイアウトは、ブログ記事を年ごとにグループ化した時系列タイムラインで表示し、各タイトルの後にタグをインラインで表示します。

---
title: Archives
layout: archives
---

用語集

サイト全体の[用語集]({{% relref "docs/guide/shortcodes/term" %}})。専用のリストページとインライン定義用の 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

9.7 KiB Raw Blame History Unescape Escape