> 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/aselh-latex/02-keep-track-of-your-labels-with-showlabels.md).

# تتبّع تسمياتك باستخدام showlabels

**المؤلف: جيمس ألين (يناير 2012)**

كلما كنت أكتب مستندات LaTeX طويلة أجد نفسي دائمًا أقفز ذهابًا وإيابًا في الشيفرة محاولًا تذكّر ما الذي سميتُ `\label`. لتجنب أن أفقد موضعي في الشيفرة أستخدم [`showlabels`](https://ctan.org/pkg/showlabels?lang=en) الحزمة التي تعرض اسم التسمية بجوار المعادلة المقابلة. عندها يمكنني النظر في ملف PDF حيث يكون العثور على المعادلة التي أبحث عنها أسهل، ولا أحتاج إلى التنقل هنا وهناك في الشيفرة. وهي تعمل مع تقريبًا كل ما يمكنك إسناد `\label` إليه تسمية. رائع!

**الاستخدام**

في المقدمة ضع:

```latex
\usepackage{showlabels}
```

**ناتج المثال**

![ShowlabelsExample.png](/files/23b56ea0c42709f6bdc7e68699ec25a75c9a1a0a)

**الخيارات**

يمكنك تزويد showlabels بخيار ليخبره أين يضع التسميات:

```latex
\usepackage[inline]{showlabels}
```

الخيارات المتاحة هي (مأخوذة من [الوثائق](https://ctan.org/pkg/showlabels?lang=en)):

* `الخارجي` \[افتراضي]—تُوضَع جميع الملاحظات في الهامش الخارجي للنص
* `الداخلي`—الهامش الداخلي
* `الأيسر`—الهامش الأيسر
* `الأيمن`—الهامش الأيمن
* `الهامشي` \[افتراضي]—وضع الملاحظات في الهامش
* `السطرية`—ضع الملاحظات داخل السطر قدر الإمكان، وتجاهل أيًا من خيارات وضع الهامش أعلاه
* `nolabel`—لا تُدرج ملاحظة هامشية لـ `\label` الأوامر
* `مسودة` \[افتراضي]—لا يفعل شيئًا، شريك لـ...
* `نهائي`—يعطّل جميع وظائف الحزمة

لاحظ أن `showlabels` يجب تضمينه بعد الحزم `amsmath` و `hyperref` ليعمل معها بشكل صحيح. راجع [التوثيق الرسمي (PDF)](http://mirrors.ctan.org/macros/latex/contrib/showlabels/showlabels.pdf) لمزيد من التفاصيل.


---

# 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/aselh-latex/02-keep-track-of-your-labels-with-showlabels.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.