chore(docs): rename exampleSite to docs and create examples (#813)

* chore(docs): rename `exampleSite` to `docs` and create `examples`

* chore(build): update build script to support new version format and source directories; add v0.10 to documentation menu

docs/content/blog/v0.11.fa.md

@@ -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!
+```
+
+![بنر بالایی](https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d)
+
+### بازطراحی Callout
+
+[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) برای خوانایی بهتر و تأکید مناسب در تمام تم‌ها بازطراحی شده است.
+
+![بازطراحی 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
+- نوار ناوبری: بهبود موقعیت و تعاملات منو
+
+## مستندات و بومی‌سازی
+
+- مستندات: صفحهٔ جدیدی دربارهٔ شورت‌کدهای Hextra
+- i18n: افزودن ترجمه‌های `copyCode` و `system` به `zh-cn`
+
+---
+
+**تغییرات کامل**: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0