هذا دليل موجز باللغة العربية يعرف بصيغة مارك داون (Markdown) المستخدمة لتحرير صفحات هذا الموقع. حسب علمنا، فإن هذا الدليل هو الدليل الوحيد باللغة العربية عن هذه الصيغة الشائعة الاستخدام في أرجاء شبكة الإنترنت. مارك داون صيغة مبسطة تمكن الكاتب من إنشاء صفحات غنية ومنسقة باستخدام النصوص المجردة (plain text) وحسب.

العناوين

لكتابة عنوان، ابدأ السطر بعلامة #. علامة # واحدة تعني عنواناً من المستوى الأول (أعلى مستوى)، كعنوان الصفحة مثلاً. علامتان (##) تعني عنواناً من المستوى الثاني، كعنوان فصل من فصول الصفحة مثلاً، وهكذا إلى المستوى السادس.

مثال

عنوان هذا الفصل مكتوب كالتالي:

## العناوين

الفقرات

لإنهاء فقرة وبداية فقرة جديدة، اترك سطراً خالياً بينهما. ولكي تبدأ سطراً جديداً في نفس الفقرة، أنهِ السطر السابق بفراغين. إذا لم تنهِ السطر السابق بفراغين، سيبدأ السطر الثاني بعد نهاية السطر الأول مباشرة دون بداية سطر جديد.

مثال

هذه هي الفقرة الأولى.

هذه هي الفقرة الثانية.  
هذا سطر جديد في الفقرة الثانية.

الرموز والشفرات

لتنبيه القارئ إلى رمز أو شفرة ما وعرضها بطريقة توضح ذلك، ضع الرمز بين علامتين ` إذا كنت تود عرضه ضمن سطر من نص. أما إذا أردت عرضه في إطار خاص به، فأدرجه في فقرة بمفرده تبدأ جميع سطورها بأربع فراغات.

مثال

هذا نص يحوي علامة النسبة المئوية `%`.

    :::python
    def example_code():
        print "This is a block of code"

سيتم عرض هذا المثال كالتالي:

هذا نص يحوي علامة النسبة المئوية %.

def example_code():
    print "This is a block of code"

لاحظ كيف يمكنك تمييز مفردات اللغة المستخدمة بذكرها في البداية مسبوقة بثلاثة علامات :.

القوائم

لإدراج سطر ضمن قائمة غير مرقمة، استخدم أياً من الرموز - + * في بداية السطر، وأتبعه بفراغ (أو أكثر) ثم بنص عنصر القائمة. ولاستخدام قائمة مرقمة، استخدم رقماً بدلاً من هذه الرموز. لا بد أن يسبق العنصر الأول سطر خالٍ.

لإدراج فقرة جديدة ضمن عنصر القائمة السابق، ابدأ الفقرة بأربع فراغات. وإذا كانت الفقرة ذاتها تبدأ بفراغات، كإطار شفرة مصدر مثلاً، فأضف إلى بداية كل سطر أربع فراغات إضافية.

مثال

قائمة غير مرقمة:

- العنصر الأول.
- العنصر الثاني.

    فقرة تابعة للعنصر الثاني.

- العنصر الثالث.

        print "This is a block of code under the third item"

سيظهر هذا المثال كالتالي:

قائمة غير مرقمة:

• العنصر الأول.

• العنصر الثاني.

  فقرة تابعة للعنصر الثاني.

• العنصر الثالث.

  print "This is a block of code under the third item"
  

الروابط

لإنشاء رابط، ضع نص الرابط في قوسين مربعين: [نص الرابط]، وأتبعه بعنوان الرابط بين قوسين عاديين: (http://openerparabia.org).

لإنشاء رابط إلى صفحة داخلية موجودة في الموقع، يمكنك إما استخدام عنوان الصفحة الكامل مبتدءً بعلامة /، أو استخدام عنوان نسبي (نسبة إلى مكان الصفحة الحالية في شجرة الصفحات)، وذلك بعدم ابتداء العنوان بعلامة /.

أمثلة

• رابط خارجي:

  [موقع مجتمع أوبن إي آر بي العربي](http://openerparabia.org)
  

• عنوان داخلي كامل:

  [ويكي الأدلة الإرشادية](/guides/)
  [إدارة المبيعات](/guides/using/sales/)
  

• دليل داخلي نسبي:

  [إدارة المشتريات](purchases)
  

الصور

يمكنك إدراج صورة باستخدام صيغة مشابهة لصيغة الروابط، تسبقها علامة !. لإدراج صورة تم رفعها إلى مكتبة الوسائط في هذا الموقع، استخدم عنواناً كهذا:

/static/media/uploads/page_images/site.png

أمثلة

• صورة خارجية:

  ![وصف الصورة](http://openerparabia.org/openerparabia.png)
  

• صورة محملة على إدارة الوسائط:

  ![وصف الصورة](/static/media/uploads/page_images/site.png)
  

سيظهر وصف الصورة أدناها، كما أنه سيظهر بدلاً من الصورة في حالة عدم العثور على الصورة في الرابط.

تأكيد النص

يمكنك تأكيد النصوص باستخدام البنط العريض، بحصر النص بين العلامة المزدوجة ** قبله وبعده، أو باستخدام البنط المائل، بحصر النص بين العلامة المفردة * قبله وبعده.

مثال

يمكنك تأكيد النصوص باستخدام البنط **العريض** أو *المائل*،
أو ***كليهما***.

النصوص الإنجليزية

هذه إضافة إلى صيغة مارك داون خاصة بهذا الموقع، تمت إضافتها لعرض النصوص الإنجليزية بشكل أفضل في موقع معظم محتواه باللغة العربية. مثلاً، تعدل هذه الإضافة اتجاه النص ليصبح من اليسار إلى اليمين، بدلاً من الاتجاه الأساسي في عامة الموقع والذي هو من اليمين إلى اليسار.

لإدراج نص إنجليزي، ضع النص بين قوسين مربعين، وأتبع القوس المفتوح بالرمز eng. مثلاً:

[eng This is some English text]

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