hextra/docs/content/blog/v0.12.ja.md

---
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}`、`{markdown_url}`）を使ったカスタムリンクにより、「AI に質問」ショートカットなどのインテグレーションをメニューに直接組み込めます。

「Markdown として表示」および `{markdown_url}` 機能を利用するには、サイト設定で 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={markdown_url}"
          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:
    enable: 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