انتقل إلى المحتوى

برمجة ماركداون

من ويكي الكتب

ماركداون


إنّ لغة ماركداون (Markdown) هي لغة وب تنسيقية. فبدلاً من الكتابة بـ لغة HTML يمكن الكتابة بهذه اللغة وهي أبسط بكثير من html وسهلة القراءة والكتابة، وبوجود مفسر فسيتم تحويل تنسيق markdown إلى html.

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

كيفية التنسيق

[عدل]

والآن، لكي نتعلم هذه اللغة فكل ما علينا تعلمه هو بعض الأكواد التي تتضمنها اللغة. هنا حاولت جمع كل الأكواد المستخدمة في هذه اللغة (فهي ليست لغة ضخمة)

النص العادي

[عدل]

النص العادي يكتب بدون الحاجة لأي أكواد. مع ملاحظة بسيطة هو أنك يجب أن تضع سطر فارغ بين الفقرة والأخرى لكي تُقرأ على أنها بداية سطر جديد. أي بدل الضغط على enter للانتقال للسطر الجديد ستضغط على enter مرتين لترك سطر فارغ وبالتالي ليفهم المفسر أنك تريد الانتقال لسطر جديد.

العناوين

[عدل]

لكتابة العناوين نضع الرمز # مرة واحدة أو أكثر قبل العنوان (لا تنس الفراغ بين الرمز والعنوان):

  1. عنوان رئيسي
    1. عنوان فرعي 1
      1. عنوان فرعي 2
        1. عنوان فرعي 3

وما إلى ذلك .. مثلاً العنوان الرئيسي في هذه الصفحة هو "كيفية التنسيق" والعنوان الفرعي الأول هو "العناوين".

الاقتباس

[عدل]

لكتابة نص مقتبس بلغة markdown نضع الرمز > قبل النص المقتبس، وأيضاً يجب الانتباه للفراغ بين الرمز والكتابة:

> هذا عبارة عن نص مقتبس

نمط النص

[عدل]

لجعل بعض الكلمات تظهر بشكل عريض أو مائل نستخدم الرمز * كما يلي:

هذه الكلمة مكتوبة بشكل **عريض** وهذه مكتوبة بشكل *مائل*

الناتج:

هذه الكلمة مكتوبة بشكل عريض وهذه مكتوبة بشكل مائل

ملاحظة: هناك رمز آخر يستخدم لنفس الغرض وهو الشرطة السفلية _ وبنفس الطريقة المذكورة.

القوائم

[عدل]

قائمة منقطة

[عدل]

للقائمة المنقطة نستخدم الرمز * ثم فراغ ثم النص. كذلك الرمز - يستخدم لنفس الغرض

* عنصر قائمة

* عنصر قائمة

* عنصر قائمة

قائمة مُرقّمة

[عدل]

للقائمة المُرّقمة نستخدم الأرقام. حيث نضع بعد الرقم نقطة . ثم فراغ ثم النص

1. عنصر قائمة 1

2. عنصر قائمة

2 3. عنصر قائمة 3

ملاحظة: عند وضع نص أسفل عنصر القائمة والذي يشرح هذا العنصر، فيجب وضع 4 فراغات قبل هذا النص (الشرح) وذلك لإتباع الشرح لعنصر القائم وبالتالي عدم حدوث مشاكل بإعادة الترقيم إن كان عناك عناصر قائمة تليها. مثلاً:

1. عنصر قائمة 1

نص شرح للعنصر1

2. عنصر قائمة 2

نص شرح للعنصر 2

3. عنصر قائمة 3

نص شرح للعنصر 3

قوائم متداخلة=

[عدل]

1. عنصر 1

1. عنصر مُرقّم تابع للعنصر 1

2. عنصر مرقم تابع للعنصر 1

2. عنصر 2

* عنصر غير مرقم تابع للعنصر 2

* عنصر غير مرقم تابع للعنصر الذي يسبقه

* عنصر غير مرقم تابع لقبل سابقه

3. عنصر 3

ملاحظة: لقد وضعت هنا فراغين فقط بدلاً من 4 بين العنصر الفرعي والعنصر التابع له، وذلك لكي لا يسبق العنصر الذي من الدرجة الثالثة 8 فراغات وبالتالي يُفهم بشكل آخر، اقرأ الفقرة التالية

الأكواد

[عدل]

نحتاج أحياناً لتضمين الأكواد في المقال وذلك عند كتابة شرح للغة برمجة معينة أو ما شابه. لتضمين أسطر برمجية نضع 8 فراغات قبل كل سطر برمجي وبالتالي يكون الناتج:

هذا كود برمجي

ولكن أحياناً نحتاج أيضا لإظهار كلمة واحدة ضمن النص على أنه وسم أو جزء من كود، لعمل ذلك نُحيط الكلمة بعلامتي ` ، مثل هذه الكلمة : `كود`

ملاحظة: ألم تجد الرمز ` في لوحة المفاتيح؟ سأوفر عليك عناء البحث .. إنه الزر `ذ` ولكن عندما تكون لغة الكتابة الإنجليزية.

ملاحظة2: لوضع 4 أو 8 فراغات يمكن استخدام زر الـ Tab والذي يكون 4 فراغات في بعض محررات النصوص على جهازك أو 8 في محررات أخرى، يمكن تحديد ذلك من إعدادات محرر النصوص لديك (مثل المفكرة - ولكنها برنامج بدائي بعض الشيء)

الروابط

[عدل]

لكتابة الروابط بلغة ماركداون نضع نص الرابط بين قوسين متوسطين [ ] وبعدها مباشرة قوسين صغيرين ( ) يكون الرابط ضمنهم.

[ويكي جامعة](https://ar.wikiversity.org)

ماذا عن الصورة؟

لوضع صورة نقوم بنفس الكتابة السابقة ولكن يسبقها إشارة التعجب ! ، يكون الشكل:

![نص بديل للصورة](رابط الصورة "نص توضيح اختياري")

ملاحظة: يفيد النص البديل في توضيح محتوى الصورة لمحركات البحث، فلا تهمله.

لعرض الرابط نفسه للضغط عليه، نضع الرابط بين رمزي < و > أي:

<https://ar.wikiversity.org>

خط أفقي

[عدل]

لإظهار خط أفقي في الصفحة نضع ثلاث نجمات أو أكثر ***

الجداول

[عدل]

لكتابة جدول بلغة الماركداون نستخدم الرمز | (يُكتب هذا الرمز بالضغط على زر shift وزر \ والذي يكون فوق زر الـ Enter)، يجب أن تكون كل خانة في الجدول محاطة بالرمز | من الجهتين:

| عنوان غليظ | عنوان غليظ | عنوان غليظ |

|------------| ---------- | ---------- |

| عنصر | عنصر | عنصر |

| عنصر | عنصر | عنصر ما |

لاحظ أن العنوان الغليظ يظهر (بشكل غليظ) لأننا وضعنا أسفله 3 شرطات - أو أكثر.

ملاحظات

[عدل]
  • يمكن الكتابة بلغة html داخل لغة Markdown ، فلو وجدت أن هناك ما ينقص لغة markdown فلا بأس من استخدام أكواد html بداخل التنسيق
  • هل تريد عرض رموز ماركداون نفسها؟ أي كيف سأعرض مثلاً الرمز `|` ضمن الجدول؟ يمكن ذلك باستخدام الرمز `\` قبل رمز ماركداون المخصص.
  • تُستخدم لغة التنسيق CSS بجانب لغة ماركداون لإظهار المحتوى بالشكل المطلوب (لتلوين خانات جدول ماركدوان، لتلوين حقل الإقتباس، وما إلى ذلك ..)

المراجع

[عدل]
Wikimedia Commons هناك ملفات عن Markdown في ويكيميديا كومنز.