forked from deepStateMirrors/tabi
93 lines
4.2 KiB
Markdown
93 lines
4.2 KiB
Markdown
+++
|
||
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]: وهذا مثال على الهامش!
|