mirror of
https://github.com/imfing/hextra.git
synced 2025-09-14 10:56:38 -04:00
6d0e59b16f
* 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>
129 lines
5.4 KiB
Markdown
129 lines
5.4 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:
|
|
- انتشار
|
|
---
|
|
|
|
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
|