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
This commit is contained in:
Xin
2026-02-20 23:08:33 +00:00
committed by GitHub
parent d2c650a490
commit 089c2fb5e1
7 changed files with 880 additions and 11 deletions

View File

@@ -0,0 +1,217 @@
---
title: "Hextra v0.12"
date: 2026-02-20
authors:
- name: imfing
link: https://github.com/imfing
image: https://github.com/imfing.png
tags:
- Release
---
Hextra v0.12.0 は、ページコンテキストメニュー、画像ズーム、刷新されたタブ、その他多くの新機能に加え、包括的な WCAG 2.2 AA アクセシビリティ改善と多数のバグ修正を提供します。
<!--more-->
## アップグレードガイド
ほとんどのサイトで破壊的変更はありません。[Hugo Modules](https://gohugo.io/hugo-modules/use-modules/) を使って更新してください:
```bash
hugo mod get -u github.com/imfing/hextra
```
## ハイライト
- Markdown ソースのコピー・表示ができるページコンテキストメニュー
- タブ名指定とアイコンをサポートする刷新されたタブショートコード
- Markdown 画像のクリックズーム
- GoatCounter アナリティクス対応
- デスクトップでメインサイドバーを非表示にするオプション
- GitInfo による最終更新者の表示
- 前へ/次へナビゲーションの無効化オプション
- ブログ記事の年別アーカイブページ
- 用語集ショートコードとレイアウト
- llms.txt からのページ/セクション除外
- モバイルサイドバーの順序とラベルが `menu.main` に準拠
- CSS 変数オーバーライドによる安定したコンテンツ幅
- 包括的な WCAG 2.2 AA アクセシビリティ改善
## 新機能
### ページコンテキストメニュー
![コンテキストメニュー](https://github.com/user-attachments/assets/0b55bee9-6f4d-4e1d-9461-60c40208cb6c)
ページコンテキストメニューはドロップダウンボタンを提供し、ページの内容を Markdown としてコピーしたり、生の Markdown ソースを表示できます。ドキュメントを生成 AI ツールに取り込むユーザーが増える中、クリーンな Markdown への素早いアクセスはますます有用です。テンプレート変数(`{url}``{title}``{markdownUrl}`を使ったカスタムリンクにより、「AI に質問」ショートカットなどのインテグレーションをメニューに直接組み込めます。
「Markdown として表示」および `{markdownUrl}` 機能を利用するには、サイト設定で Markdown 出力フォーマットを有効にしてください:
```yaml {filename="hugo.yaml"}
outputs:
page: [html, markdown]
section: [html, rss, markdown]
```
次にコンテキストメニューを設定します:
```yaml {filename="hugo.yaml"}
params:
page:
contextMenu:
enable: true
links:
- name: "Ask AI"
url: "https://example.com?content={markdownUrl}"
icon: "sparkles"
```
### タブの刷新とアイコン対応
[タブショートコード]({{% relref "docs/guide/shortcodes/tabs" %}})が刷新されました。各 `tab` ショートコードでタブ名を直接設定でき、オプションの `icon` パラメータでラベルの前にアイコンを表示できます。従来の構文も引き続きサポートされています。
```md
{{</* tabs */>}}
{{</* tab name="Photos" icon="photograph" */>}}写真ライブラリを管理・整理します。{{</* /tab */>}}
{{</* tab name="Music" icon="music-note" */>}}お気に入りの曲を閲覧・再生します。{{</* /tab */>}}
{{</* tab name="Videos" icon="film" */>}}動画コンテンツを視聴・ストリーミングします。{{</* /tab */>}}
{{</* /tabs */>}}
```
![アイコン付きタブ](https://github.com/user-attachments/assets/afa4cb8f-615c-4f01-8ae4-81a64c9ce391)
### 画像ズーム
[medium-zoom](https://github.com/francoischalifour/medium-zoom) を利用した新しい設定オプションで、Markdown 画像のクリックズームを有効にできます。
```yaml {filename="hugo.yaml"}
params:
imageZoom: true
```
### GoatCounter アナリティクス
既存の Google Analytics、Umami、Matomo に加え、[GoatCounter](https://www.goatcounter.com/) アナリティクスの組み込みサポートを追加しました。
### メインサイドバーの非表示
新しいフロントマターパラメータにより、デスクトップでメインサイドバーを非表示にしてコンテンツを全幅表示できます。
```yaml {filename="content/my-page.md"}
---
title: My Page
sidebar:
hide: true
---
```
### 最終更新者の表示
Hugo の GitInfo を使って、「最終更新日」と合わせて最終コミット者を表示します。
```yaml {filename="hugo.yaml"}
params:
displayUpdatedAuthor: true
```
![最終更新者](https://github.com/user-attachments/assets/275b7177-e089-483c-abb6-6d8f16616b9b)
### 前へ/次へナビゲーションの無効化
サイト全体で前へ/次へナビゲーションボタンを無効にできます:
```yaml {filename="hugo.yaml"}
params:
page:
displayPagination: false
```
### LLMs.txt 除外
フロントマターで `llms: false` を設定すると、個別のページやセクション全体を `llms.txt` 出力から除外できます。
```yaml {filename="content/private-page.md"}
---
title: "Private Page"
llms: false
---
```
### アーカイブページ
新しい組み込み `archives` レイアウトは、ブログ記事を年ごとにグループ化した時系列タイムラインで表示し、各タイトルの後にタグをインラインで表示します。
```yaml {filename="content/archives/_index.md"}
---
title: Archives
layout: archives
---
```
![アーカイブページ](https://github.com/user-attachments/assets/262cc0fa-e0af-4a50-8c3d-4465059418b8)
### 用語集
サイト全体の[用語集]({{% 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](https://github.com/ghac101) - Umami アナリティクスの修正、前へ/次へナビゲーションの無効化
- [@pmarrapese](https://github.com/pmarrapese) - ヘッダーの Markdown 属性サポート
- [@Bubbler-4](https://github.com/Bubbler-4) - details ショートコードのドキュメント
- [@bloovis](https://github.com/bloovis) - FlexSearch の結果件数修正
- [@AntoninPvr](https://github.com/AntoninPvr) - カードのサブタイトル位置修正
- [@illia-v](https://github.com/illia-v) - モバイル TOC と検索トグルの修正
- [@gallochri](https://github.com/gallochri) - イタリア語ローカリゼーション
- [@MatheusFlausino](https://github.com/MatheusFlausino) - LLMs.txt 除外
- [@daniseijo](https://github.com/daniseijo) - 最終更新者機能
- [@confusedkernel](https://github.com/confusedkernel) - アーカイブページ
- [@Fenyutanchan](https://github.com/Fenyutanchan) - Hugo v0.156.0 RSS author 互換性修正
さらに、継続的な貢献をいただいている [@KStocky](https://github.com/KStocky)、[@ldez](https://github.com/ldez)、[@kowyo](https://github.com/kowyo)、[@torbjornbp](https://github.com/torbjornbp)、[@yuri1969](https://github.com/yuri1969)、[@PrintN](https://github.com/PrintN) の各コントリビューターに感謝いたします。
---
**完全な変更履歴**: https://github.com/imfing/hextra/compare/v0.11.1...v0.12.0