> 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/alaselh-walajwbh/04-can-i-add-inline-or-margin-comments-to-the-pdf.md).

# هل يمكنني إضافة تعليقات ضمن النص أو في الهامش إلى ملف PDF؟

نعم، يمكنك استخدام [`todonotes` الحزمة](https://ctan.org/pkg/todonotes?lang=en) (المذكورة هنا) أو اقرأ صفحة المساعدة الخاصة بنا حول [ملاحظات الهامش](/latex/ar/altnsyq/15-margin-notes.md)، التي تناقش [`\marginpar` الأمر](/latex/ar/altnsyq/15-margin-notes.md#the-5cmarginpar-command) و [`marginnote` الحزمة](/latex/ar/altnsyq/15-margin-notes.md#an-alternative-to-5cmarginpar-the-marginnote-package).

## تحميل حزمة todonotes

لاستخدام `todonotes` الحزمة، أضف السطر التالي إلى مقدمة مستندك:

```latex
\usepackage[colorinlistoftodos]{todonotes}
```

ال `colorinlistoftodos` يضيف الخيار مربعات صغيرة ملوّنة إلى قائمة ملاحظات المهام (انظر أدناه)، مما يساعد على التمييز بين الأنواع المختلفة.

* **ملاحظة**: يُنصح القراء بشدة بتصفح [`todonotes` الوثائق](http://mirrors.ctan.org/macros/latex/contrib/todonotes/todonotes.pdf) للحصول على معلومات حول خيارات الحزمة، والأوامر المفيدة، والأمثلة النافعة.

استخدم الأمر التالي لإضافة تعليق:

```latex
\todo{هذا تعليق سيظهر في الهامش}
```

## مثال باستخدام حزمة todonotes

فيما يلي مثال أساسي لمساعدتك على البدء: فهو يوضح أنماط ملاحظات مختلفة وينتج قائمة بملاحظات المهام عبر الأمر

```latex
\listoftodos[عنوان قائمتك...]
```

الذي يأخذ وسيطًا اختياريًا، محصورًا في `[...]`، ويُستخدم لتنسيق عنوان لقائمة الملاحظات.

```latex
\documentclass[a4paper]{article}
\usepackage[colorlinks]{hyperref}
\usepackage[colorinlistoftodos]{todonotes}
\begin{document}
\listoftodos[قائمة بالأشياء التي أحتاج إلى إنهائها]

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nulla
\todo{ملاحظات todonotes العادية.} urna. Maecenas interdum nunc in augue.
Mauris quis massa in ante tincidunt mollis. Proin imperdiet.
Donec porttitor pede id est. Sed in ante. Integer id arcu. Nam
lectus nisl, posuere sit amet, imperdiet ut, tristique ac, lorem.
In erat. In commodo enim. \todo[color=blue!40]{ملاحظة todonote بلون مختلف.}%
Phasellus libero ipsum, tempor a, pharetra consequat, pellentesque
sit amet, sem. Praesent ut augue luctus elit adipiscing ultricies.
Vestibulum suscipit cursus leo. Nullam molestie justo.

Morbi dui. Morbi convallis mi sed sem. Nulla convallis lacus vitae
risus. Phasellus adipiscing. Nullam tortor. Sed laoreet aliquam
ante. Vestibulum diam. Pellentesque nec leo. Pellentesque velit.
\todo[nolist]{ملاحظة todonote تظهر فقط في الهامش وليست في
قائمة ملاحظات المهام.}%
Praesent congue mi eu ipsum cursus fringilla. Etiam leo erat,
tristique et, pharetra eget, mollis vitae, velit. In hac habitasse
\todo[size=\small, color=green!40]{ملاحظة بحجم خط صغير.}%
platea dictumst. In quam nibh, facilisis et, laoreet non, facilisis
tempus, justo. Class aptent taciti sociosqu ad litora torquent per
conubia nostra, per inceptos himenaeos.

\todo[inline]{اختبار اختبار}

Donec nulla lectus, faucibus sit amet, auctor non, consectetuer
quis, pede. Nullam dictum. Nullam suscipit, ligula in scelerisque
\todo[noline]{ملاحظة بدون خط يعود إلى النص.}%
posuere, sapien purus rutrum magna, vitae pharetra leo quam vel
tortor. Donec eleifend condimentum sapien. Etiam sed orci. Aliquam
\todo[inline, color=red!50]{ملاحظات todonotes ضمن السطر.}%
tempor. Pellentesque egestas tortor id eros. Donec mauris justo,
commodo id, pellentesque id, eleifend non, mi. Duis venenatis
sagittis metus. Donec tempus metus id lacus. Praesent vel diam.
Morbi nec ante. Vestibulum varius felis ac lacus. Nulla vitae neque
\todo[inline, color=green!40]{ملاحظة بدون خط يعود إلى النص.}%
in nibh bibendum volutpat. Quisque accumsan diam. Aenean ultricies
nisl ac lacus. Aliquam posuere. Aenean venenatis tortor in felis.
\end{document}
```

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

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

![عرض حزمة todonotes على Overleaf](/files/f61b630333f9462aab037a638f7dc3d24d4a5150)

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

* ال [`todonotes` الوثائق](http://mirrors.ctan.org/macros/latex/contrib/todonotes/todonotes.pdf) تحتوي على معلومات حول خيارات الحزمة، والأوامر المفيدة، والأمثلة النافعة.
* صفحة مساعدة Overleaf حول [ملاحظات الهامش](/latex/ar/altnsyq/15-margin-notes.md) تتناول [`\marginpar` الأمر](/latex/ar/altnsyq/15-margin-notes.md#the-5cmarginpar-command) و [`marginnote` الحزمة](/latex/ar/altnsyq/15-margin-notes.md#an-alternative-to-5cmarginpar-the-marginnote-package).


---

# 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/alaselh-walajwbh/04-can-i-add-inline-or-margin-comments-to-the-pdf.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.