2e709bf92d
- Use nested imageZoom.enable: true instead of scalar imageZoom: true
- Use {markdown_url} (snake_case) placeholder matching the actual template-url
utility key, not {markdownUrl} (camelCase) which would silently not substitute
219 lines
9.7 KiB
Markdown
219 lines
9.7 KiB
Markdown
---
|
||
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 アクセシビリティ改善
|
||
|
||
## 新機能
|
||
|
||
### ページコンテキストメニュー
|
||
|
||
|
||
|
||
ページコンテキストメニューはドロップダウンボタンを提供し、ページの内容を 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 */>}}
|
||
```
|
||
|
||
|
||
|
||
### 画像ズーム
|
||
|
||
[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
|
||
```
|
||
|
||
|
||
|
||
### 前へ/次へナビゲーションの無効化
|
||
|
||
サイト全体で前へ/次へナビゲーションボタンを無効にできます:
|
||
|
||
```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
|
||
---
|
||
```
|
||
|
||
|
||
|
||
### 用語集
|
||
|
||
サイト全体の[用語集]({{% 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
|