Skip to content

Commit 6d0e59b

Browse files
imfingldez
imfing
and
ldez
authored
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 <[email protected]> * Update exampleSite/content/blog/v0.11.md Co-authored-by: Ludovic Fernandez <[email protected]> * 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 <[email protected]>
1 parent 3abcde4 commit 6d0e59b

File tree

8 files changed

+536
-4
lines changed

8 files changed

+536
-4
lines changed

‎exampleSite/content/blog/v0.11.fa.md‎

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: "Hextra v0.11"
3+
date: 2025-08-30
4+
authors:
5+
- name: imfing
6+
link: https://github.com/imfing
7+
image: https://github.com/imfing.png
8+
tags:
9+
- انتشار
10+
---
11+
12+
Hextra v0.11.0 بر صیقل UX و مؤلفه‌های جدید کاربردی تمرکز دارد: بنر سراسری سایت، کال‌اوت‌ها و بج‌های بهبودیافته، کارت‌های غنی‌تر، یکپارچه‌سازی تحلیل‌گرها، و چند بهبود ناوبری. همچنین شامل رفع اشکالات پایداری و به‌روزرسانی‌های مستندات است.
13+
14+
<!--more-->
15+
16+
## راهنمای ارتقا
17+
18+
برای بیشتر سایت‌ها تغییر شکست‌آمیزی وجود ندارد. با استفاده از [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/) به‌روزرسانی کنید:
19+
20+
```bash
21+
hugo mod get -u github.com/imfing/hextra
22+
```
23+
24+
## نکات برجسته
25+
26+
- مؤلفه بنر بالایی برای اعلان‌ها
27+
- بازطراحی کال‌اوت‌ها با سبک‌های شفاف‌تر
28+
- پشتیبانی از تحلیل‌گرهای Umami و Matomo
29+
- شورت‌کد Asciinema برای ضبط‌های ترمینال
30+
- گزینهٔ تزئین پیوندهای خارجی
31+
- مسیر راهنما برای صفحات تکی (غیرِ مستندات/غیرِ وبلاگ)
32+
- بهبودهای نوار ناوبری: مورد پیوند با آیکون و جای‌گذاری بهتر
33+
- سفارشی‌سازی بهتر بج‌ها و کارت‌ها
34+
- کلید تغییر تم از گزینه «System» پشتیبانی می‌کند
35+
36+
## ویژگی‌های جدید
37+
38+
### بنر بالایی
39+
40+
یک بنر سراسری و قابلِ بستن برای اعلان‌ها، لانچ‌ها یا پیام‌های وضعیت اضافه کنید.
41+
42+
```yaml {filename="hugo.yaml"}
43+
params:
44+
banner:
45+
key: "announcement"
46+
message: Welcome!
47+
```
48+
49+
![بنر بالایی](https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d)
50+
51+
### بازطراحی Callout
52+
53+
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) برای خوانایی بهتر و تأکید مناسب در تمام تم‌ها بازطراحی شده است.
54+
55+
![بازطراحی Callout](https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d)
56+
57+
### تحلیل‌گرها: Umami و Matomo
58+
59+
پیکربندی داخلی برای فراهم‌کنندگان تحلیل‌گر:
60+
- [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
61+
- [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})
62+
63+
### شورت‌کد Asciinema
64+
65+
با استفاده از [Asciinema](https://www.asciinema.org/) و [شورت‌کد Asciinema]({{% relref "docs/guide/shortcodes/asciinema.md" %}}) ضبط‌های ترمینال را درون‌گذاری کنید.
66+
67+
```md
68+
{{</* asciinema id="123456" autoplay=true loop=true */>}}
69+
```
70+
71+
![Asciinema](https://github.com/user-attachments/assets/3c33a8ef-3c01-4e30-9832-3ccb784ec538)
72+
73+
### بهبودهای نوار ناوبری
74+
75+
- پشتیبانی از آیکون برای موارد پیوند در نوار ناوبری
76+
- بهبود موقعیت منو برای هماهنگی با سوییچر زبان و سایر موارد
77+
78+
![نوار ناوبری با مورد آیکون](https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42)
79+
80+
قابل ذکر است، نسخه [0.10.2](https://github.com/imfing/hextra/releases/tag/v0.10.2) امکان افزودن سوییچر زبان و کلید تغییر تم به نوار ناوبری را فراهم می‌کند.
81+
82+
### تزئین پیوند خارجی
83+
84+
به‌صورت اختیاری یک تزئین ظریفِ «پیوند خارجی» به پیوندهای خروجی اضافه کنید.
85+
86+
```yaml {filename="hugo.yaml"}
87+
params:
88+
externalLinkDecoration: true
89+
```
90+
91+
### فعال‌سازی مسیر راهنما
92+
93+
با قرار دادن `breadcrumbs: true` در فرانت‌متر، مسیر راهنما را روی صفحات تکی (غیرِ مستندات/وبلاگ) فعال کنید.
94+
95+
```yaml {filename="content/about.md"}
96+
---
97+
title: About
98+
breadcrumbs: true
99+
---
100+
```
101+
102+
### بهبود کارت‌ها و بج‌ها
103+
104+
- [کارت‌ها]({{% relref "docs/guide/shortcodes/cards.md" %}}): گزینه‌های جدید `tagIcon` و `tagBorder`.
105+
- [بج‌ها]({{% relref "docs/guide/shortcodes/others.md" %}}): رنگ‌ها و سبک‌های حاشیهٔ جدید.
106+
107+
## بهبودهای کیفیت زندگی
108+
109+
- تغییر تم: افزودن گزینه «System»
110+
![کلید تغییر تم](https://github.com/user-attachments/assets/54a1d315-9243-4814-9154-6e63af9ea2e8)
111+
- تایپوگرافی: سبک‌های بهتر فهرست کار با چک‌باکس
112+
![فهرست کار](https://github.com/user-attachments/assets/53722651-63b6-4469-95e7-326849a30306)
113+
- سوییچر زبان: ترتیب‌دهی بهبود یافته همراه با موارد منوییِ آیکون‌دار
114+
115+
## رفع اشکالات
116+
117+
- Giscus: همگام‌سازی صحیح تم و زبان
118+
- کارت‌ها: رفع رندر بج در حالت RTL
119+
- نوار ناوبری: بهبود موقعیت و تعاملات منو
120+
121+
## مستندات و بومی‌سازی
122+
123+
- مستندات: صفحهٔ جدیدی دربارهٔ شورت‌کدهای Hextra
124+
- i18n: افزودن ترجمه‌های `copyCode` و `system` به `zh-cn`
125+
126+
---
127+
128+
**تغییرات کامل**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0

‎exampleSite/content/blog/v0.11.ja.md‎

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: "Hextra v0.11"
3+
date: 2025-08-30
4+
authors:
5+
- name: imfing
6+
link: https://github.com/imfing
7+
image: https://github.com/imfing.png
8+
tags:
9+
- Release
10+
---
11+
12+
Hextra v0.11.0 は、UX の磨き込みと便利な新コンポーネントに注力したリリースです。サイト全体バナー、改良されたコールアウトとバッジ、よりリッチなカード、アナリティクス連携、そしていくつかのナビゲーション改善を含みます。安定性の修正とドキュメント更新も同梱しています。
13+
14+
<!--more-->
15+
16+
## アップグレードガイド
17+
18+
ほとんどのサイトで破壊的変更はありません。[Hugo Modules](https://gohugo.io/hugo-modules/use-modules/) を使って更新してください:
19+
20+
```bash
21+
hugo mod get -u github.com/imfing/hextra
22+
```
23+
24+
## ハイライト
25+
26+
- お知らせ用のトップバナーコンポーネント
27+
- より見やすくなったコールアウトの刷新
28+
- Umami と Matomo のアナリティクス対応
29+
- 端末録画のための Asciinema ショートコード
30+
- 外部リンク装飾オプション
31+
- 単一ページ（ドキュメント・ブログ以外）向けのパンくずリスト
32+
- ナビバー改善: アイコン付きリンク項目と配置の改善
33+
- バッジとカードのカスタマイズ性向上
34+
- テーマ切り替えに「System」オプションを追加
35+
36+
## 新機能
37+
38+
### トップバナー
39+
40+
告知やリリース、ステータスメッセージ向けに、サイト全体で表示できる閉じられるバナーを追加します。
41+
42+
```yaml {filename="hugo.yaml"}
43+
params:
44+
banner:
45+
key: "announcement"
46+
message: Welcome!
47+
```
48+
49+
![トップバナー](https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d)
50+
51+
### コールアウト刷新
52+
53+
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) のデザインを刷新し、テーマを問わず可読性と強調表現を向上しました。
54+
55+
![コールアウト刷新](https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d)
56+
57+
### アナリティクス: Umami と Matomo
58+
59+
以下のアナリティクスプロバイダに組み込み設定で対応:
60+
- [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
61+
- [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})
62+
63+
### Asciinema ショートコード
64+
65+
[Asciinema](https://www.asciinema.org/) の端末録画を、新しい [Asciinema ショートコード]({{% relref "docs/guide/shortcodes/asciinema.md" %}}) で埋め込みできます。
66+
67+
```md
68+
{{</* asciinema id="123456" autoplay=true loop=true */>}}
69+
```
70+
71+
![Asciinema](https://github.com/user-attachments/assets/3c33a8ef-3c01-4e30-9832-3ccb784ec538)
72+
73+
### ナビバーの改善
74+
75+
- ナビバーのリンク項目でアイコンをサポート
76+
- 言語スイッチャー等との兼ね合いを考慮してメニュー配置を最適化
77+
78+
![アイコン付き項目のナビバー](https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42)
79+
80+
特に、[0.10.2](https://github.com/imfing/hextra/releases/tag/v0.10.2) ではナビバーに言語スイッチャーとテーマトグルを追加可能になりました。
81+
82+
### 外部リンク装飾
83+
84+
外部リンクに控えめな装飾をオプションで付与できます。
85+
86+
```yaml {filename="hugo.yaml"}
87+
params:
88+
externalLinkDecoration: true
89+
```
90+
91+
### パンくずリストの有効化
92+
93+
フロントマターで `breadcrumbs: true` を設定すると、単一ページ（ドキュメント・ブログ以外）でパンくずリストを有効化できます。
94+
95+
```yaml {filename="content/about.md"}
96+
---
97+
title: About
98+
breadcrumbs: true
99+
---
100+
```
101+
102+
### カードとバッジの改善
103+
104+
- [カード]({{% relref "docs/guide/shortcodes/cards.md" %}}): 新オプション `tagIcon` と `tagBorder`
105+
- [バッジ]({{% relref "docs/guide/shortcodes/others.md" %}}): 新しい色とボーダースタイル
106+
107+
## 利便性の向上
108+
109+
- テーマ切り替え: 「System」オプションを追加
110+
![テーマ切り替え](https://github.com/user-attachments/assets/54a1d315-9243-4814-9154-6e63af9ea2e8)
111+
- タイポグラフィ: チェックボックス付きタスクリストのスタイル改善
112+
![タスクリスト](https://github.com/user-attachments/assets/53722651-63b6-4469-95e7-326849a30306)
113+
- 言語スイッチャー: アイコンメニュー項目との並び順を改善
114+
115+
## 修正
116+
117+
- Giscus: テーマと言語の同期を適切に実施
118+
- カード: RTL でのバッジ描画を修正
119+
- ナビバー: メニュー配置とインタラクションを調整
120+
121+
## ドキュメントと i18n
122+
123+
- Docs: Hextra のショートコードをまとめた新ページ
124+
- i18n: `zh-cn` に `copyCode` と `system` の翻訳を追加
125+
126+
---
127+
128+
**完全な変更履歴**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0

‎exampleSite/content/blog/v0.11.md‎

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: "Hextra v0.11"
3+
date: 2025-08-30
4+
authors:
5+
- name: imfing
6+
link: https://github.com/imfing
7+
image: https://github.com/imfing.png
8+
tags:
9+
- Release
10+
---
11+
12+
Hextra v0.11.0 focuses on UX polish and useful new components: site-wide banner, improved callouts and badges, richer cards, analytics integrations, and several navigation refinements. It also ships stability fixes and documentation updates.
13+
14+
<!--more-->
15+
16+
## Upgrade Guide
17+
18+
No breaking changes are expected for most sites. Update using [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/):
19+
20+
```bash
21+
hugo mod get -u github.com/imfing/hextra
22+
```
23+
24+
## Highlights
25+
26+
- Top banner component for announcements
27+
- Revamped callouts with clearer styles
28+
- Umami and Matomo analytics support
29+
- Asciinema shortcode for terminal recordings
30+
- External link decoration option
31+
- Breadcrumbs for single pages (non-docs, non-blogs)
32+
- Navbar enhancements: icon link item and improved positions
33+
- Improved badges and cards customization
34+
- Theme toggle supports "System"
35+
36+
## New Features
37+
38+
### Top Banner
39+
40+
Add a site-wide, dismissible banner for announcements, launches, or status messages.
41+
42+
```yaml {filename="hugo.yaml"}
43+
params:
44+
banner:
45+
key: "announcement"
46+
message: Welcome!
47+
```
48+
49+
![Top Banner](https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d)
50+
51+
### Callout Revamp
52+
53+
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) receive a design refresh for better readability and emphasis across themes.
54+
55+
![Callout refresh](https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d)
56+
57+
### Analytics: Umami and Matomo
58+
59+
Built-in configuration for analytics providers:
60+
- [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
61+
- [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})
62+
63+
### Asciinema Shortcode
64+
65+
Embed terminal recordings from [Asciinema](https://www.asciinema.org/) using the new [Asciinema shortcode]({{% relref "docs/guide/shortcodes/asciinema.md" %}}).
66+
67+
```md
68+
{{</* asciinema id="123456" autoplay=true loop=true */>}}
69+
```
70+
71+
![Asciinema](https://github.com/user-attachments/assets/3c33a8ef-3c01-4e30-9832-3ccb784ec538)
72+
73+
### Navbar Enhancements
74+
75+
- Support icons for link items in the navbar
76+
- Refine menu positions to play nicely with the language switcher and other items
77+
78+
![Navbar with icon item](https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42)
79+
80+
Notably, version [0.10.2](https://github.com/imfing/hextra/releases/tag/v0.10.2) enables the addition of language switchers and theme toggles to the navbar.
81+
82+
### External Link Decoration
83+
84+
Optionally add a subtle external-link decoration to outbound links.
85+
86+
```yaml {filename="hugo.yaml"}
87+
params:
88+
externalLinkDecoration: true
89+
```
90+
91+
### Breadcrumbs Enablement
92+
93+
Enable breadcrumbs on single pages (non-docs, non-blogs) by setting `breadcrumbs: true` in front matter.
94+
95+
```yaml {filename="content/about.md"}
96+
---
97+
title: About
98+
breadcrumbs: true
99+
---
100+
```
101+
102+
### Cards and Badges Improvements
103+
104+
- [Cards]({{% relref "docs/guide/shortcodes/cards.md" %}}): new `tagIcon` and `tagBorder` options.
105+
- [Badges]({{% relref "docs/guide/shortcodes/others.md" %}}): new colors and border styles.
106+
107+
## Quality of Life
108+
109+
- Theme toggle: add "System" option
110+
![Theme toggle](https://github.com/user-attachments/assets/54a1d315-9243-4814-9154-6e63af9ea2e8)
111+
- Typography: better task list styles with checkboxes
112+
![Task list](https://github.com/user-attachments/assets/53722651-63b6-4469-95e7-326849a30306)
113+
- Language switcher: improved ordering with icon menu items
114+
115+
## Fixes
116+
117+
- Giscus: sync theme and language properly
118+
- Cards: fix badge rendering with RTL
119+
- Navbar: refine menu positions and interactions
120+
121+
## Documentation & i18n
122+
123+
- Docs: new page covering Hextra shortcodes
124+
- i18n: add `copyCode` and `system` translations to `zh-cn`
125+
126+
---
127+
128+
**Full Changelog**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0

0 commit comments

Comments
 (0)