docs(i18n): add Persian translation and support rtl `languageDirectio…

…n` (#301) * feat: add persian translation * Add Persian translation * Add fa support, languageDirection method in hugo.yaml * Add languageDirection method * Update hugo.yaml * Update baseof.html
imfing · Feb 19, 2024 · 9995617 · 9995617
1 parent 10907cd
commit 9995617
Show file tree

Hide file tree

Showing 31 changed files with 2,121 additions and 1 deletion.
diff --git a/README.fa.md b/README.fa.md
@@ -0,0 +1,47 @@
+<div align="center">
+  <h1 align="center">هگزترا</h1>
+  <p align="center">تم هیوگو مدرن، پاسخگو و دارای امکانات کامل برای ایجاد وب‌سایت‌های استاتیک زیبا.</p>
+
+نسخه‌ی نمایشی → [imfing.github.io/hextra](https://imfing.github.io/hextra/fa)
+</div>
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/5097752/263550533-c18343ca-3848-4230-b5c0-ee989d7916da.png">
+  <img alt="Hextra" src="https://user-images.githubusercontent.com/5097752/263550528-663599f9-17a1-4686-b5c4-3da233b5034d.png">
+</picture>
+
+<div align="right">
+<a href="https://github.com/imfing/hextra/actions/workflows/pages.yml"><img alt="GitHub Actions Status" src="https://github.com/imfing/hextra/actions/workflows/pages.yml/badge.svg"></a> <a href="https://app.netlify.com/sites/hugo-hextra/deploys"><img alt="Netlify Status" src="https://api.netlify.com/api/v1/badges/61d6e55a-2447-487e-b59f-c9537e5df175/deploy-status"></a>
+</div>
+
+## ویژگی‌ها
+
+- **طراحی زیبا** - با الهام از Nextra، هگزترا از Tailwind CSS برای ارائه یک طراحی مدرن که سایت شما را برجسته می‌کند، استفاده می‌کند.
+- **طراحی واکنش‌گرا و حالت تیره** - در تمام دستگاه‌ها، از تلفن همراه، تبلت تا دسکتاپ، عالی به نظر می‌رسد. حالت تیره نیز برای انطباق با شرایط مختلف روشنایی پشتیبانی می‌شود.
+- **سریع و سبک** - طراحی شده توسط Hugo، یک ایجادکننده سایت استاتیک سریع مثل رعد و برق که در یک فایل باینری قرار گرفته است، هگزترا ردپای خود را به حداقل می‌رساند. برای استفاده از آن به جاوااسکریپت یا Node.js نیازی ندارید.
+- **جستجوی متن کامل** - جستجوی متن کاملا آفلاین داخلی طراحی شده توسط FlexSearch، بدون نیاز به پیکربندی اضافی.
+- **امکانات کامل** - برای بهتر کردن محتوای شما مارک‌داون، برجسته‌کردن سینتکس، فرمول‌های ریاضی LaTeX، نمودارها و عناصر Shortcodeها را شامل میشه. فهرست مطالب، بردکرامب، صفحه‌بندی، پیمایش نوار کناری و موارد دیگر همه به صورت خودکار تولید می‌شوند.
+- **چند زبانه و سئو آماده** - سایت‌های چند زبانه با حالت چند زبانه Hugo راحت ساخته می‌شوند. پشتیبانی خارج از جعبه برای برچسب‌های سئو، Open Graph و کارت‌های توییتر گنجانده شده است.
+
+## شروع کنید
+
+### شروع سریع از طریق Template
+
+استفاده از [Hextra Starter Template](https://github.com/imfing/hextra-starter-template) ساده‌ترین روش برای راه‌اندازی سریع یک وب‌سایت جدید با تم هگزترا است. با کلیک بر روی دکمه "Use this template" در بالای صفحه مخزن شروع کنید.
+
+مخزن تم همچنین شامل یک [گردش کار گیت‌هاب Actions](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow) رای به‌کاراندازی وب‌سایت شما در گیت‌هاب Pages است.
+
+<img alt="Hextra Starter Template" src="https://user-images.githubusercontent.com/5097752/263551418-c403b9a9-a76c-47a6-8466-513d772ef0b7.jpg" width=600/>
+
+### استفاده
+
+برای اطلاعات بیشتر به بخش [مستندات](https://imfing.github.io/hextra/fa/docs) مراجعه کنید.
+
+## مشارکت کردن
+
+از مشارکت افراد جدید استقبال می‌کنیم.
+ برای شروع، [راهنمای مشارکت](.github/CONTRIBUTING.md) را بررسی کنید.
+
+## مجوز
+
+[مجوز MIT](./LICENSE)
diff --git a/exampleSite/content/_index.fa.md b/exampleSite/content/_index.fa.md
@@ -0,0 +1,76 @@
+---
+title: تم هگزترا
+layout: hextra-home
+---
+
+{{< hextra/hero-badge >}}
+  <div class="w-2 h-2 rounded-full bg-primary-400"></div>
+  <span>آزاد، متن‌باز</span>
+  {{< icon name="arrow-circle-left" attributes="height=14" >}}
+{{< /hextra/hero-badge >}}
+
+<div class="mt-6 mb-6">
+{{< hextra/hero-headline >}}
+  ساخت وب‌سایت‌های مدرن &nbsp;<br class="sm:block hidden" />با مارک‌داون و هیوگو
+{{< /hextra/hero-headline >}}
+</div>
+
+<div class="mb-12">
+{{< hextra/hero-subtitle >}}
+  تم هیوگو سریع و دارای امکانات کامل&nbsp;<br class="sm:block hidden" />برای ایجاد وب‌سایت‌های استاتیک زیبا
+{{< /hextra/hero-subtitle >}}
+</div>
+
+<div class="mb-6">
+{{< hextra/hero-button text="شروع کنید" link="docs" >}}
+</div>
+
+<div class="mt-6"></div>
+
+{{< hextra/feature-grid >}}
+  {{< hextra/feature-card
+    title="سریع و با امکانات کامل"
+    subtitle="ساده و آسان برای استفاده، در عین حال قدرتمند و غنی از ویژگی‌ها متنوع."
+    class="aspect-auto md:aspect-[1.1/1] max-md:min-h-[340px]"
+    image="/images/hextra-doc.webp"
+    imageClass="top-[40%] left-[24px] w-[180%] sm:w-[110%] dark:opacity-80"
+    style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));"
+  >}}
+  {{< hextra/feature-card
+    title="مارک‌داون تنها چیزی است که شما نیاز دارید"
+    subtitle="فقط با مارک‌داون بنویسید. تکمیل و کامل با کامپوننت‌های کد کوتاه."
+    class="aspect-auto md:aspect-[1.1/1] max-lg:min-h-[340px]"
+    image="/images/hextra-markdown.webp"
+    imageClass="top-[40%] left-[36px] w-[180%] sm:w-[110%] dark:opacity-80"
+    style="background: radial-gradient(ellipse at 50% 80%,rgba(142,53,74,0.15),hsla(0,0%,100%,0));"
+  >}}
+  {{< hextra/feature-card
+    title="جستجوی کامل متن"
+    subtitle="جستجوی متن کامل داخلی با FlexSearch، بدون نیاز به نصب موارد اضافی."
+    class="aspect-auto md:aspect-[1.1/1] max-md:min-h-[340px]"
+    image="/images/hextra-search.webp"
+    imageClass="top-[40%] left-[36px] w-[110%] sm:w-[110%] dark:opacity-80"
+    style="background: radial-gradient(ellipse at 50% 80%,rgba(221,210,59,0.15),hsla(0,0%,100%,0));"
+  >}}
+  {{< hextra/feature-card
+    title="سبک مانند یک پر"
+    subtitle="برای استفاده از هگزترا به هیچ وابستگی یا Node.js نیاز نیست. با پشتیبانی از هیوگو، یکی از سریع‌ترین تولیدکنندگان سایت استاتیک، سایت شما را تنها در چند ثانیه با یک باینری می‌سازد."
+  >}}
+  {{< hextra/feature-card
+    title=" واکنش‌گرا با حالت تیره"
+    subtitle="در اندازه‌های مختلف صفحه نمایش عالی به نظر می‌رسد. پشتیبانی از حالت تیره داخلی، با تغییر خودکار براساس اولویت سیستم کاربر."
+  >}}
+  {{< hextra/feature-card
+    title="ساخت و میزبانی رایگان"
+    subtitle="با گیت‌هاب Actions بسازید و به صورت رایگان در گیت‌هاب Pages میزبانی کنید. یا می‌توانید آن را در هر سرویس میزبانی استاتیک میزبانی کنید."
+  >}}
+  {{< hextra/feature-card
+    title="چند زبانه آسان"
+    subtitle="فقط با افزودن پسوند محلی به پرونده مارک‌داون صفحات وب‌سایت چند زبانه ایجاد کنید. افزودن پشتیبانی i18n به سایت شما بصری است."
+  >}}
+  {{< hextra/feature-card
+    title="و خیلی بیشتر..."
+    icon="sparkles"
+    subtitle="برجسته‌کردن سینتکس / فهرست مطالب / سئو / RSS / LaTeX / Mermaid / سفارشی‌سازی / و موارد دیگر…"
+  >}}
+{{< /hextra/feature-grid >}}
diff --git a/exampleSite/content/about/index.fa.md b/exampleSite/content/about/index.fa.md
@@ -0,0 +1,22 @@
+---
+title: درباره ما
+toc: false
+---
+
+هگزترا به گونه‌ای طراحی شده است که یک موضوع ساده، سریع و انعطاف پذیر برای ساخت وب‌سایت‌های استاتیک مدرن باشد. این به ویژه برای وب‌سایت‌های مستندسازی مناسب است اما می‌تواند برای انواع مختلف سایت‌ها مانند وبلاگ‌ها، نمونه‌کار و موارد دیگر نیز استفاده شود.
+
+Hugo مانند Jekyll، یک ایجادکننده سایت استاتیک است. چیزی که Hugo را متمایز می‌کند این است که یک باینری واحد است و نصب و اجرای آن بر روی پلتفرم‌های مختلف را آسان می‌کند. همچنین بسیار سریع و قابل اعتماد است و می‌تواند یک سایت را با هزاران صفحه در میلی‌ثانیه ارائه دهد.
+
+هگزترا با ذهنیتی ساخته شده است که بر داشتن حداقل ردپا متمرکز شده است. برای شروع، هیچ وابستگی اضافی مانند بسته‌های Node.js لازم نیست. تنها چیزی که نیاز دارید یک پرونده پیکربندی YAML به همراه محتوای مارک‌داون شما است. بنابراین، شما می‌توانید به جای تنظیم ابزار، روی نوشتن محتوای با کیفیت تمرکز کنید.
+
+## اعتبار
+
+ترجمه فارسی مستندات توسط [گودرز جعفری](https://goudarzjafari.com/) انجام شده است.
+
+هگزترا بدون ابزار و الهامات زیر ساخته نمی‌شود:
+
+- [هیوگو](https://gohugo.io/)
+- [Tailwind CSS](https://tailwindcss.com/)
+- [Heroicons](https://heroicons.com/)
+- [Nextra](https://nextra.vercel.app/)
+- [Next.js](https://nextjs.org/)
diff --git a/exampleSite/content/blog/_index.fa.md b/exampleSite/content/blog/_index.fa.md
@@ -0,0 +1,10 @@
+---
+title: "وبلاگ"
+---
+
+<div style="text-align: center; margin-top: 1em;">
+{{< hextra/hero-badge link="index.xml" >}}
+  <span>خوراک RSS</span>
+  {{< icon name="rss" attributes="height=14" >}}
+{{< /hextra/hero-badge >}}
+</div>
diff --git a/exampleSite/content/blog/markdown.fa.md b/exampleSite/content/blog/markdown.fa.md
@@ -0,0 +1,157 @@
+---
+title: راهنمای استفاده سینتکس مارک‌داون
+date: 2020-01-01
+authors:
+  - name: imfing
+    link: https://github.com/imfing
+    image: https://github.com/imfing.png
+  - name: Octocat
+    link: https://github.com/octocat
+    image: https://github.com/octocat.png
+tags:
+  - Markdown
+  - مثال
+  - راهنمای
+excludeSearch: true
+---
+
+این مقاله نمونه‌ای از سینتکس ابتدایی مارک‌داون را آموزش می‌دهد، که می‌توانید در پرونده‌های محتوای Hugo استفاده کنید.
+<!--more-->
+
+## سینتکس ابتدایی
+
+### سرتیترها
+
+```
+# سرتیتر ۱
+## سرتیتر ۲
+### سرتیتر ۳
+#### سرتیتر ۴
+##### سرتیتر ۵
+###### سرتیتر ۶
+```
+
+## سرتیتر ۲
+### سرتیتر ۳
+#### سرتیتر ۴
+##### سرتیتر ۵
+###### سرتیتر ۶
+
+### تاکید
+
+```text
+*این متن کج خواهد بود*
+_این متن هم کج خواهد بود_
+
+**این متن توپر خواهد بود**
+__این متن هم توپر خواهد بود__
+
+_شما **می‌توانید** آنها را ترکیب کنید_
+```
+
+*این متن کج خواهد بود*
+
+_این متن هم کج خواهد بود_
+
+**این متن توپر خواهد بود**
+
+__این متن هم توپر خواهد بود__
+
+_شما **می‌توانید** آنها را ترکیب کنید_
+
+### فهرست‌ها
+
+#### مرتب نشده
+
+```
+* مورد ۱
+* مورد ۲
+  * مورد ۱الف
+  * مورد ۲ب
+```
+
+* مورد ۱
+* مورد ۲
+  * مورد ۱الف
+  * مورد ۲ب
+
+#### مرتب شده
+
+```
+۱. مورد ۱
+۲. مورد ۲
+۳. مورد ۳
+   ۱. مورد ۳الف
+   ۲. مورد ۳ب
+```
+
+### عکس‌ها
+
+```markdown
+![آرم گیت‌هاب](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)
+```
+
+![آرم گیت‌هاب](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)
+
+### پیوندها
+
+```markdown
+[هیوگو](https://gohugo.io)
+```
+
+[هیوگو](https://gohugo.io)
+
+### بلوک نقل‌قول
+
+```markdown
+همانطور که نیوتن گفت:
+
+> اگر فاصله دورتری را دیده‌ام با ایستادن بر شانه‌های غول‌ها بوده است.
+```
+
+> اگر فاصله دورتری را دیده‌ام با ایستادن بر شانه‌های غول‌ها بوده است.
+
+### کد درون‌خطی
+
+```markdown
+`کد` درون‌خطی دارای `بک‌-تیک در اطراف` خود است.
+```
+
+`کد` درون‌خطی دارای `بک‌-تیک در اطراف` خود است.
+
+### بلوک‌های کد
+
+#### برجسته‌کردن سینتکس(Syntax)
+
+````markdown
+```go
+func main() {
+    fmt.Println("Hello World")
+}
+```
+````
+
+```go
+func main() {
+    fmt.Println("Hello World")
+}
+```
+
+### جدول‌ها
+
+```markdown
+| عنوان    | توضیحات |
+| --------- | ----------- |
+| سرتیتر    | عنوان       |
+| پاراگراف | متن        |
+```
+
+| عنوان    | توضیحات |
+| --------- | ----------- |
+| سرتیتر    | عنوان       |
+| پاراگراف | متن        |
+
+## منابع
+
+- [سینتکس مارک‌داون](https://www.markdownguide.org/basic-syntax/)
+- [مارک‌داون هیوگو](https://gohugo.io/content-management/formats/#markdown)
diff --git a/exampleSite/content/docs/_index.fa.md b/exampleSite/content/docs/_index.fa.md
@@ -0,0 +1,41 @@
+---
+linkTitle: "مستندات"
+title: معرفی
+---
+
+👋 سلام! به مستندات هگزترا خوش آمدید!
+
+<!--more-->
+
+## هگزترا چیه؟
+
+هگزترا یک تم [Hugo][hugo] مدرن و سریع است که با [Tailwind CSS][tailwind-css] ساخته شده است.
+ طراحی شده برای ساخت وب‌سایت‌های زیبا برای مستندات، وبلاگ‌ها و وب‌سایت‌ها، ویژگی‌های خارج از جعبه و انعطاف‌پذیری را برای پاسخگویی نیازهای مختلف فراهم می‌کند.
+
+## ویژگی‌ها
+
+- **طراحی زیبا** - با الهام از Nextra، هگزترا از Tailwind CSS برای ارائه یک طراحی مدرن که سایت شما را برجسته می‌کند، استفاده می‌کند.
+- **طراحی واکنش‌گرا و حالت تیره** - در تمام دستگاه‌ها، از تلفن همراه، تبلت تا دسکتاپ، عالی به نظر می‌رسد. حالت تیره نیز برای انطباق با شرایط مختلف روشنایی پشتیبانی می‌شود.
+- **سریع و سبک** - طراحی شده توسط Hugo، یک ایجادکننده سایت استاتیک سریع مثل رعد و برق که در یک فایل باینری قرار گرفته است، هگزترا ردپای خود را به حداقل می‌رساند. برای استفاده از آن به جاوااسکریپت یا Node.js نیازی ندارید.
+- **جستجوی متن کامل** - جستجوی متن کاملا آفلاین داخلی طراحی شده توسط FlexSearch، بدون نیاز به پیکربندی اضافی.
+- **امکانات کامل** - برای بهتر کردن محتوای شما مارک‌داون، برجسته‌کردن سینتکس، فرمول‌های ریاضی LaTeX، نمودارها و عناصر Shortcodeها را شامل میشه. فهرست مطالب، بردکرامب، صفحه‌بندی، پیمایش نوار کناری و موارد دیگر همه به صورت خودکار تولید می‌شوند.
+- **چند زبانه و سئو آماده** - سایت‌های چند زبانه با حالت چند زبانه Hugo راحت ساخته می‌شوند. پشتیبانی خارج از جعبه برای برچسب‌های سئو، Open Graph و کارت‌های توییتر گنجانده شده است.
+
+## سوال یا بازخورد؟
+
+{{< callout emoji="❓" >}}
+  هگزترا هنوز در حال توسعه است.
+ سوال یا بازخوردی دارید؟ با خیال راحت [یک موضوع را باز کنید](https://github.com/imfing/hextra/issues)!
+{{< /callout >}}
+
+## بعدی
+
+برای شروع کردن به بخش زیر مراجعه کنید:
+
+{{< cards >}}
+  {{< card link="getting-started" title="شروع کنید" icon="document-text" subtitle="یادگیری نحوه ایجاد وب‌سایت با استفاده از هگزترا" >}}
+{{< /cards >}}
+
+[hugo]: https://gohugo.io/
+[flex-search]: https://github.com/nextapps-de/flexsearch
+[tailwind-css]: https://tailwindcss.com/
diff --git a/exampleSite/content/docs/advanced/_index.fa.md b/exampleSite/content/docs/advanced/_index.fa.md
@@ -0,0 +1,16 @@
+---
+linkTitle: پیشرفته
+title: موضوعات پیشرفته
+prev: /docs/guide/shortcodes/steps
+next: /docs/advanced/multi-language
+---
+
+این بخش برخی از موضوعات پیشرفته تم را پوشش می‌دهد.
+
+<!--more-->
+
+{{< cards >}}
+  {{< card link="multi-language" title="چند زبانه" icon="translate" >}}
+  {{< card link="customization" title="سفارشی‌سازی" icon="pencil" >}}
+  {{< card link="comments" title="سیستم نظردهی" icon="chat-alt" >}}
+{{< /cards >}}