الحواشي السفلية

الحواشي السفلية هي توسعة في Markdown لإضافة مراجع أو معلومات إضافية دون قطع سياق القراءة.

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

إضافة حاشية

تكوين الحاشية يتكون من جزأين: موضع الإشارة ومحتوى الحاشية.

هذه فقرة تحتوي على حاشية سفلية[^1].

[^1]: هذا محتوى الحاشية السفلية.

العرض:

هذه فقرة تحتوي على حاشية سفلية[^1].

[^1]: هذا محتوى الحاشية السفلية.

حواشٍ متعددة

Markdown هي لغة ترميز خفيفة الوزن[^1]، أنشأها John Gruber[^2]، وتستخدم الآن على نطاق واسع في مجال الكتابة[^3].

[^1]: Markdown تستخدم صيغة بسيطة لتحويل النص.
[^2]: أنشأ John Gruber لغة Markdown في عام 2004.
[^3]: العديد من المنصات مثل GitHub و Stack Overflow ومنصات المدونات تدعم Markdown.

العرض:

Markdown هي لغة ترميز خفيفة الوزن[^2]، أنشأها John Gruber[^3]، وتستخدم الآن على نطاق واسع في مجال الكتابة[^4].

[^2]: Markdown تستخدم صيغة بسيطة لتحويل النص. [^3]: أنشأ John Gruber لغة Markdown في عام 2004. [^4]: العديد من المنصات مثل GitHub و Stack Overflow ومنصات المدونات تدعم Markdown.

استخدامات متقدمة

معرفات الحاشية

يمكن أن يكون المعرّف رقماً أو كلمة بلا مسافات أو تبويبات.

هنا حاشية عادية[^1] وحاشية بمعرّف[^note].

[^1]: هذه حاشية عادية.
[^note]: هذه حاشية بمعرّف.

العرض:

هنا حاشية عادية[^5] وحاشية بمعرّف[^note].

[^5]: هذه حاشية عادية. [^note]: هذه حاشية بمعرّف.

حواشي متعددة الفقرات

قد تحتوي الحاشية على فقرات وعناصر أخرى، مع الحفاظ على الإزاحة.

هذه حاشية تحتوي على فقرات متعددة[^multipara].

[^multipara]: هذه الفقرة الأولى من الحاشية.

    هذه الفقرة الثانية من الحاشية. يجب أن يكون الإزاحة أربع مسافات على الأقل أو علامة تبويب.

    > يمكن أيضاً أن تحتوي الحاشية على كتلة اقتباس.

    - يمكن أن تحتوي على قائمة
    - قوائم مرتبة أو غير مرتبة

العرض:

هذه حاشية تحتوي على فقرات متعددة[^multipara].

[^multipara]: هذه الفقرة الأولى من الحاشية.

هذه الفقرة الثانية من الحاشية. يجب أن يكون الإزاحة أربع مسافات على الأقل أو علامة تبويب.

> يمكن أيضاً أن تحتوي الحاشية على كتلة اقتباس.

- يمكن أن تحتوي على قائمة
- قوائم مرتبة أو غير مرتبة

حواشي ضمن السطر

بعض التطبيقات تدعم حواشي ضمن السطر، لكنها ليست جزءاً من المعيار.

هذه حاشية ضمن السطر^[إضافة محتوى الحاشية مباشرة في النص بدلاً من نهاية المستند].

العرض (على المنصات الداعمة):

هذه حاشية ضمن السطر^[إضافة محتوى الحاشية مباشرة في النص بدلاً من نهاية المستند].

التوافق والفروقات بين المنصات

دعم المنصات المختلفة

منصة/أداة	حواشٍ معيارية	ضمن السطر	متعددة الفقرات
GitHub Markdown	✅	❌	✅
GitLab Markdown	✅	✅	✅
Jekyll（kramdown）	✅	✅	✅
Hugo	✅	✅	✅
CommonMark	❌	❌	❌
VitePress	✅	✅	✅
Pandoc	✅	✅	✅

ناتج HTML

تحوّل أغلب المعالجات الحواشي إلى HTML مع روابط وسهم رجوع:

<!-- إشارة الحاشية -->
<p>هذه فقرة تحتوي على حاشية سفلية<sup id="fnref:1"><a href="#fn:1" class="footnote-ref">1</a></sup>.</p>

<!-- محتوى الحاشية (عادة في نهاية المستند) -->
<div class="footnotes">
  <hr>
  <ol>
    <li id="fn:1">
      <p>هذا محتوى الحاشية السفلية.<a href="#fnref:1" class="footnote-backref">↩</a></p>
    </li>
  </ol>
</div>

نصائح استخدام وأفضل الممارسات

متى تستخدم الحواشي

استخدم الحواشي عندما:

1. الاستشهاد بمصادر: الاستشهاد بأوراق بحثية أو كتب أو مراجع أخرى
2. شرح إضافي: تقديم معلومات إضافية دون قطع المحتوى الرئيسي
3. قراءة إضافية: تقديم موارد إضافية للقراء المهتمين
4. شرح المصطلحات: شرح المصطلحات المتخصصة أو الاختصارات

نصائح تنسيق الحواشي

✅ ممارسات موصى بها:

1. **وضع محتوى الحواشي في النهاية**: ضع جميع تعريفات الحواشي في نهاية المستند لتسهيل الصيانة
2. **الحفاظ على الاتساق**: استخدم طريقة متسقة لتمييز الحواشي (أرقام أو معرّفات ذات معنى)
3. **الاستخدام المعتدل**: كثرة الحواشي تشتت انتباه القارئ
4. **تقديم محتوى ذو معنى**: يجب أن تضيف الحواشي قيمة فعلية وليس فقط تكرار النص الأساسي

❌ تجنّب:

1. استخدام عدة حواشي في جملة واحدة
2. استخدام الحواشي لعرض المعلومات الأساسية
3. وضع محتوى طويل جداً في الحواشي
4. تداخل الحواشي مع حواشي أخرى

الحواشي في المستندات الطويلة

في المستندات الطويلة اجمع الحواشي بحسب الفصول:

# الفصل الأول

هذا محتوى الفصل الأول ويحتوي على حاشية[^1-1].

[^1-1]: الحاشية الأولى من الفصل الأول.

# الفصل الثاني

هذا محتوى الفصل الثاني ويحتوي على حاشية أخرى[^2-1].

[^2-1]: الحاشية الأولى من الفصل الثاني.

حلول للمشكلات الشائعة

الحاشية لا تظهر

إن لم تظهر الحواشي بشكل صحيح:

1. تأكد من تطابق معرّف الحاشية وتعريفها تماماً (بما في ذلك الحالة)
2. تحقق من أن تعريف الحاشية بصيغة صحيحة (يجب أن يكون هناك مسافة بعد النقطتين)
3. تحقق مما إذا كان معالج Markdown الخاص بك يدعم صيغة الحواشي
4. حاول ترك أسطر فارغة قبل وبعد تعريف الحاشية

ترقيم الحاشية مُربك

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

إمكانية الاستخدام على الأجهزة المحمولة

على الأجهزة المحمولة قد تكون الروابط صغيرة؛ استخدم قارئاً يدعم معاينة الحاشية لتحسين التجربة.

قواعد ذات صلة

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

تمارين وتطبيقات

1. أنشئ مقطعاً يحوي 3 حواشٍ مختلفة
2. جرّب إنشاء حاشية متعددة الفقرات
3. استخدم الحواشي للاستشهاد في مقال تقني/أكاديمي

---

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