> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ar/altnsyq/15-margin-notes.md).

# ملاحظات الهامش

## مقدمة

تشرح هذه المقالة كيفية إنشاء ملاحظات هامشية، وهي بديل شائع للحواشي السفلية كوسيلة لإضافة معلومات تكميلية تدعم النص الرئيسي للمستند. كما لدينا أيضًا [صفحة مساعدة حول `todonotes` الحزمة](/latex/ar/alaselh-walajwbh/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) الذي يوفّر حلولًا بديلة لتلك المعروضة في هذه المقالة.

## الأمر \marginpar

من دون تحميل أي حزم إضافية، يمكنك استخدام الأمر المدمج في LaTeX `\marginpar` لإضافة ملاحظات هامشية إلى مستندك. الصيغة العامة لـ `\marginpar` الأمر هي

`\marginpar[*left text*]{*right text*}`

حيث `*left text*` سيُستخدم إذا ظهرت الملاحظة الهامشية على يسار صفحة المستند، و `*right text*` إذا ظهرت على اليمين. وللتحديد أكثر، توضع الملاحظات الهامشية عادةً على «الخارج» من الصفحة—على الرغم من أن معنى «الخارج» يعتمد على صنف المستند الذي تستخدمه وما إذا كنت قد حدّدت `twoside` خيار الحزمة:

* `book` الصنف (`\documentclass{book})` المستندات ثنائية الوجه افتراضيًا (التصميم)
* `التقرير` الصنف (`\documentclass{report}`) و `article` الصنف (`\documentclass{article}`) تكون المستندات، افتراضيًا، أحادية الوجه. ولجعلها ثنائية الوجه عليك تحديد `twoside` :
  * `\documentclass[twoside]{report}`، أو
  * `\documentclass[twoside]{article}`

بالنسبة للمستندات أحادية الوجه، باستثناء اللغات من اليمين إلى اليسار، مثل العربية، فإن «الخارج» هو دائمًا الحافة اليمنى للنص، أما في المستندات ثنائية الوجه فهو الحافة اليسرى للنص في الصفحات اليسرى والحافة اليمنى للنص في الصفحات اليمنى.

### عكس موضع الملاحظات الهامشية

الأمر `\reversemarginpar` يعكس الجانب الذي تُصفّ فيه الملاحظات الهامشية؛ ويمكن التراجع عن تأثيره بالأمر `\normalmarginpar`. وكما ورد في وثائق مصدر LaTeX: «هذه الأوامر ليس لها أي تأثير في الإخراج ثنائي العمود.»

### الأوامر المؤثرة في تنضيد الملاحظات الهامشية

تنضيد `\marginpar` الملاحظات يستخدم عدة أوامر أبعاد تخزّن قيَمًا يمكن تغييرها، إذا لزم الأمر:

* `\marginparwidth`: تحدد عرض الملاحظات الهامشية وبالتالي طول الأسطر المنضدة في الملاحظة الهامشية.
* `\marginparsep`: تضبط الفجوة (المسافة) بين الملاحظات الهامشية ونص مستندك.
* `\marginparpush`: تحدد مسافة الفصل الرأسية الدنيا بين `\marginpar` الملاحظات.

### تغيير تنضيد الملاحظات الهامشية: محاذاة يمين مُتعرّجة ومحاذاة يسار مُتعرّجة

افتراضيًا، يُنضَّد نص الملاحظة الهامشية داخل صندوق ينتج أسطرًا منضدة بعرض `\marginparwidth`. يمكن أن يؤدي هذا إلى فجوات غير جميلة بين الكلمات المنضدة بينما يحاول محرك TeX إيجاد «أفضل» فواصل الأسطر. يمكنك استخدام الأوامر `\raggedright` و `\raggedleft` لتغيير نمط تنضيد النص.

### مثال

فيما يلي مثال يستخدم عدة `\marginpar` أوامر لعرض بعض الميزات المذكورة أعلاه. ويحمّل المثال أيضًا [`geometry`](https://ctan.org/pkg/geometry) الحزمة لإنشاء حجم صفحة صغير و [`hyperref`](https://ctan.org/pkg/hyperref) الحزمة التي توفر `\url` الأمر المستخدم لإسناد المصدر إلى النص (في الحاشية السفلية).

```latex
\documentclass[twoside]{article} % ملاحظة: يستخدم خيار twoside
\usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % لإنشاء صفحة صغيرة
\usepackage{hyperref} % لاستخدام الأمر \url (في الحاشية السفلية)
\usepackage{marginnote}
\begin{document}
\section{لوريم إيبسوم}
\footnote{Source text: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}لكن عليّ أن أشرح لك كيف نشأت هذه الفكرة الخاطئة التي تدين اللذة وتمجّد الألم. ولأفعل ذلك، سأقدّم لك عرضًا كاملًا للنظام، وأشرح التعاليم الحقيقية للمستكشف العظيم للحقيقة، باني سعادة البشر. \marginpar[ملاحظة 1: نص للجانب الأيسر]{ملاحظة 1: نص للجانب الأيمن من الصفحات، وهو مضبوط المحاذاة.} لا أحد يرفض اللذة ذاتها أو يكرهها أو يتجنبها لأنها لذة، بل لأن الذين لا يعرفون كيف يطلبون اللذة بعقلانية يواجهون عواقب مؤلمة للغاية. وكذلك لا يوجد أحد يحب الألم أو يسعى إليه أو يرغب فيه لذاته، لأنه ألم، لكن قد تطرأ أحيانًا ظروف يمكن فيها للكدّ والألم أن يوفرا له بعض اللذة العظيمة.  \marginpar[ملاحظة 2: نص للجانب الأيسر]{\raggedright ملاحظة 2: نص للجانب الأيمن من الصفحات، وهو غير مضبوط المحاذاة، بل يستخدم \texttt{\string\raggedright}.} ولأخذ مثال تافه، من منا يباشر يومًا تمرينًا بدنيًا شاقًا، إلا ليحصل منه على بعض المنفعة؟ ولكن بأي حق يُلام رجل يختار أن يستمتع بلذة لا تترتب عليها عواقب مزعجة، أو من يتجنب ألمًا لا ينتج عنه أي لذة؟ [33] ومن ناحية أخرى، فإننا نُدين بسخطٍ عادل ونكره الرجال الذين خُدعوا وأُفسدوا بسحر لذّة اللحظة، وأُعموا بالرغبة حتى لم يعودوا يتوقعون الألم والمتاعب التي لا بد أن تلي ذلك؛ وينال اللوم نفسه أولئك الذين يقصّرون في واجبهم بسبب ضعف الإرادة، وهو ما يعني الشيء نفسه: التراجع عن الكدّ والألم. وهذه الحالات بسيطة تمامًا وسهلة التمييز. في ساعة فراغ، حين تكون قدرتنا على الاختيار غير مقيّدة ولا يمنعنا شيء من أن نفعل ما نفضله، ينبغي الترحيب بكل لذة وتجنّب كل ألم. \marginpar[\raggedleft ملاحظة 3: نص للجانب الأيسر من الصفحات، وهو غير مضبوط المحاذاة، بل يستخدم \texttt{\string\raggedleft}]{ملاحظة 3: نص للجانب الأيسر من الصفحات} لكن في ظروف معينة وبسبب مقتضيات الواجب أو التزامات العمل، كثيرًا ما يحدث أن اللذات يجب أن تُرفض وأن المضايقات تُقبل. لذلك يتمسك الرجل الحكيم دائمًا في هذه الأمور بمبدأ الاختيار هذا: فهو يرفض اللذات ليحصل على لذات أكبر أخرى، أو يتحمل الآلام لتجنب آلام أسوأ.
\end{document}
```

افتح هذا `\marginpar` المثال في Overleaf

ينتج هذا المثال ما يلي (صفحتان) من المخرجات:

الصفحة 1:

![مثال على الأمر \marginpar](/files/ecf6d1b3ee0d1e772d3eb92c0ed48a2442416ec1)

الصفحة 2:

![مثال على الأمر \marginpar](/files/3f62702cd51212d369d4eb4b111baa5749d55469)

### حزمة mparhack: إصلاح الهامش الخاطئ

داخليًا، يعالج LaTeX الملاحظات الهامشية كنوع من المكوّنات «العائمة» في مستندك—على غرار الطريقة التي يتعامل بها LaTeX مع الأشكال والجداول العائمة. وبسبب كونها «عوامات»، قد تظهر الملاحظات الهامشية التي ينتجها `\marginpar` أحيانًا في الهامش الخاطئ. وقد كُتبت [`mparhack` الحزمة](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) لحل هذه المشكلة، لذا قد يكون من المفيد استخدامه إذا واجهت ذلك.

## بديل لـ \marginpar: حزمة marginnote

ال [`marginnote` الحزمة](https://www.ctan.org/pkg/marginnote) توفّر بديلاً متعدد الاستخدامات لـ `\marginpar` الأمر. `marginnote` تُنفّذ الملاحظات الهامشية باستخدام آلية غير عائمة، وهو أمر مختلف عن كيفية عمل `\marginpar` بالشكل التالي: `marginnote` يحُل بعض المشكلات، لكنه كما تذكر وثائقه قد يسبب مشكلات أخرى.

### مثال

يوضح المثال التالي `\marginnote` الأمر الموفَّر من `marginnote` الحزمة:

```latex
\documentclass{article}
\usepackage[a5paper, total={3in, 6in}]{geometry} % لإنشاء صفحة صغيرة
\usepackage{hyperref} % لاستخدام الأمر \url (في الحاشية السفلية)
\usepackage{marginnote}
\begin{document}
\section{لوريم إيبسوم}
\footnote{Source text: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}لكن عليّ أن أشرح لك كيف نشأت هذه الفكرة الخاطئة التي تدين اللذة وتمجّد الألم. ولأفعل ذلك، سأقدّم لك عرضًا كاملًا للنظام، وأشرح التعاليم الحقيقية للمستكشف العظيم للحقيقة، باني سعادة البشر. \marginnote{هذه ملاحظة هامشية أُزيحت 2 سم إلى أسفل الصفحة، بالنسبة إلى السطر الذي تُنضَّد فيه.}[2cm] لا أحد يرفض اللذة ذاتها أو يكرهها أو يتجنبها لأنها لذة، بل لأن الذين لا يعرفون كيف يطلبون اللذة بعقلانية يواجهون عواقب مؤلمة للغاية. وكذلك لا يوجد أحد يحب الألم أو يسعى إليه أو يرغب فيه لذاته، لأنه ألم، لكن قد تطرأ أحيانًا ظروف يمكن فيها للكدّ والألم أن يوفرا له بعض اللذة العظيمة. \reversemarginpar\marginnote{هذه ملاحظة هامشية أخرى لكنها أُزيحت 2 سم إلى أعلى الصفحة، بالنسبة إلى السطر الذي تُنضَّد فيه. وهي أيضًا في الهامش الأيسر.}[-2cm] ولأخذ مثال تافه، من منا يباشر يومًا تمرينًا بدنيًا شاقًا، إلا ليحصل منه على بعض المنفعة؟ ولكن بأي حق يُلام رجل يختار أن يستمتع بلذة لا تترتب عليها عواقب مزعجة، أو من يتجنب ألمًا لا ينتج عنه أي لذة؟ [33] ومن ناحية أخرى، فإننا نُدين بسخطٍ عادل ونكره الرجال الذين خُدعوا وأُفسدوا بسحر لذّة اللحظة، وأُعموا بالرغبة حتى لم يعودوا يتوقعون الألم والمتاعب التي لا بد أن تلي ذلك؛ وينال اللوم نفسه أولئك الذين يقصّرون في واجبهم بسبب ضعف الإرادة، وهو ما يعني الشيء نفسه: التراجع عن الكدّ والألم. وهذه الحالات بسيطة تمامًا وسهلة التمييز. في ساعة فراغ، حين تكون قدرتنا على الاختيار غير مقيّدة ولا يمنعنا شيء من أن نفعل ما نفضله، ينبغي الترحيب بكل لذة وتجنّب كل ألم. لكن في ظروف معينة وبسبب مقتضيات الواجب أو التزامات العمل، كثيرًا ما يحدث أن اللذات يجب أن تُرفض وأن المضايقات تُقبل. لذلك يتمسك الرجل الحكيم دائمًا في هذه الأمور بمبدأ الاختيار هذا: فهو يرفض اللذات ليحصل على لذات أكبر أخرى، أو يتحمل الآلام لتجنب آلام أسوأ.
\end{document}
```

افتح هذا المثال في Overleaf

ينتج هذا المثال المخرجات التالية:

![استخدام حزمة marginnote](/files/f7167a9e3b59ae9a3839c7d54194c195e18afdf8)

يحمّل المثال أعلاه أيضًا `geometry` الحزمة لإنشاء حجم صفحة صغير و `hyperref` الحزمة التي توفر `\url` الأمر المستخدم لإسناد المصدر إلى النص (في الحاشية السفلية). بعد استيراد `marginnote` الحزمة بكتابة `\usepackage{marginnote}` الحزمة، يمكنك استخدام `\marginnote` الأمر كما هو موضح في المثالين داخل النص:

* `\marginnote{هذه ملاحظة هامشية أُزيحت 2 سم إلى أسفل الصفحة، بالنسبة إلى السطر الذي تُنضَّد فيه.}[2cm]`
* `\marginnote{هذه ملاحظة هامشية أخرى لكنها أُزيحت 2 سم إلى أعلى الصفحة، بالنسبة إلى السطر الذي تُنضَّد فيه. وهي أيضًا في الهامش الأيسر.}[-2cm]`

في هذه الأمثلة نستخدم معلمة ثانية داخل الأقواس `[ ]` تحدد المحاذاة العمودية بالنسبة إلى السطر الذي يُستخدم فيه الأمر. الأولى `\margingnote` يستخدم الأمر `[2cm]` لإزاحة الملاحظة الهامشية 2 سم *إلى أسفل الصفحة*، وتستخدم الثانية `[-2cm]` لإزاحة الملاحظة الهامشية 2 سم *إلى أعلى الصفحة*.

الأمر الثاني `\marginnote` يعمل بعد استخدام `\reversemarginpar` ، مما يؤدي إلى وضعها في الهامش الأيسر لهذا المستند أحادي الوجه:

```latex
\reversemarginpar\marginnote{هذه ملاحظة هامشية أخرى لكنها أُزيحت 2 سم إلى أعلى الصفحة، بالنسبة إلى السطر الذي تُنضَّد فيه. وهي أيضًا في الهامش الأيسر.}[-2cm]
```

## قراءة إضافية

لمزيد من المعلومات، انظر

* [ال `marginnote` توثيق الحزمة](http://www.ctan.org/pkg/marginnote)
* [ال `mparhack` توثيق الحزمة](http://www.ctan.org/pkg/mparhack)
* [حجم الصفحة والهوامش](/latex/ar/altnsyq/07-page-size-and-margins.md)
* [الحواشي السفلية](/latex/ar/altnsyq/14-footnotes.md)
* [الأطوال في LaTeX](/latex/ar/altnsyq/01-lengths-in-latex.md)
* [المستندات أحادية الوجه ومزدوجة الوجه](/latex/ar/altnsyq/08-single-sided-and-double-sided-documents.md)
* [أعمدة متعددة](/latex/ar/altnsyq/09-multiple-columns.md)
* [الترويسات والتذييلات](/latex/ar/altnsyq/02-headers-and-footers.md)
* [تنسيق الفقرة](/latex/ar/altnsyq/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [الخط العريض والمائل والتحته خط](/latex/ar/asasyat-latex/03-bold-italics-and-underlining.md)
* [أحجام الخطوط، والعائلات، والأنماط](/latex/ar/alkhtwt/01-font-sizes-families-and-styles.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ar/altnsyq/15-margin-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.