mirror of
https://github.com/imfing/hextra.git
synced 2025-09-13 23:46:57 -04:00
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>
This commit is contained in:
128
exampleSite/content/blog/v0.11.fa.md
Normal file
128
exampleSite/content/blog/v0.11.fa.md
Normal file
@@ -0,0 +1,128 @@
|
|||||||
|
---
|
||||||
|
title: "Hextra v0.11"
|
||||||
|
date: 2025-08-30
|
||||||
|
authors:
|
||||||
|
- name: imfing
|
||||||
|
link: https://github.com/imfing
|
||||||
|
image: https://github.com/imfing.png
|
||||||
|
tags:
|
||||||
|
- انتشار
|
||||||
|
---
|
||||||
|
|
||||||
|
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!
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### بازطراحی Callout
|
||||||
|
|
||||||
|
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) برای خوانایی بهتر و تأکید مناسب در تمام تمها بازطراحی شده است.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### تحلیلگرها: 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 */>}}
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### بهبودهای نوار ناوبری
|
||||||
|
|
||||||
|
- پشتیبانی از آیکون برای موارد پیوند در نوار ناوبری
|
||||||
|
- بهبود موقعیت منو برای هماهنگی با سوییچر زبان و سایر موارد
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
قابل ذکر است، نسخه [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»
|
||||||
|

|
||||||
|
- تایپوگرافی: سبکهای بهتر فهرست کار با چکباکس
|
||||||
|

|
||||||
|
- سوییچر زبان: ترتیبدهی بهبود یافته همراه با موارد منوییِ آیکوندار
|
||||||
|
|
||||||
|
## رفع اشکالات
|
||||||
|
|
||||||
|
- Giscus: همگامسازی صحیح تم و زبان
|
||||||
|
- کارتها: رفع رندر بج در حالت RTL
|
||||||
|
- نوار ناوبری: بهبود موقعیت و تعاملات منو
|
||||||
|
|
||||||
|
## مستندات و بومیسازی
|
||||||
|
|
||||||
|
- مستندات: صفحهٔ جدیدی دربارهٔ شورتکدهای Hextra
|
||||||
|
- i18n: افزودن ترجمههای `copyCode` و `system` به `zh-cn`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**تغییرات کامل**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0
|
128
exampleSite/content/blog/v0.11.ja.md
Normal file
128
exampleSite/content/blog/v0.11.ja.md
Normal file
@@ -0,0 +1,128 @@
|
|||||||
|
---
|
||||||
|
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!
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### コールアウト刷新
|
||||||
|
|
||||||
|
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) のデザインを刷新し、テーマを問わず可読性と強調表現を向上しました。
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### アナリティクス: 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 */>}}
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### ナビバーの改善
|
||||||
|
|
||||||
|
- ナビバーのリンク項目でアイコンをサポート
|
||||||
|
- 言語スイッチャー等との兼ね合いを考慮してメニュー配置を最適化
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
特に、[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」オプションを追加
|
||||||
|

|
||||||
|
- タイポグラフィ: チェックボックス付きタスクリストのスタイル改善
|
||||||
|

|
||||||
|
- 言語スイッチャー: アイコンメニュー項目との並び順を改善
|
||||||
|
|
||||||
|
## 修正
|
||||||
|
|
||||||
|
- Giscus: テーマと言語の同期を適切に実施
|
||||||
|
- カード: RTL でのバッジ描画を修正
|
||||||
|
- ナビバー: メニュー配置とインタラクションを調整
|
||||||
|
|
||||||
|
## ドキュメントと i18n
|
||||||
|
|
||||||
|
- Docs: Hextra のショートコードをまとめた新ページ
|
||||||
|
- i18n: `zh-cn` に `copyCode` と `system` の翻訳を追加
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**完全な変更履歴**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0
|
128
exampleSite/content/blog/v0.11.md
Normal file
128
exampleSite/content/blog/v0.11.md
Normal file
@@ -0,0 +1,128 @@
|
|||||||
|
---
|
||||||
|
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 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.
|
||||||
|
|
||||||
|
<!--more-->
|
||||||
|
|
||||||
|
## Upgrade Guide
|
||||||
|
|
||||||
|
No breaking changes are expected for most sites. Update using [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hugo mod get -u github.com/imfing/hextra
|
||||||
|
```
|
||||||
|
|
||||||
|
## Highlights
|
||||||
|
|
||||||
|
- Top banner component for announcements
|
||||||
|
- Revamped callouts with clearer styles
|
||||||
|
- Umami and Matomo analytics support
|
||||||
|
- Asciinema shortcode for terminal recordings
|
||||||
|
- External link decoration option
|
||||||
|
- Breadcrumbs for single pages (non-docs, non-blogs)
|
||||||
|
- Navbar enhancements: icon link item and improved positions
|
||||||
|
- Improved badges and cards customization
|
||||||
|
- Theme toggle supports "System"
|
||||||
|
|
||||||
|
## New Features
|
||||||
|
|
||||||
|
### Top Banner
|
||||||
|
|
||||||
|
Add a site-wide, dismissible banner for announcements, launches, or status messages.
|
||||||
|
|
||||||
|
```yaml {filename="hugo.yaml"}
|
||||||
|
params:
|
||||||
|
banner:
|
||||||
|
key: "announcement"
|
||||||
|
message: Welcome!
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### Callout Revamp
|
||||||
|
|
||||||
|
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) receive a design refresh for better readability and emphasis across themes.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### Analytics: Umami and Matomo
|
||||||
|
|
||||||
|
Built-in configuration for analytics providers:
|
||||||
|
- [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
|
||||||
|
- [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})
|
||||||
|
|
||||||
|
### Asciinema Shortcode
|
||||||
|
|
||||||
|
Embed terminal recordings from [Asciinema](https://www.asciinema.org/) using the new [Asciinema shortcode]({{% relref "docs/guide/shortcodes/asciinema.md" %}}).
|
||||||
|
|
||||||
|
```md
|
||||||
|
{{</* asciinema id="123456" autoplay=true loop=true */>}}
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### Navbar Enhancements
|
||||||
|
|
||||||
|
- Support icons for link items in the navbar
|
||||||
|
- Refine menu positions to play nicely with the language switcher and other items
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
### External Link Decoration
|
||||||
|
|
||||||
|
Optionally add a subtle external-link decoration to outbound links.
|
||||||
|
|
||||||
|
```yaml {filename="hugo.yaml"}
|
||||||
|
params:
|
||||||
|
externalLinkDecoration: true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Breadcrumbs Enablement
|
||||||
|
|
||||||
|
Enable breadcrumbs on single pages (non-docs, non-blogs) by setting `breadcrumbs: true` in front matter.
|
||||||
|
|
||||||
|
```yaml {filename="content/about.md"}
|
||||||
|
---
|
||||||
|
title: About
|
||||||
|
breadcrumbs: true
|
||||||
|
---
|
||||||
|
```
|
||||||
|
|
||||||
|
### Cards and Badges Improvements
|
||||||
|
|
||||||
|
- [Cards]({{% relref "docs/guide/shortcodes/cards.md" %}}): new `tagIcon` and `tagBorder` options.
|
||||||
|
- [Badges]({{% relref "docs/guide/shortcodes/others.md" %}}): new colors and border styles.
|
||||||
|
|
||||||
|
## Quality of Life
|
||||||
|
|
||||||
|
- Theme toggle: add "System" option
|
||||||
|

|
||||||
|
- Typography: better task list styles with checkboxes
|
||||||
|

|
||||||
|
- Language switcher: improved ordering with icon menu items
|
||||||
|
|
||||||
|
## Fixes
|
||||||
|
|
||||||
|
- Giscus: sync theme and language properly
|
||||||
|
- Cards: fix badge rendering with RTL
|
||||||
|
- Navbar: refine menu positions and interactions
|
||||||
|
|
||||||
|
## Documentation & i18n
|
||||||
|
|
||||||
|
- Docs: new page covering Hextra shortcodes
|
||||||
|
- i18n: add `copyCode` and `system` translations to `zh-cn`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Full Changelog**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0
|
129
exampleSite/content/blog/v0.11.zh-cn.md
Normal file
129
exampleSite/content/blog/v0.11.zh-cn.md
Normal file
@@ -0,0 +1,129 @@
|
|||||||
|
---
|
||||||
|
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 专注于打磨使用体验并带来数个实用新组件:站点级顶部横幅、改进的提示框与徽章、更丰富的卡片、分析工具集成,以及多项导航优化。同时包含稳定性修复和文档更新。
|
||||||
|
|
||||||
|
<!--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!
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### 提示框重设计
|
||||||
|
|
||||||
|
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) 获得样式刷新,在各主题下具备更好的可读性与强调效果。
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### 分析:Umami 与 Matomo
|
||||||
|
|
||||||
|
内置以下分析平台的配置支持:
|
||||||
|
- [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
|
||||||
|
- [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})
|
||||||
|
|
||||||
|
### Asciinema 短代码
|
||||||
|
|
||||||
|
使用全新的 [Asciinema 短代码]({{% relref "docs/guide/shortcodes/asciinema.md" %}}) 嵌入 [Asciinema](https://www.asciinema.org/) 终端录屏。
|
||||||
|
|
||||||
|
```md
|
||||||
|
{{</* asciinema id="123456" autoplay=true loop=true */>}}
|
||||||
|
```
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### 导航栏增强
|
||||||
|
|
||||||
|
- 支持在导航栏链接项中使用图标
|
||||||
|
- 优化菜单的相对位置,使其与语言切换器等项协同更佳
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
值得一提的是,版本 [0.10.2](https://github.com/imfing/hextra/releases/tag/v0.10.2) 已支持在导航栏添加语言切换器与主题切换。
|
||||||
|
|
||||||
|
### 外链装饰
|
||||||
|
|
||||||
|
可选地为外部链接添加轻量的外链标识装饰。
|
||||||
|
|
||||||
|
```yaml {filename="hugo.yaml"}
|
||||||
|
params:
|
||||||
|
externalLinkDecoration: true
|
||||||
|
```
|
||||||
|
|
||||||
|
### 启用面包屑
|
||||||
|
|
||||||
|
在单页(非文档、非博客)上,通过在 Front Matter 中设置 `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」选项
|
||||||
|

|
||||||
|
- 字体排版:改进带复选框的任务列表样式
|
||||||
|

|
||||||
|
- 语言切换器:与图标菜单项的排序更合理
|
||||||
|
|
||||||
|
## 修复
|
||||||
|
|
||||||
|
- Giscus:正确同步主题与语言
|
||||||
|
- 卡片:修复 RTL 场景下的徽章渲染
|
||||||
|
- 导航栏:优化菜单位置与交互
|
||||||
|
|
||||||
|
## 文档与 i18n
|
||||||
|
|
||||||
|
- 文档:新增页面介绍 Hextra 的短代码
|
||||||
|
- i18n:为 `zh-cn` 增加 `copyCode` 与 `system` 翻译
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**完整变更日志**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0
|
||||||
|
|
@@ -102,10 +102,17 @@ To update Hextra to the [latest released version](https://github.com/imfing/hext
|
|||||||
hugo mod get -u github.com/imfing/hextra
|
hugo mod get -u github.com/imfing/hextra
|
||||||
```
|
```
|
||||||
|
|
||||||
|
If you want to try the most recent changes before the next release, update the module to the development branch directly (⚠️ may contain unstable/breaking changes):
|
||||||
|
|
||||||
|
```shell
|
||||||
|
hugo mod get -u github.com/imfing/hextra@main
|
||||||
|
```
|
||||||
|
|
||||||
See [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/#update-all-modules) for more details.
|
See [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/#update-all-modules) for more details.
|
||||||
|
|
||||||
{{% /details %}}
|
{{% /details %}}
|
||||||
|
|
||||||
|
|
||||||
### Setup Hextra as Git submodule
|
### Setup Hextra as Git submodule
|
||||||
|
|
||||||
#### Prerequisites
|
#### Prerequisites
|
||||||
|
@@ -29,16 +29,28 @@ languages:
|
|||||||
languageDirection: rtl
|
languageDirection: rtl
|
||||||
weight: 2
|
weight: 2
|
||||||
title: هگزترا
|
title: هگزترا
|
||||||
|
params:
|
||||||
|
banner:
|
||||||
|
message: |
|
||||||
|
هگزترا **v0.11** منتشر شد! 🎉 [تازهها را ببینید]({{% relref `blog/v0.11` %}})
|
||||||
ja:
|
ja:
|
||||||
languageName: 日本語
|
languageName: 日本語
|
||||||
languageCode: ja-JP
|
languageCode: ja-JP
|
||||||
weight: 3
|
weight: 3
|
||||||
title: Hextra
|
title: Hextra
|
||||||
|
params:
|
||||||
|
banner:
|
||||||
|
message: |
|
||||||
|
Hextra **v0.11** がリリースされました!🎉 [新着情報はこちら]({{% relref `blog/v0.11` %}})
|
||||||
zh-cn:
|
zh-cn:
|
||||||
languageName: 简体中文
|
languageName: 简体中文
|
||||||
languageCode: zh-CN
|
languageCode: zh-CN
|
||||||
weight: 4
|
weight: 4
|
||||||
title: Hextra
|
title: Hextra
|
||||||
|
params:
|
||||||
|
banner:
|
||||||
|
message: |
|
||||||
|
Hextra **v0.11** 发布啦!🎉 查看[更新内容]({{% relref `blog/v0.11` %}})
|
||||||
|
|
||||||
module:
|
module:
|
||||||
hugoVersion:
|
hugoVersion:
|
||||||
@@ -130,7 +142,9 @@ params:
|
|||||||
externalLinkDecoration: true
|
externalLinkDecoration: true
|
||||||
|
|
||||||
banner:
|
banner:
|
||||||
key: 'announcement-v0_10'
|
key: 'announcement-v0.11'
|
||||||
|
message: |
|
||||||
|
Hextra **v0.11** is here! 🎉 Discover [what's new]({{% relref `blog/v0.11` %}})
|
||||||
|
|
||||||
navbar:
|
navbar:
|
||||||
displayTitle: true
|
displayTitle: true
|
||||||
|
@@ -564,6 +564,7 @@
|
|||||||
"hx:px-3",
|
"hx:px-3",
|
||||||
"hx:px-4",
|
"hx:px-4",
|
||||||
"hx:px-6",
|
"hx:px-6",
|
||||||
|
"hx:px-8",
|
||||||
"hx:py-1",
|
"hx:py-1",
|
||||||
"hx:py-1.5",
|
"hx:py-1.5",
|
||||||
"hx:py-12",
|
"hx:py-12",
|
||||||
|
@@ -1,3 +0,0 @@
|
|||||||
<div>
|
|
||||||
<span>Hextra v0.10 is out 🎉 What <a href="{{ relref . `blog/v0.10` -}}">new</a>?</span>
|
|
||||||
</div>
|
|
Reference in New Issue
Block a user