Markdown: صيغة القوائم في Markdown والتداخل

القوائم هي أبسط طريقة لتحويل المعلومات المبعثرة إلى محتوى منظم — يمكن للقراء فهم النقاط ��لرئيسية من النظرة الأولى.

1. ما ستتعلمه

• صيغة القوائم غير المرتبة والمرتبة
• الطريقة الصحيحة لتداخل القوائم
• إنشاء واستخدام قوائم المهام
• الفقرات وكتل التعليمات البرمجية والاقتباسات د��خل القوائم
• أخطاء القوائم الشائعة وكيفية ��صلاحها

2. قصة حقيقية لمدير مشروع

(1) نقطة الألم: تخصيص مهام فوضوي

كريس هو مدير مشروع لفريق تطوير. كل يوم اثنين، يكتب خطة المهام الأسبوعية في مستند. كان يصف المهام بنص عادي — كان أعضاء الفريق يفوتون العناصر بشكل متكرر ويخلطون الأولويات. كان أحدهم يسأل: "هل هذه مهمتي أم مهمتك؟" وكان آخر يقول: "لم أعرف أين تقع هذه المهمة في ترتيب الأولوية."

(2) الحل: هيكلة المهام بالقوائم

تحول كريس إلى استخدام قوائم Markdown لتنظيم المهام: قوائم مرتبة للأولويات، وقوائم مهام (- [ ]) لحالة الإكمال، وقوائم متداخلة للمهام الفرعية. تحسنت كفاءة قراءة الفريق بشكل كبير:

## المهام الأسبوعية

1. **[أولوية عالية] ترحيل قاعدة البيانات**
   - [ ] تصدير البيانات القديمة
   - [ ] كتابة برنامج الترحيل
   - [ ] اختبار سلامة البيانات
2. **[أولوية متوسطة] تحديث توثيق API**
   - [x] تحديث توثيق API المستخدم (مكتمل)
   - [ ] إضافة أمثلة نقاط النهاية الجديدة

(3) الفائدة: ملكية واضحة للمهام

3. القوائم غير المرتبة

(1) الصيغة الأساسية

تبدأ القوائم غير المرتبة بـ - أو * أو + متبوعة بمسافة:

- تفاح
- موز
- برتقال

* تفاح
* موز
* برتقال

+ تفاح
+ موز
+ برتقال

نصيحة: الرموز الثلاثة جميعها تنتج نفس النتيجة. نوصي بالالتزام بـ - — إنها الأقل احتمالاً للخلط مع صيغ أخرى مثل المائل *.

(2) عناصر قائمة متعددة الفقرات

إذا كان عنصر القائمة يحتوي على فقرات متعددة، حافظ على اتساق المسافة البادئة:

- العنصر الأول: هذا هو المحتوى الرئيسي.

  هذا شرح إضافي لهذا العنصر (سطر فارغ + مسافتان بادئتان).

- العنصر الثاني: وصف العنصر الثاني.

  مزيد من المعلومات الإضافية.

▶ مثال: تنظيم المعلومات بالقوائم غير المرتبة

## قائمة تدقيق المشروع

- **الواجهة الأمامية**
  - اختبار التخطيط المتجاوب
  - التحقق من توافق المتصفح

- **الواجهة الخلفية**
  - اختبار تحميل API
  - التحقق من النسخ الاحتياطي لقاعدة البيانات

- **DevOps**
  - التحقق من انتهاء صلاحية شهادة SSL
  - تكوين تدوير السجلات

المخرجات:

TEXT 📖 للعرض فقط

📋 Copy

تُعرض كقائمة تدقيق منظمة حسب الفريق، تحتوي كل فئة على عناصر إجراء محددة.

4. القوائم المرتبة

(1) الصيغة الأساسية

تبدأ القوائم المرتبة برقم متبوع بنقطة:

1. الخطوة الأولى: تهيئة المشروع
2. الخطوة الثانية: تثبيت التبعيات
3. الخطو�� الثالثة: تكوين البيئة
4. الخطوة الرابعة: بدء خادم التطوير

نصيحة: لا يتطلب Markdown أرقامًا متتالية — يمكنك كتابة 1. لكل عنصر وسيتم ترقيمه تلقائيًا عند العرض. لكن استخدام الأرقام الحقيقية يجعل المصدر أكثر قابلية للقراءة.

(2) البدء من رقم محدد

تتطلب بعض السيناريوهات البدء من رقم غير 1:

1. الخطوات ا��ثلاث الأولى موجودة في القسم السابق
4. الخطوة الرابعة (استكمال)
5. الخطوة الخامسة

نصيحة: على GitHub، يمكنك أيضًا إدراج نص توضيحي بين عناصر القائمة ومتابعة الترقيم — سيتعرف Markdown على التسلسل تلقائيًا.

▶ مثال: التعبير عن الخطوات بالقوائم المرتبة

## سير عمل النشر

1. سحب آخر تعليمات برمجية: `git pull origin main`
2. تثبيت التبعيات: `npm install`
3. تشغيل الاختبارات: `npm test`
4. بناء المشروع: `npm run build`
5. الرفع إلى الخادم: `scp -r dist/ user@server:/var/www/`
6. إعادة تشغيل الخدمة: `pm2 restart app`

المخرجات:

TEXT 📖 للعرض فقط

📋 Copy

تُعرض كخطوات مرقمة. القوائم المرتبة مناسبة بشكل طبيعي للأدلة خطوة بخطوة — تحتوي كل خطوة على أمر إجراء وشرح موجز.

نصيحة: في الأدلة خطوة بخطوة، القوائم المرتبة هي الخيار الطبيعي لتمثيل ترتيب التنفيذ. تتضمن كل خطوة أمر إجراء واحد ووصفًا قصيرًا.

5. القوائم المتداخلة

يتم إنشاء القوائم المتداخلة من خلال المسافة البادئة. تزاد مسافة القوائم الفرع��ة بمسافتين (أو Tab واحد) عن القائمة الأم:

(1) قائمة غير مرتبة متداخلة في قائمة غير مرتبة

- لغات البرمجة
  - مترجمة
    - C
    - C++
    - Rust
  - مفسرة
    - Python
    - JavaScript
    - Ruby
- قواعد البيانات
  - علائقية
    - PostgreSQL
    - MySQL

(2) قائمة غير مرتبة متداخلة في قائمة مرتبة

1. تثبيت Python
   - تحميل المثبت من الموقع الرسمي
   - تحديد "إضافة Python إلى PATH"
2. إعداد بيئة افتراضية
   - إنشاء البيئة: `python -m venv venv`
   - تنشيط البيئة: `source venv/bin/activate`

▶ مثال: تداخل ثلاثي المستويات لبنية الفئات

## مجموعة تقنيات الواجهة الأمامية

- **أطر العمل**
  - React
    - المفاهيم الأساسية: المكونات، الحالة، الخصائص
    - النظام البيئي: React Router، Redux
  - Vue
    - المفاهيم الأساسية: البيانات التفاعلية، القوالب
    - النظام البيئي: Vue Router، Pinia
- **التنسيق**
  - CSS
  - SCSS
  - Tailwind

المخرجات:

TEXT 📖 للعرض فقط

📋 Copy

تُعرض كقائمة متداخلة ثلاثية المستويات بتسلسل هرمي مرئي واضح — كل مستوى يزاد مسافة بادئة إلى اليمين.

تحذير: لا ��تداخل أكثر من 3 مستويات — تنخفض قابلية القراءة بشكل حاد. إذا كنت بحاجة إلى تسلسل هرمي أعمق، فكّر في استخدام العناوين أو الجداول بدلاً من ذلك.

6. قوائم المهام

قوائم المهام هي امتداد GFM. استخدم - [ ] للعناصر غير المكتملة و - [x] للعناصر المكتملة:

- [x] إكمال تهيئة المشروع
- [x] تنفيذ تسجيل دخول المستخدم
- [ ] كتابة توثيق API
- [ ] النشر إلى الإنتاج
- [ ] تحسين الأداء

تحذير: [x] في قوائم المها�� غير حساس لحالة الأحرف — كل من [x] و [X] يعنيان مكتمل. يجب أن تكون هناك مسافة بعد القوس: استخدم - [ ] وليس -[].

▶ مثال: تتبع تقدم المشروع بقوائم المهام

## مشروع التجارة الإلكترونية - السباق 3

### مكتمل
- [x] صفحة قائمة المنتجات
- [x] سلة التسوق
- [x] تسجيل/تسجيل دخول المستخدم

### قيد التنفيذ
- [ ] تكامل API الدفع
  - [x] تكامل SDK Alipay
  - [ ] معالجة استدعاء الدفع
  - [ ] تدفق الاسترداد

### قائمة المهام
- [ ] لوحة إدارة الطلبات
- [ ] ميزة بحث المنتجات

المخرجات:

TEXT 📖 للعرض فقط

📋 Copy

تُعرض مع مربعات اختيار — العناصر المكتملة تظهر كمحددة، والعناصر غير المكتملة كغير محددة. مثالية لتتبع حالة المشروع.

نصيحة: استخدام قوائم المهام في GitHub Issues و Pull Requests فعال للغاية — يمكن لأعضاء الفريق رؤية التقدم من النظرة الأولى.

7. محتوى آخر داخل القوائم

(1) كتل التعليمات البرمجية داخل القوائم

تحتاج كتل التعليمات البرمجية داخل عناصر القائمة إلى مسافة بادئة إضافية (8 مسافات أو Tabين):

- تشغيل ح��لات الاختبار:

        npm run test -- --coverage

- التحقق من تنسيق التعليمات البرمجية:

        npx eslint src/

تحذير: لا يمكن لكتل التعليمات البرمجية داخل القوائم استخدام صيغة ``` المسيجة (تكسر القائمة في بعض المحللات). النهج الموصى به هو المسافة البادئة بـ 8 مسافات.

(2) الاقتباسات داخل القوائم

- نتيجة رئيسية:
  > يقضي المستخدمون متوسط 12 ثانية فقط على هذه الصفحة.
  > السبب الرئيسي هو بطء وقت التحميل.

8. مثال كامل: تخطيط مشروع بالقوائم

خطة انطلاق المشروع

## السباق 1: الأساس (الأسبوعان 1-2)

- [x] تهيئة المشروع
  1. إنشاء مستودع Git
  2. تكوين CI/CD
  3. إعداد بيئة التطوير
- [ ] نظام المستخدم
  - [x] API التسجيل/تسجيل الدخول
  - [ ] التحقق من البريد الإلكتروني
  - [ ] تسجيل دخول OAuth خارجي
- [ ] تصميم قاعدة البيانات
  - [x] اكتمال مخطط ER
  - [ ] نصوص إنشاء الجداول
  - [ ] بيانات أولية

## السباق 2: الميزات الأساسية (الأسبوعان 3-4)

1. **وحدة المنتج**
   - CRUD المنتج
   - إدارة الفئات
   - وظيفة البحث
2. **وحدة الطلب**
   - إنشاء طلب
   - تدفق الدفع
   - إدارة حالة الطلب

> ملاحظة: يجب إكمال جميع المهام في بطاقة الأداء بنهاية السباق.

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

❓ أسئلة شائعة

📖 ملخص

• استخدم - للقوائم غير المرتبة، و 1. للقوائم المرتبة، و - [ ] لقوائم المهام
• تداخل القوائم بمسافة بادئة 2-4 مسافات
• كتل التعليمات البرمجية داخل القوائم تحتاج إلى مسافة بادئة 8 مسافات
• [x] في قوائم المهام يعني مكتمل، [ ] يعني لم يكتمل بعد
• تُستخدم القوائم عادة لقوائم تدقيق المهام والأدلة خطوة بخطوة والملخصات المصنفة
• حاول الحفاظ على عناصر القائمة بنفس الطول تقريبًا، 1-2 سطر لكل عنصر

📝 تمارين

1. مبتدئ: اذكر 5 مواضيع تقنية تخطط لتعلمها هذا الأسبوع بقائمة غير مرتبة، وصف خطوات التعلم (من الإعداد إلى التطبيق) بقائمة مرتبة، وتتبع تقدمك بقائم�� مهام.

2. متوسط: أنشئ "خطة ترحيل مشروع" تحتوي على 3 مراحل رئيسية على الأقل (قائمة مرتبة)، كل مرحلة تحتوي على مهام فرعية (قائمة غير مرتبة متداخلة)، وقائمة تدقيق (قائمة مهام).

3. متقدم: اكتب عنصر قائمة يمزج بين القوائم المتداخلة وكتل التعليمات البرمجية والاقتباس��ت — جميع أنواع المحتوى الثلاثة معًا. على سبيل المثال: داخل عنصر قائمة "خطوات النشر"، قم بتضمين كتلة تعليمات برمجية لأمر bash، وأضف اقتباسًا أسفله بملاحظة تحذيرية.

فريق Web-Tutorial التقني

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

من نحن