قواعد الاقتباس

تُستخدم الاقتباسات (Blockquote) لإبراز النص المقتبس أو التأكيد على معلومات مهمة. في Markdown، استخدم رمز > لإنشاء كتلة اقتباس.

صياغة الاقتباس الأساسية

اقتباس سطر واحد

استخدم رمز > في بداية السطر لإنشاء اقتباس:

> هذه كتلة اقتباس.

نتيجة العرض:

هذه كتلة اقتباس.

اقتباس متعدد الأسطر

> هذا هو السطر الأول من الاقتباس.
> هذا هو السطر الثاني من الاقتباس.
> هذا هو السطر الثالث من الاقتباس.

نتيجة العرض:

هذا هو السطر الأول من الاقتباس. هذا هو السطر الثاني من الاقتباس. هذا هو السطر الثالث من الاقتباس.

اقتباس الفقرات

ضمن فقرات متعددة في الاقتباس:

> هذه هي الفقرة الأولى من الاقتباس.
>
> هذه هي الفقرة الثانية من الاقتباس.

نتيجة العرض:

هذه هي الفقرة الأولى من الاقتباس.

هذه هي الفقرة الثانية من الاقتباس.

الاقتباس المتداخل

التداخل الأساسي

استخدم >> لإنشاء اقتباس متداخل:

> هذا اقتباس من المستوى الأول.
>
> > هذا اقتباس من المستوى الثاني.
>
> العودة إلى اقتباس المستوى الأول.

نتيجة العرض:

هذا اقتباس من المستوى الأول.

هذا اقتباس من المستوى الثاني.

العودة إلى اقتباس المستوى الأول.

تداخل متعدد المستويات

> اقتباس المستوى الأول
> > اقتباس المستوى الثاني
> > > اقتباس المستوى الثالث
> > > > اقتباس المستوى الرابع
> >
> > العودة إلى المستوى الثاني
>
> العودة إلى المستوى الأول

نتيجة العرض:

اقتباس المستوى الأول

اقتباس المستوى الثاني

اقتباس المستوى الثالث

اقتباس المستوى الرابع

العودة إلى المستوى الثاني

العودة إلى المستوى الأول

عناصر أخرى داخل الاقتباس

التنسيق داخل الاقتباس

> **نص عريض** و *نص مائل* يعملان بشكل طبيعي في الاقتباس.
> 
> يمكنك استخدام `كود سطري` وتنسيقات أخرى.

نتيجة العرض:

نص عريض و نص مائل يعملان بشكل طبيعي في الاقتباس.

يمكنك استخدام كود سطري وتنسيقات أخرى.

العناوين داخل الاقتباس

> ## عنوان داخل الاقتباس
> 
> هذا هو محتوى النص داخل الاقتباس.
> 
> ### عنوان فرعي
> 
> المزيد من محتوى الاقتباس.

نتيجة العرض:

عنوان داخل الاقتباس

هذا هو محتوى النص داخل الاقتباس.

عنوان فرعي

المزيد من محتوى الاقتباس.

القوائم داخل الاقتباس

> قائمة داخل الاقتباس:
> 
> 1. العنصر الأول
> 2. العنصر الثاني
> 3. العنصر الثالث
> 
> أو قائمة غير مرتبة:
> 
> - العنصر أ
> - العنصر ب
> - العنصر ج

نتيجة العرض:

قائمة داخل الاقتباس:

1. العنصر الأول
2. العنصر الثاني
3. العنصر الثالث

أو قائمة غير مرتبة:

• العنصر أ
• العنصر ب
• العنصر ج

كتل الكود داخل الاقتباس

> فيما يلي مثال كود:
> 
> ```javascript
> function hello() {
>   console.log("Hello, World!");
> }
> ```
> 
> تعرض كتل الكود بشكل طبيعي داخل الاقتباس أيضاً.

نتيجة العرض:

فيما يلي مثال كود:

function hello() {
  console.log("Hello, World!");
}

تعرض كتل الكود بشكل طبيعي داخل الاقتباس أيضاً.

الروابط داخل الاقتباس

> راجع [الوثائق الرسمية](https://www.markdownlang.com) لمزيد من المعلومات.
> 
> يمكنك أيضاً الوصول إلى <https://www.markdownlang.com> كرابط مباشر.

نتيجة العرض:

راجع الوثائق الرسمية لمزيد من المعلومات.

يمكنك أيضاً الوصول إلى https://www.markdownlang.com كرابط مباشر.

حالات استخدام شائعة

1. اقتباس الأدبيات

> "Markdown هي لغة ترميز خفيفة الوزن، تسمح للناس بكتابة المستندات بصيغة نص خالص سهلة القراءة والكتابة."
> 
> —— John Gruber، مبتكر Markdown

نتيجة العرض:

"Markdown هي لغة ترميز خفيفة الوزن، تسمح للناس بكتابة المستندات بصيغة نص خالص سهلة القراءة والكتابة."

—— John Gruber، مبتكر Markdown

2. معلومات التحذير

> ⚠️ **تحذير**
> 
> تنفيذ هذه العملية سيحذف جميع البيانات، تأكد من عمل نسخة احتياطية للملفات المهمة.

نتيجة العرض:

⚠️ تحذير

تنفيذ هذه العملية سيحذف جميع البيانات، تأكد من عمل نسخة احتياطية للملفات المهمة.

3. معلومات النصيحة

> 💡 **نصيحة**
> 
> استخدام اختصار لوحة المفاتيح `Ctrl+S` يمكنك من حفظ المستند بسرعة.

نتيجة العرض:

💡 نصيحة

استخدام اختصار لوحة المفاتيح Ctrl+S يمكنك من حفظ المستند بسرعة.

4. ملاحظة مهمة

> 📌 **ملاحظة مهمة**
> 
> قبل البدء، تأكد من تثبيت التبعيات التالية:
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

نتيجة العرض:

📌 ملاحظة مهمة

قبل البدء، تأكد من تثبيت التبعيات التالية:

• Node.js (>= 14.0)
• npm (>= 6.0)
• Git

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

1. نسيان رمز >

❌ خطأ:
> السطر الأول من الاقتباس
نسيت رمز > في السطر الثاني  ← هذا السطر لن يُضمن في الاقتباس

✅ صحيح:
> السطر الأول من الاقتباس
> السطر الثاني صحيح من الاقتباس

2. خطأ في مستويات التداخل

❌ خطأ:
> المستوى الأول
> > > القفز مباشرة إلى المستوى الثالث  ← تجاوز المستوى الثاني

✅ صحيح:
> المستوى الأول
> > المستوى الثاني
> > > المستوى الثالث

3. معالجة السطور الفارغة

❌ قد يكون هناك مشكلة:
> الفقرة الأولى

> الفقرة الثانية  ← هذا سيُنشئ كتلتين اقتباس منفصلتين

✅ اقتباس متعدد الفقرات صحيح:
> الفقرة الأولى
>
> الفقرة الثانية

أفضل الممارسات

1. الحفاظ على أسلوب متسق

✅ مُوصى به: أسلوب اقتباس موحد
> جميع المعلومات المهمة تستخدم كتلة اقتباس
> الحفاظ على التنسيق متسق

❌ غير مُوصى به: الاستخدام المختلط
> أحياناً استخدام الاقتباس
**أحياناً استخدام النص العريض بدلاً منه**

2. استخدام التداخل باعتدال

✅ مُوصى به: تداخل بسيط وواضح
> النقطة الرئيسية
> > الحجة الداعمة
> 
> متابعة النقطة الرئيسية

❌ غير مُوصى به: تداخل عميق جداً
> > > > > عميق جداً، صعب القراءة

3. الاستخدام الدلالي

✅ مُوصى به: اقتباس ذو معنى
> هذه معلومات مهمة من وثائق موثوقة

❌ غير مُوصى به: اقتباس زخرفي
> هذا مجرد نص عادي، لا يحتاج إلى تنسيق الاقتباس

إخراج HTML

تحويل اقتباس Markdown إلى HTML:

> هذا نص الاقتباس

يُحوّل إلى:

<blockquote>
  <p>هذا نص الاقتباس</p>
</blockquote>

اقتباس متداخل:

> المستوى الأول
> > المستوى الثاني

يُحوّل إلى:

<blockquote>
  <p>المستوى الأول</p>
  <blockquote>
    <p>المستوى الثاني</p>
  </blockquote>
</blockquote>

الأنماط المخصصة

تدعم بعض معالجات Markdown أنماط اقتباس مخصصة:

مربعات النصيحة بأسلوب GitHub

> [!NOTE]
> هذه معلومة

> [!WARNING]
> هذا تحذير

> [!IMPORTANT]
> هذه ملاحظة مهمة

استخدام HTML و CSS

<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
هذه كتلة اقتباس بنمط مخصص
</blockquote>

أمثلة عملية

مثال في وثائق API

## مصادقة المستخدم

المصادقة ضرورية للوصول إلى API.

> **طريقة المصادقة**
> 
> يستخدم API الخاص بنا Bearer Token للمصادقة:
> 
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### مثال الطلب

إرسال طلب POST لإنشاء مستخدم:

> ```json
> {
>   "name": "أحمد محمد",
>   "email": "ahmed@example.com",
>   "role": "user"
> }
> ```

ملاحظات في البرنامج التعليمي

## خطوات التثبيت

1. تنزيل حزمة التثبيت
2. تشغيل برنامج التثبيت

> ⚠️ **ملاحظة**
> 
> قبل التثبيت تأكد من:
> - إغلاق برنامج مكافحة الفيروسات
> - التشغيل كمسؤول
> - أن القرص يحتوي على 2GB مساحة على الأقل

3. اتباع المعالج لإكمال التثبيت

قواعد ذات صلة

• قواعد التأكيد - تنسيقات النص
• قواعد القوائم - عناصر القوائم
• قواعد الشيفرة - تنسيق الشيفرة
• قواعد الروابط - إنشاء الروابط

تمرين

حاول إنشاء المحتوى التالي:

1. كتلة اقتباس تحتوي على فقرات متعددة
2. هيكل اقتباس متداخل من ثلاثة مستويات
3. اقتباس توضيح تقني يحتوي على مثال كود
4. اقتباس متداخل يحاكي محادثة