Files
hextra_mirror/exampleSite/content/blog/v0.11.ja.md
Xin 6d0e59b16f chore: release blog for Hextra v0.11 (#806)
* feat: release Hextra v0.11 with new features and improvements

- Updated banner key to 'announcement-v0.11' with a new message.
- Added new padding option 'hx:px-8' in hugo_stats.json.
- Introduced new blog post for Hextra v0.11 detailing UX enhancements, new components, and stability fixes.
- Added translations for the new blog post in French, Japanese, and Simplified Chinese.
- Updated getting started documentation to include instructions for using the development branch.
- Removed outdated banner HTML for v0.10.

* feat: update language banners for Hextra v0.11 release

- Added localized banner messages for Persian, Japanese, and Simplified Chinese.
- Updated the main announcement message format in the configuration file.

* Update exampleSite/content/blog/v0.11.md

Co-authored-by: Ludovic Fernandez <ldez@users.noreply.github.com>

* Update exampleSite/content/blog/v0.11.md

Co-authored-by: Ludovic Fernandez <ldez@users.noreply.github.com>

* Update blog post for Hextra v0.11 release

- Refined upgrade guide and removed unnecessary breaking change note.
- Enhanced descriptions for new features including the top banner, callouts, and analytics configuration.
- Improved clarity in code examples and added links to documentation for new components.
- Updated navbar enhancements and breadcrumbs enablement instructions.
- Fixed formatting inconsistencies and improved overall readability.

* Add blog post for Hextra v0.11 in Persian, Japanese, and Simplified Chinese

- Introduced new features including a site-wide top banner, redesigned callouts, and analytics support for Umami and Matomo.
- Enhanced navigation with icon support and improved layout.
- Added Asciinema shortcode for terminal recordings and external link decoration options.
- Updated upgrade guide and documentation for new components.
- Included stability fixes and quality of life improvements.

---------

Co-authored-by: Ludovic Fernandez <ldez@users.noreply.github.com>
2025-08-30 13:48:04 +01:00

129 lines
4.8 KiB
Markdown

---
title: "Hextra v0.11"
date: 2025-08-30
authors:
- name: imfing
link: https://github.com/imfing
image: https://github.com/imfing.png
tags:
- Release
---
Hextra v0.11.0 は、UX の磨き込みと便利な新コンポーネントに注力したリリースです。サイト全体バナー、改良されたコールアウトとバッジ、よりリッチなカード、アナリティクス連携、そしていくつかのナビゲーション改善を含みます。安定性の修正とドキュメント更新も同梱しています。
<!--more-->
## アップグレードガイド
ほとんどのサイトで破壊的変更はありません。[Hugo Modules](https://gohugo.io/hugo-modules/use-modules/) を使って更新してください:
```bash
hugo mod get -u github.com/imfing/hextra
```
## ハイライト
- お知らせ用のトップバナーコンポーネント
- より見やすくなったコールアウトの刷新
- Umami と Matomo のアナリティクス対応
- 端末録画のための Asciinema ショートコード
- 外部リンク装飾オプション
- 単一ページ(ドキュメント・ブログ以外)向けのパンくずリスト
- ナビバー改善: アイコン付きリンク項目と配置の改善
- バッジとカードのカスタマイズ性向上
- テーマ切り替えに「System」オプションを追加
## 新機能
### トップバナー
告知やリリース、ステータスメッセージ向けに、サイト全体で表示できる閉じられるバナーを追加します。
```yaml {filename="hugo.yaml"}
params:
banner:
key: "announcement"
message: Welcome!
```
![トップバナー](https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d)
### コールアウト刷新
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) のデザインを刷新し、テーマを問わず可読性と強調表現を向上しました。
![コールアウト刷新](https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d)
### アナリティクス: Umami と Matomo
以下のアナリティクスプロバイダに組み込み設定で対応:
- [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
- [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})
### Asciinema ショートコード
[Asciinema](https://www.asciinema.org/) の端末録画を、新しい [Asciinema ショートコード]({{% relref "docs/guide/shortcodes/asciinema.md" %}}) で埋め込みできます。
```md
{{</* asciinema id="123456" autoplay=true loop=true */>}}
```
![Asciinema](https://github.com/user-attachments/assets/3c33a8ef-3c01-4e30-9832-3ccb784ec538)
### ナビバーの改善
- ナビバーのリンク項目でアイコンをサポート
- 言語スイッチャー等との兼ね合いを考慮してメニュー配置を最適化
![アイコン付き項目のナビバー](https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42)
特に、[0.10.2](https://github.com/imfing/hextra/releases/tag/v0.10.2) ではナビバーに言語スイッチャーとテーマトグルを追加可能になりました。
### 外部リンク装飾
外部リンクに控えめな装飾をオプションで付与できます。
```yaml {filename="hugo.yaml"}
params:
externalLinkDecoration: true
```
### パンくずリストの有効化
フロントマターで `breadcrumbs: true` を設定すると、単一ページ(ドキュメント・ブログ以外)でパンくずリストを有効化できます。
```yaml {filename="content/about.md"}
---
title: About
breadcrumbs: true
---
```
### カードとバッジの改善
- [カード]({{% relref "docs/guide/shortcodes/cards.md" %}}): 新オプション `tagIcon` と `tagBorder`
- [バッジ]({{% relref "docs/guide/shortcodes/others.md" %}}): 新しい色とボーダースタイル
## 利便性の向上
- テーマ切り替え: 「System」オプションを追加
![テーマ切り替え](https://github.com/user-attachments/assets/54a1d315-9243-4814-9154-6e63af9ea2e8)
- タイポグラフィ: チェックボックス付きタスクリストのスタイル改善
![タスクリスト](https://github.com/user-attachments/assets/53722651-63b6-4469-95e7-326849a30306)
- 言語スイッチャー: アイコンメニュー項目との並び順を改善
## 修正
- Giscus: テーマと言語の同期を適切に実施
- カード: RTL でのバッジ描画を修正
- ナビバー: メニュー配置とインタラクションを調整
## ドキュメントと i18n
- Docs: Hextra のショートコードをまとめた新ページ
- i18n: `zh-cn` に `copyCode` と `system` の翻訳を追加
---
**完全な変更履歴**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0