Merge branch 'main' of github.com:welpo/tabi

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/blog/markdown/index.ca.md

@@ -1,7 +1,7 @@
 +++
 title = "Exemples de Markdown"
 date = 2023-01-31
-updated = 2024-11-23
+updated = 2025-02-21
 description = "Aquesta publicació mostra alguns exemples de format en Markdown, incloent-hi una taula, blocs de codi i etiquetes, citacions, taules i notes a peu de pàgina."
 
 [taxonomies]
@@ -105,4 +105,6 @@ A Rust, declares una variable mutable amb `let mut x = 5;`, mentre que a Python,
 >
 > — Mercè Rodoreda, La plaça del Diamant
 
+---
+
 [^1]: I aquí tens un exemple de nota a peu de pàgina!

content/blog/markdown/index.es.md

@@ -1,7 +1,7 @@
 +++
 title = "Ejemplos de Markdown"
 date = 2023-01-31
-updated = 2024-11-23
+updated = 2025-02-21
 description = "Esta publicación muestra algunos ejemplos de formato Markdown, incluyendo una tabla, bloques de código y etiquetas, citas, tablas y notas al pie de página."
 
 [taxonomies]
@@ -105,4 +105,6 @@ En Rust, declaras una variable mutable con `let mut x = 5;`, mientras que en Pyt
 >
 > — Miguel de Unamuno, Niebla
 
+---
+
 [^1]: ¡Y aquí tienes un ejemplo de una nota al pie de página!

content/blog/markdown/index.md

@@ -1,7 +1,7 @@
 +++
 title = "Markdown examples"
 date = 2023-01-31
-updated = 2024-11-23
+updated = 2025-02-21
 description = "This post showcases some examples of Markdown formatting, including a table, code blocks and tags, quotes, tables, and footnotes."
 
 [taxonomies]
@@ -105,4 +105,6 @@ In Rust, you declare a mutable variable with `let mut x = 5;`, whereas in Python
 >
 > — Charlie Kaufman, Synecdoche, New York
 
+---
+
 [^1]: And here's an example of a footnote!