Skip to main content

كيفية استخدام Markdown (CommonMark) في ويكي لدينا

ملاحظة: هذا المستند هو ترجمة آلية للنسخة الإنجليزية الأصلية.

هذه الصفحة عبارة عن "ورقة غش" قصيرة لتنسيق الصفحات في الويكي الخاص بنا، حيث تتم كتابة المحتوى بتنسيق CommonMark Markdown.

القواعد الأساسية

  • اكتب بجمل بسيطة وقصيرة.
  • اجعل الصفحة قابلة للمسح الضوئي (سهلة القراءة السريعة): العناوين + القوائم + الجداول.
  • قسم واحد = فكرة واحدة. تجنب "الجدران النصية" (النصوص الطويلة المتصلة).

العناوين

استخدم ## / ### / #### للهيكلة.

## قسم
### قسم فرعي
#### قسم فرعي أصغر

غامق، مائل، كود مضمّن

**غامق**
*مائل*
`كود/حقل/عنوان`

الروابط

[نص الرابط](https://example.com)

إذا كنت بحاجة إلى إظهار رابط "خام" (نادر):

`https://example.com`

القوائم

قائمة نقطية:

- عنصر 1
- عنصر 2
  - عنصر فرعي

قائمة مرقمة:

1. خطوة 1
2. خطوة 2
3. خطوة 3

الاقتباسات / الملاحظات

> هذه ملاحظة مهمة.
> يمكن أن تتكون من سطرين.

الجداول

النموذج الأدنى:

| الحقل | القيمة |
|---|---|
| الاسم | [ ] |
| الحالة | [ ] |

نصائح:

  • الصف الفاصل |---|---| مطلوب.
  • يمكن أن تحتوي خلايا الجدول على **غامق** وروابط و كود.

كتل التعليمات البرمجية (الكود) والنصوص "الخام"

كتلة الكود:

\```text
السطر 1
السطر 2
\```

إذا كانت لغة معينة (على سبيل المثال، JSON)، يمكنك تحديدها:

\```json
{ "key": "value" }
\```

الصور

إذا كان لديك رابط (URL) مباشر للصورة:

![الوصف](https://example.com/image.png)

إذا تم تحميل الملف إلى الويكي، فاستخدم الرابط/كود التضمين الذي يوفره الويكي عند التحميل.

فواصل الأسطر والفقرات

  • الفقرة الجديدة هي سطر فارغ بين الفقرات.
  • إذا كنت بحاجة إلى فاصل أسطر داخل فقرة، أضف مسافتين في نهاية السطر:
السطر الأول.  
السطر الثاني.

HTML المضمن (استخدمه بحذر)

كتلة "التفاصيل" القابلة للطي

استخدمها للتفاصيل/الأدلة الطويلة لتجنب إثقال "الشاشة الأولى".

<details>
<summary><b>التفاصيل</b></summary>

يمكنك وضع النصوص والقوائم والجداول هنا.

</details>

الروابط الداخلية (Anchors) والروابط السريعة داخل الصفحة

الرابط الداخلي (Anchor):

<a id="ai-thesis-fit"></a>

الرابط إلى الرابط الداخلي:

[انتقل إلى مدى التوافق مع أطروحة الذكاء الاصطناعي](#ai-thesis-fit)

العناصر النائبة (Placeholders) في النماذج

في النماذج نستخدم:

  • [ ] — "املأ"
  • / — "— / لا ينطبق" (عندما يكون ذلك منطقياً)
  • YYYY‑MM‑DD — تنسيق التاريخ
  • Tier‑1/2/3 — مستوى المصدر (أدلة/سياق/ضوضاء)

الأخطاء الشائعة

  • الخلط بين صندوق المعلومات (infobox) والوصف: صندوق المعلومات مخصص للحقائق القصيرة فقط؛ بينما توضع التفسيرات في صلب الصفحة.
  • الكتابة بدون مصادر في مكان يجب أن يوجد فيه مصدر.
  • إثقال "الشاشة الأولى": من الأفضل وضع التفاصيل الطويلة داخل <details>.
  • استخدام "لغة مالية" (نصائح الشراء/البيع/الاحتفاظ، التوقعات) — هذا محظور بالنسبة لنا؛ نحن نكتب الحقائق/المخاطر/ما يجب التحقق منه.

قائمة تحقق مصغرة قبل النشر

  • هل يوجد سطر أو سطران يشرحان "ما هو"؟
  • هل توجد روابط للمصادر الأولية؟
  • هل توجد أي حقول جدول فارغة "غير واضحة" (يجب أن يكون كل حقل إما قيمة أو —/—
  • هل تم ملء Last verified (آخر تحقق)؟