🌐 docs(demo): basic Arabic translation (#390)

Signed-off-by: Awiteb <[email protected]>
Co-authored-by: welpo <[email protected]>

config.toml

@@ -63,6 +63,13 @@ description = "tabi és un tema accessible per a Zola amb cerca, suport multilin
 generate_feeds = true
 taxonomies = [{name = "tags", feed = true}]
 
+[languages.ar]
+title = "~/تابي"
+description = "تابي هو قالب Zola سريع وحديث مع دعم متعدد اللغات و JavaScript اختياري ودرجة Lighthouse مثالية."
+generate_feeds = true
+taxonomies = [{name = "tags", feed = true}]
+build_search_index = false
+
 [extra]
 # Check out the documentation (or the comments below) to learn how to customise tabi:
 # https://welpo.github.io/tabi/blog/mastering-tabi-settings/

content/_index.ar.md

@@ -0,0 +1,18 @@
++++
+title = "أخر التدوينات"
+sort_by = "date"
+template = "section.html"
+
+[extra]
+header = {title = "اهلاً انا تابي~", img = "img/main.webp", img_alt = "أوسكار فرنانديز, كاتب السمة" }
+section_path = "blog/_index.ar.md"
+max_posts = 4
+projects_path = "projects/_index.ar.md"
+max_projects = 3
+show_projects_first = false
+social_media_card = "ar.jpg"
++++
+
+تابي هو قالب Zola سريع وعصري. يهدف ليكون صفحة ومدونة شخصية. يتميز بتقييم مثالي في Lighthouse، وتصميم متجاوب، وسمات داكنة وفاتحة، وشِفرات قصيرة مخصصة، والعديد من المميزات الأخرى.
+
+> ملاحظة: هذه الصفحة هي عرض توضيحي لدعم اللغة العربية في تابي. للحصول على التوثيق الكامل، يرجى الرجوع إلى [النسخة الإنجليزية](@/_index.md).

content/archive/_index.ar.md

@@ -0,0 +1,4 @@
++++
+title = "الأرشيف"
+template = "archive.html"
++++

content/blog/_index.ar.md

@@ -0,0 +1,10 @@
++++
+paginate_by = 5
+title = "التدوينات"
+sort_by = "date"
+template = "section.html"
+insert_anchor_links = "right"
+
+[extra]
+show_previous_next_article_links = true
++++

content/blog/markdown/index.ar.md

@@ -0,0 +1,93 @@
++++
+title = "أمثلة على ماركداون"
+date = 2023-01-31
+updated = 2023-09-01
+description = "تعرض هذه التدوينة بعض الأمثلة على تنسيق ماركداون، بما في ذلك الجداول، والشِفرات البرمجية والوسوم، والاقتباسات، والهوامش."
+
+[taxonomies]
+tags = ["ماركداون", "توضيحي"]
+
+[extra]
+katex = true
++++
+
+{% admonition(type="note", title="ملاحظة عن الاتجاه", icon="info") %}
+يدعم تابي الكتابة من اليمين إلى اليسار (RTL) بشكل كامل، مما يجعله مثالياً للغة العربية.
+
+الشفرات البرمجية والمعادلات الرياضية تبقى من اليسار إلى اليمين كما هو متوقع.
+{% end %}
+
+## الرياضيات مع $\KaTeX$
+
+{{ aside(text="تأتي كلمة *ماركداون* من الإنجليزية *Markdown*، وهي لغة ترميز بسيطة صممها جون غروبر وآرون سوارتز في عام 2004.") }}
+
+[$\KaTeX$](https://katex.org/) هي مكتبة سريعة وسهلة الاستخدام تمكن من عرض الرموز الرياضية باستخدام صيغة LaTeX.
+
+يمكنك استخدام $\KaTeX$ **ضمن السطر** عن طريق وضع التعبير بين `$` أو بين `\\(` و `\\)`.
+
+على سبيل المثال، `$ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $` سيظهر هكذا: $ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $
+
+لعرض التعبير **في سطر منفصل ومتوسط**، ضعه بين `$$` أو بين `\\[` و `\\]`.
+
+على سبيل المثال، `\\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]` سيظهر هكذا: \\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]
+
+لتفعيل $\KaTeX$ لتدوينة أو قسم كامل، أضف `katex = true` داخل قسم `[extra]` في المقدمة. على سبيل المثال:
+
+```toml,hl_lines=5-6
+title = "تجربة KaTeX"
+date = 2002-11-30
+
+[extra]
+katex = true
+```
+
+يمكنك أيضاً تفعيله بشكل عام عن طريق تعيين `katex = true` في قسم `[extra]` في ملف `config.toml` الخاص بك.
+
+لتحسين الأداء والأمان، يتم استضافة ملفات جافا سكريبت و CSS والخطوط الخاصة بـ $\KaTeX$ محلياً.
+
+**ملاحظة**: بعد تفعيل $\KaTeX$، إذا أردت استخدام \$ بدون عرض تعبير رياضي، استخدم شرطة مائلة للخلف قبلها: `\$`.
+
+## جدول
+
+هذا مثال على جدول[^1]. تتغير ألوانه حسب سمة التدوينة.
+
+| الرمز  | العنصر   | العدد الذري |
+|--------|----------|--------------|
+| H      | هيدروجين| 1            |
+| C      | كربون    | 6            |
+| Fe     | حديد     | 26           |
+| Au     | ذهب      | 79           |
+
+## الشِفرات البرمجية
+
+```rust
+fn main() {
+    println!("مرحباً يا عالم") -> ();
+}
+```
+
+### من اليمين إلى اليسار
+{% force_text_direction(direction="rtl") %}
+
+```
+نص قل_مرحباً(نص الاسم) {
+    أرجع تنسيق("مرحباً {الاسم}")؛
+}
+```
+
+{% end %}
+
+## سطر برمجي
+
+في Rust، تعلن عن متغير متغير باستخدام `let mut x = 5`، بينما في Python، تستخدم ببساطة `x = 5`. وبالمثل، لطباعة قيمة في Rust، تستخدم `println!("القيمة: {}", x)`، ولكن في Python، الأمر بسيط مثل `print(f"القيمة: {x}")`
+وفي لغة البرمجة العربية هو `مهنة = "صائد فئران"`
+
+## اقتباس
+
+> وابِطُكَ قابِضِ الأَرواحِ يَرمي   ...   بِسَهمِ المَوتِ مِن تَحتِ الثِيابِ
+>
+> شَرابُكَ في السَرابِ إِذا عَطِشنا   ...   وَخُبزُكَ عِندَ مُنقَطِعِ التُرابِ
+>
+> — أبو الشمقمق، العصر العباسي
+
+[^1]: وهذا مثال على الهامش!

content/pages/_index.ar.md

@@ -0,0 +1,7 @@
++++
+render = false
+insert_anchor_links = "right"
+
+[extra]
+hide_from_feed = true
++++

content/pages/about/index.ar.md

@@ -0,0 +1,40 @@
++++
+title = "عني"
+template = "info-page.html"
+path = "/ar/about"
+
+[extra]
+quick_navigation_buttons = true
+social_media_card = "social_cards/about.ar.jpg"
++++
+
+مرحبًا بكم في العرض التقديمي ل[**تابي**]، وهو قالب لـ[Zola]، مولد المواقع الثابتة السريع.
+
+**تابي** هو من ابتكار أوسكار فرنانديز ([welpo] على GitHub)، وقد صُمم في البداية لموقعه الشخصي [osc.garden]. هو قالب بشكل حديث غني بالميزات يوفر إعدادات افتراضية منطقية وآمنة.
+
+يمكنك العثور على وثائق تشرح طريقة إستخدام **تابي** في [المدونة] و[الأرشيف]، سوف تجد بهم مقالات تشرح القالب وتقدم لك نظرة عامة حوله.
+
+## الميزات
+
+يركز **تابي** على الاداء ويدعم [تعدد اللغات] أي انه يمكن لمدونتك دعم أكثر من لغة، ويمكنك [تخصيص مظهرها]، ويمكنك [تفعيل التعليقات بها] أي السماح للأخرين بالتعليق على منشوراتك. و **تابي** لا يجبر مدونتك على إستخدام جافاسكربت، حيث انها [إختيارية] ولكنك سوف تفقد المميزات التي تحتاج إليها.
+
+## المساهمة
+
+نحن نقدر المساهمات! نرحب بالتبليغ على الأخطاء، وتحسينات الترجمة أو الوثائق (بغض النظر عن حجمها)، واقتراحات الميزات... تحقق من [إرشادات المساهمة] لمعرفة كيفية المساعدة. شكرًا لك!
+
+## الترخيص
+
+الكود متاح بموجب [رخصة MIT].
+
+[**تابي**]: https://github.com/welpo/tabi
+[Zola]: https://www.getzola.org
+[welpo]: https://github.com/welpo
+[osc.garden]: https://osc.garden
+[المدونة]: https://welpo.github.io/tabi/blog
+[الأرشيف]: https://welpo.github.io/tabi/archive
+[تعدد اللغات]: https://welpo.github.io/tabi/blog/faq-languages
+[تخصيص مظهرها]: https://welpo.github.io/tabi/blog/customise-tabi
+[تفعيل التعليقات بها]: https://welpo.github.io/tabi/blog/comments
+[إختيارية]: https://welpo.github.io/tabi/blog/javascript
+[إرشادات المساهمة]: https://github.com/welpo/tabi/blob/main/CONTRIBUTING.md
+[رخصة MIT]: https://choosealicense.com/licenses/mit

content/pages/privacy/index.ar.md

@@ -0,0 +1,95 @@
++++
+title = "سياسة الخصوصية"
+path = "/ar/privacy"
+date = 2023-10-31
+updated = 2024-05-12
++++
+
+هذه السياسة توضح كيف نقوم بجمع ومعالجة بياناتك على هذا الموقع.
+
+{{ toc() }}
+
+## ما البيانات التي نجمعها؟
+
+### التصفح العام {#what-general}
+
+أثناء تصفح الموقع، لا يتم جمع أي معلومات شخصية.
+
+### التعليقات {#what-comments}
+
+نحن لا نجمع أي بيانات عند إرسال تعليق على تدوينة، لكن GitHub يجمع البيانات لتوفير الخدمة، حيث انه يتم توفيرها من خلاله.
+
+### التحليلات {#what-analytics}
+
+لتحسين الموقع، يتم جمع البيانات غير الشخصية التالية:
+
+- **المرجع**: المصدر الذي قادك إلى هذا الموقع.
+- **الرابط المطلوب**: الصفحة المحددة التي قمت بزيارتها.
+- **وكيل المستخدم**: يحدد المتصفح ونظام التشغيل الذي تستخدمه (مثل "Safari 17.0، Mac OS X").
+- **اسم البلد**: البلد الذي زرت الموقع منه، يتم تحديده بواسطة عنوان IP الخاص بك.
+- **حجم الشاشة**: أبعاد شاشة جهازك.
+- **الوقت**: الوقت الذي وصلت فيه إلى الموقع.
+- **جلسة التصفح**: رمز تعريف مؤقت يتم إنشاؤه من عنوان IP الخاص بك، ومعلومات المتصفح، ورقم عشوائي. يُستخدم هذا للتعرف على جلسة التصفح لمدة 8 ساعات. بعد ذلك، يتم حذف الرمز من الذاكرة ولا يُخزن في أي مكان.
+
+نحن لا نتتبع الزوار عبر الجلسات، ولا نتتبع مدة بقائك في الموقع أو أين تذهب بعد مغادرتك.
+
+## كيف نجمع هذه البيانات؟
+
+### التعليقات {#how-comments}
+
+يتم جمع البيانات المرتبطة بالتعليقات باستخدام [Giscus](https://giscus.app/)، وهي منصة تمكن من إضافة التعليقات، المبنية على GitHub.
+
+### التحليلات {#how-analytics}
+
+يتم جمع البيانات غير الشخصية باستخدام نسخة مستضافة ذاتيًا من [GoatCounter](https://www.goatcounter.com/)، وهي منصة مفتوحة المصدر لتحليلات الويب تركز على الخصوصية.
+
+## كيف سنستخدم البيانات؟
+
+تُستخدم البيانات المرسلة إلى GitHub لعرض تعليقك على الموقع.
+
+تُستخدم البيانات غير الشخصية لإنشاء إحصائيات حول الموقع، مثل عدد الزوار يوميًا، أو الصفحات والمراجع الأكثر شعبية. تُستخدم هذه البيانات لتحسين هذا الموقع التجريبي وقالب تابي. يمكنك رؤية الإحصائيات الناتجة عن هذه البيانات على [صفحة الإحصائيات العامة](https://tabi-stats.osc.garden/).
+
+جميع البيانات المجمعة متاحة للجمهور، سواء في شكل تعليقات أو إحصائيات.
+
+نحن لا نستخدم البيانات لأي غرض آخر.
+
+## كيف نقوم بتخزين البيانات؟
+
+بيانات التعليقات لا تُخزن بواسطة Giscus، كما هو موضح في [سياسة الخصوصية الخاصة بهم](https://github.com/giscus/giscus/blob/main/PRIVACY-POLICY.md#what-data-do-we-collect). يتم تخزين البيانات على خوادم GitHub. راجع [سياسة الخصوصية الخاصة بGitHub](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement).
+
+يتم تخزين بيانات التحليلات على خادم مستضاف بواسطة [Vultr](https://www.vultr.com/). يقع الخادم في باريس، فرنسا.
+
+## كم من الوقت سنقوم بتخزين البيانات؟
+
+تُخزن التعليقات إلى أجل غير مسمى، أو حتى تطلب حذفها.
+
+تُخزن باقي البيانات إلى أجل غير مسمى.
+
+## ما هي حقوقك في حماية البيانات؟
+
+اعتمادًا على المعالجة والأساس القانوني، هناك عدد من الخيارات المتاحة لك للحفاظ على السيطرة على بياناتك الشخصية:
+
+- حق الوصول إلى بياناتك
+- حق تعديل بياناتك
+- حق الاعتراض على معالجة بياناتك الشخصية
+- حق تقييد معالجة بياناتك
+- حق حذف بياناتك
+- حق سحب موافقتك
+
+إذا قدمت طلبًا، لدينا شهر واحد للرد عليك. إذا كنت ترغب في ممارسة أي من هذه الحقوق، يرجى الاتصال بنا باستخدام أيقونة البريد الإلكتروني في تذييل الموقع.
+
+## الكوكيز
+
+الموقع لا يستخدم الكوكيز.
+
+## سياسات الخصوصية لمواقع أخرى
+
+يحتوي هذا الموقع على روابط لمواقع أخرى. تنطبق سياسة الخصوصية هذه فقط على هذا الموقع، لذا إذا قمت بالنقر على رابط لموقع آخر، يجب عليك قراءة سياسة الخصوصية الخاصة بهم.
+
+## التغييرات على سياسة الخصوصية
+
+نحن نراجع هذه السياسة بانتظام ونضع أي تحديثات على هذه الصفحة. يمكنك التحقق من تاريخ تحديث هذه السياسة، بالإضافة إلى سجل التغييرات تحت عنوان الصفحة.
+
+## كيف تتواصل معنا
+
+إذا كانت لديك أي أسئلة حول سياسة الخصوصية هذه، أو البيانات التي نحتفظ بها عنك، أو إذا كنت ترغب في ممارسة أحد حقوق حماية البيانات الخاصة بك، فلا تتردد في الاتصال بنا باستخدام أيقونة البريد الإلكتروني في تذييل الموقع.

content/projects/_index.ar.md

@@ -0,0 +1,10 @@
++++
+title = "مشاريعي"
+sort_by = "weight"
+template = "cards.html"
+insert_anchor_links = "right"
+
+[extra]
+show_reading_time = false
+quick_navigation_buttons = true
++++

content/projects/tabi/index.ar.md

@@ -0,0 +1,46 @@
++++
+title = "تابي"
+description = "سمة زولا عصرية غنية بالمميزات مع دعم متميز لتعدد اللغات"
+weight = 40
+
+[taxonomies]
+tags = ["ويب", "جافا سكريبت"]
+
+[extra]
+local_image = "projects/tabi/tabi.webp"
++++
+
+[**تابي**](https://github.com/welpo/tabi) هي سمة عصرية غنية بالمميزات لـ[Zola](https://www.getzola.org/)، منشئ مواقع ثابتة سريع.
+
+{{ full_width_image(src="https://cdn.jsdelivr.net/gh/welpo/tabi@main/light_dark_screenshot.png", alt="تابي في الوضعين الفاتح والداكن") }}
+
+#### [عرض على GitHub](https://github.com/welpo/tabi) • [عرض توضيحي وتوثيق](https://welpo.github.io/tabi/) {.centered-text}
+
+## المميزات
+
+- دعم كامل [للغة العربية والكتابة من اليمين إلى اليسار](https://welpo.github.io/tabi/blog/faq-languages/#how-do-i-set-a-default-language-for-my-site)
+- [دعم للسلاسل](https://welpo.github.io/tabi/blog/series/) لإنشاء محتوى متسلسل مثل الدروس والدورات
+- سمتان داكنة وفاتحة، مع التبديل التلقائي حسب إعدادات النظام
+- [دعم التعليقات](https://welpo.github.io/tabi/blog/comments/) باستخدام giscus أو utterances أو Hyvor Talk أو Isso
+- [دعم KaTeX](https://katex.org/) للمعادلات الرياضية
+- [دعم Mermaid](https://welpo.github.io/tabi/blog/shortcodes/#mermaid-diagrams) لإنشاء المخططات
+- [بحث محلي](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#search) متعدد اللغات
+- تصميم متجاوب يعمل على جميع الأجهزة
+- [صفحة مشاريع](https://welpo.github.io/tabi/projects/) و[أرشيف](https://welpo.github.io/tabi/archive/)
+
+## ممارسات التطوير
+
+- **[الالتزامات التقليدية](https://www.conventionalcommits.org) و[Gitmoji](https://gitmoji.dev/)**: تتبع رسائل الالتزام تنسيقات موحدة لتحسين القراءة
+- **تتبع المشكلات**: لكل خطأ أو ميزة جديدة تذكرة مخصصة، مرتبطة بأي التزامات برمجية وطلبات سحب ذات صلة
+- **تعليقات شاملة**: يتم توثيق التذاكر بالصور ومقاطع الفيديو والأوصاف التفصيلية لتسهيل التواصل الفعال وحل المشكلات
+- **الإحالات المرجعية**: نربط جميع التذاكر بالتزامات الشفرة وطلبات السحب أو المشكلات ذات الصلة للتتبع الكامل
+
+## تطور المشروع
+
+تم تصميم **تابي** في الأصل لموقعي الشخصي، [osc.garden](https://osc.garden). على الرغم من أصولها للاستخدام الشخصي، تم تنفيذ أفضل الممارسات منذ البداية لضمان الجودة وقابلية الصيانة. ومنذ ذلك الحين نمت السمة لتجذب مجتمعًا نشطًا من المساهمين على GitHub.
+
+## ابدأ رحلة الكتابة مع تابي
+
+لديك شيء تريد قوله. ربما عن تجربتك في تعلم لغة جديدة، أو عن رحلتك في استكشاف [فن الفلامنكو](https://en.wikipedia.org/wiki/Palo_(flamenco))، أو عن كيف نجحت في حل مشكلة برمجية في مشروع مفتوح المصدر.
+
+**تابي** توفر الأساس المثالي لمساحة كتابتك، مما يتيح لك التركيز على كلماتك بينما يهتم Zola وتابي بالجانب التقني. ادخل عالم التدوين مع نظام يجعل كل تدوينة متعة في الكتابة والقراءة. صوتك له قيمة—شاركه مع العالم.