> 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/bdaeyat-tex-latex/08-pdfinclusionerrorlevel.md).

# \pdfinclusionerrorlevel

`\pdfinclusionerrorlevel[=]` *عدد صحيح*

يُستخدم هذا الأمر للتحكم في سلوك محرك TEX عندما يتم تضمين ملف PDF له إصدار أحدث من الإصدار المحدد بواسطة [`\pdfminorversion`](/latex/ar/bdaeyat-tex-latex/09-pdfminorversion.md).

* “`[=]`” تعني أن علامة يساوي اختيارية.

**أمثلة على الاستخدام**

* `\pdfinclusionerrorlevel=-1` (أو أي شيء $$<0$$): لا يقدم أي معلومات تشخيصية.
* `\pdfinclusionerrorlevel=0` (افتراضي): يتسبب في أن يصدر محرك TEX تحذيرًا.
* `\pdfinclusionerrorlevel=1`: يتسبب في أن يُصدر محرك TEX خطأً.

#### \pdfinclusionerrorlevel: معلومات أساسية

منذ أن نُشر لأول مرة في تسعينيات القرن الماضي، فإن [تنسيق ملف PDF](https://en.wikipedia.org/wiki/PDF) لقد خضع للعديد من المراجعات والتحسينات التي تؤدي دوريًا إلى نشر إصدار جديد من مواصفة PDF الرسمية. وبالتالي، فإن أي ملف PDF، بما في ذلك تلك التي تنتجها محركات TEX، سيمتثل لإصدار معين من مواصفة PDF — مثل PDF الإصدار 1.4 أو 1.5 إلخ. يحتوي كل ملف PDF على بيانات تحدد إصدار مواصفة PDF الذي يلتزم به الملف — بحيث تعرف أي تطبيق يرغب في «استهلاك» ملف PDF (مثل الاستيراد أو المعالجة إلخ) مجموعة ميزات PDF التي يُرجح وجودها داخل ذلك الملف.

إذا كان مستند TEX الخاص بك يستورد رسماً في تنسيق PDF، على سبيل المثال عبر `\includegraphics`، فقد يتوافق ذلك الملف الرسومي مع مواصفة PDF أحدث (لاحقة) من تلك التي يدعمها ملف PDF الناتج من محرك TeX نفسه. ومن الواضح أن هذا قد يؤدي إلى «تعارض» بين إصدار PDF الذي يولده محرك TEX وإصدار PDF المستخدم بواسطة إحدى الرسومات المستوردة. وعلى سبيل المثال، قد يتوافق المستند المنسق الناتج عن محرك TEX مع إصدار PDF 1.4، بينما يتوافق رسم مستورد مع PDF 1.5، مثلاً. وإذا جرى تضمين ذلك الرسم المستورد مباشرةً دون أي إجراء إضافي، فمن الواضح أن ملف PDF الناتج عن TEX لن يعود متوافقًا مع PDF 1.4 لأنه أصبح الآن يحتوي على محتوى رسومي يستند إلى مواصفة PDF 1.5. إن `\pdfinclusionerrorlevel` يساعد هذا الأمر في إدارة ذلك.


---

# 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/bdaeyat-tex-latex/08-pdfinclusionerrorlevel.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.