> 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/qaadh-almarfh/138-understanding-underfull-and-overfull-box-warnings.md).

# فهم تحذيرات الصناديق غير الممتلئة والممتلئة أكثر من اللازم

## مقدمة

بعد تنضيد مستند LaTeX، غالبًا ما يعرض Overleaf رسائل تُفيد بوجود صندوق ناقص الامتلاء أو زائد الامتلاء `\hbox` (أو `\vbox`)، إلى جانب ما يُسمّى `درجة السوء` قيمًا للصناديق ناقصة الامتلاء أو مقادير مقدار تجاوز الصناديق للسعة. أولًا، من المهم ملاحظة أن هذه الرسائل ليست أخطاء—[انظر أدناه لمزيد من التفاصيل](#overfull-or-underfull-boxes-are-not-errors). إنها *تحذيرات* أو، بشكل أدق، «رسائل تشخيصية» تنشأ من داخل محرك TeX المستخدم لتنضيد مستند LaTeX الخاص بك.

في مقالة المساعدة هذه سنقدّم خلفية تمهيدية عن مصدر تلك الرسائل وسببها، وسنسرد بعض المشكلات الشائعة مع حلول مقترحة. وللقرّاء المهتمين بمزيد من التفاصيل، نشرنا مقالة مرافقة في معرض Overleaf: [استكشاف الصناديق ناقصة الامتلاء أو زائدة الامتلاء وحسابات درجة السوء](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). ويمكن أيضًا العثور على قائمة بموارد إضافية [في نهاية هذه المقالة](#further-reading).

## هل يحتوي مشروعي على تحذيرات بوجود صناديق زائدة الامتلاء أو ناقصة الامتلاء؟

للتحقق مما إذا كان مشروعك يبلغ عن هذه التحذيرات، ستحتاج إلى النقر على الأيقونة الموضحة في لقطة الشاشة أدناه. وحتى إذا تم تجميع مستندك من دون أخطاء، فمن الشائع جدًا رؤية هذه الرسائل، وقد يتساءل أي شخص جديد نسبيًا على TeX/LaTeX عمّا تعنيه وما إذا كان ينبغي أن يقلق بشأنها.

![صورة شاشة تُظهر Overleaf وهو يبلّغ عن صناديق ناقصة الامتلاء أو زائدة الامتلاء](/files/c1880e9b6259f0cbb97b149041dc99aab35b3223)

عند تنضيد مستند، سيحاول LaTeX أن يجعل أجزاء من المحتوى تناسب الحدود ضمن «حجم» معيّن؛ على سبيل المثال، عند تنضيد الفقرات وتقسيم الأسطر إلى طول معيّن—ويمكن توضيح ذلك بسهولة باستخدام أمر مثل `\parbox`. إذا حاولنا تنضيد الفقرة التالية باستخدام عرض سطر قدره 50 نقطة:

```latex
\parbox{50pt}{نصٌّ ما مُنضَّد باستخدام \texttt{\string\parbox}}
```

يُبلِّغ Overleaf عن تحذيرين من نوع `Underfull \hbox...` تحذيرين:

![صورة شاشة تُظهر Overleaf وهو يبلّغ عن صناديق ناقصة الامتلاء](/files/c7f7529431a73703db625a427cdd765293316802)

هذه `Underfull \hbox...` التحذيرات تنشأ لأن محرك TeX لا يستطيع إنتاج فواصل أسطر «مناسبة» ضمن القيود التي تفرضها هذه \parbox. داخل محركات TeX يصبح كل سطر من فقرة منضدة \hbox، ثم يفحصه المحرك لاحقًا ويبلّغ عنه، مما قد يولّد تحذيرات لأي أسطر من النص المنضّد يصنّفها محرك TeX على أنها «غير مرغوب فيها».

كما ترى في الصور التالية، فإن أسطر النص متباعدة جدًا، وTeX’s `Underfull \hbox...` تحذيرات TeX تُخبرك بذلك—مع أنه في هذا المثال يكون الأمر واضحًا بالفعل.

![صورة شاشة تُظهر parbox](/files/51ba56c5b23151ddbd750c1a38ccf9a2ba1a1d87)

ملاحظة: في هذا المثال يمكنك تجنّب هذه التحذيرات باستخدام \raggedright:

```latex
\parbox{50pt}{\raggedright نصٌّ ما مُنضَّد باستخدام \texttt{\string\parbox}}
```

![صورة شاشة تُظهر parbox](/files/9c88102f34289b810b3e4b158cd6521f9f12253c)

## الصناديق زائدة الامتلاء أو ناقصة الامتلاء

ال `\parbox` يوضح المثال مشكلةً أكثر عمومية بكثير: عند معالجة شيفرة LaTeX الخاصة بك قد يرى محرك TeX المستخدم لتنضيد مستندك (pdfTeX أو XeTeX أو LuaTeX) أن طلبات LaTeX تؤدي إلى محتوى منضّد لا «يناسب بشكل جميل» حدود الصندوق الموفَّر أو المطلوب. إذا حدث ذلك، يصدر محرك TeX تحذيرات ويُتنضَّد المحتوى، لكن النتيجة قد لا تكون، أحيانًا، مستحسنة من الناحية الجمالية، وربما تحتاج إلى إصلاحها. ومن المفيد فهم معنى تلك الرسائل والتعرّف إلى متى تحتاج إلى اتخاذ إجراء لمعالجتها.

تأتي هذه التحذيرات المتعلقة بالصناديق بالشكل التالي

```
Overfull \hbox (<value>pt أعرض من اللازم) ... عند السطر(الأسطر) ...
Overfull \vbox (<value>pt أعلى من اللازم) ... عند السطر(الأسطر) ...
Underfull \hbox (badness <value> ) ... عند السطر(الأسطر) ...
Underfull \vbox (badness <value>) ... عند السطر(الأسطر) ...
```

الم `\hbox` يشير إلى *صندوق أفقي* يضع فيه محرك TeX قائمة من العناصر جنبًا إلى جنب، و `\vbox` يشير إلى *صندوق رأسي* يرصّ فيه محرك TeX العناصر واحدًا فوق الآخر.

إذا كان هناك قدرٌ قليل جدًا من المادة، فسيبلغ محرك TeX عن `تحذير Underfull \hbox` أو `تحذير Underfull \vbox` تحذير:

* **الصناديق ناقصة الامتلاء** لا تحتوي على مادة كافية لملء أبعاد (الصندوق) المخصّصة لاحتوائها، وكان على محرك TeX أن «يمدّ» المحتوى في محاولته لملء تلك المساحة. وبالنسبة إلى الصناديق ناقصة الامتلاء سيعرض Overleaf أيضًا ما يُسمّى «درجة السوء» في TeX (`badness <value>` )، وهي مقياس لمدى حاجة TeX إلى «تمديد» المحتوى لملء المساحة المخصّصة له. تتراوح قيم badness عادةً من 0 إلى 10000.

إذا كان هناك قدرٌ كبير جدًا من المادة، فسيبلغ محرك TeX عن تحذير \`Overfull \hbox\` أو تحذير \`Overfull \vbox\`:

* **الصناديق زائدة الامتلاء** تحتوي على محتوى أكثر من اللازم ليلائم أبعاد (الصندوق) المخصّصة لاحتوائه، ولا يستطيع TeX «حشره» في المساحة المتاحة. ويبلغ محرك TeX عن مقدار التجاوز (`<value>` )، بالنقاط، الذي يتجاوز به المحتوى المساحة المتاحة—فالمادة أعرض من اللازم بالنسبة إلى `\hbox` أو أعلى من اللازم بالنسبة إلى `\vbox`.

## الصناديق زائدة الامتلاء أو ناقصة الامتلاء ليست أخطاء

كما ذُكر، فإن رسائل overfull/underfull `\hbox` أو `\vbox` ليست أخطاء، بل «رسائل تحذير تشخيصية» يصدرها محرك TeX (pdfTeX أو XeTeX أو LuaTeX) المستخدم لتنضيد مستند LaTeX الخاص بك. وعلى الرغم من أن *تُبلّغ عنها* لك عبر Overleaf، فإن هذه التحذيرات ليست *المُولَّد* من Overleaf: فهي تنشأ من داخل محركات TeX. أثناء التنضيد، تُكتب هذه الرسائل إلى ملف `.log` —وهو ملف نصي يُنتجه محرك TeX لتسجيل مجموعة من المعلومات أثناء معالجته لشيفرة LaTeX الخاصة بك. يعالج Overleaf الملف `.log` لاستخراج رسائل التحذير الخاصة بالصناديق overfull/underfull الصادرة عن محرك TeX `\hbox` أو `\vbox` ويعرضها داخل واجهة Overleaf. وهذا يساعدك على تحديد أجزاء من مستندك التي قد تحتاج إلى تحرير للحصول على أفضل نتيجة ممكنة بعد التنضيد.

## هل ينبغي أن أقلق من هذه التحذيرات؟

قد ينزعج المستخدمون الجدد على TeX/LaTeX من هذه التحذيرات ويتساءلون عمّا إذا كانت تشير إلى مشكلة خطيرة في مستندهم، لكن غالبًا ما يمكن تجاهل معظمها بأمان. ومع ذلك، فإن هذه التحذيرات تبرز أحيانًا جزءًا من مستندك يحتاج فعلًا إلى المراجعة وقد يحتاج إلى تحرير لتحسين نتائج التنضيد الظاهرة.

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

## كيف يمكنني العثور على مصدر التحذير؟

1. من داخل واجهة Overleaf، انقر على رسالة التحذير وسينتقل المحرر إلى الموضع المناسب في شيفرة LaTeX المصدرية الخاصة بك.
2. إلى يسار الموضع في شيفرة المصدر ستجد مثلثًا أصفر صغيرًا يحتوي على علامة تعجب (!).
3. إذا مرّرت مؤشر الفأرة فوق المثلث فسيعرض Overleaf رسالة التحذير.

يوضح مقطع الفيديو القصير هذا الخطوات المذكورة أعلاه.

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/1S1CW2vbVGRHnCXmsbjgAX/096e314caba0c1bafb762a528761e24d/findwarning.mp4>" %}

## كيف يمكنني العثور على الموضع في ملف PDF المقابل لشيفرة LaTeX الخاصة بي؟

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

![صورة شاشة تُظهر parbox](/files/94ceff335a8dd3e667868cd37173c8c0e8c39963)

إذا لم ترَ هذه الأسهم، فمقالة المساعدة لدينا [كيفية الانتقال إلى شيفرة المصدر من ملف PDF المنضّد (SyncTeX)](/latex/ar/qaadh-almarfh/069-how-to-jump-to-the-source-code-from-the-typeset-pdf-synctex.md) توضح كيفية تفعيلها.

## المشكلات الشائعة وكيفية إصلاحها

* يمكنك استخدام [حزمة microtype](https://ctan.org/pkg/microtype?lang=en) التي تستفيد من الامتدادات الدقيقة في التنضيد التي قدّمها pdfTeX—فتنتج تنضيدًا أعلى جودة، وقد تؤدي أيضًا إلى عدد أقل من الصناديق السيئة.
* إذا كانت لديك مشكلات مع عناوين URL وفواصل الأسطر، فيمكنك إضافة الخيار `breaklinks` إلى `hyperref` الحزمة: `\usepackage[breaklinks]{hyperref}`.
* مثل `\parbox`, `minipage` قد تؤدي البيئات إلى ظهور تحذيرات بصناديق زائدة الامتلاء أو ناقصة الامتلاء عندما يحاول محرك TeX تقسيم الفقرات إلى أسطر:

```latex

\begin{minipage}{width}
نص...
\end{minipage}
```

إذا أمكن، فزِد قيمة `width` لإعطاء محرك TeX فرصة أفضل لإنتاج فواصل أسطر جيدة—و/أو استخدم [حزمة microtype](https://ctan.org/pkg/microtype?lang=en).

### ملاحظات حول استخدام \\\\

`\\` هو ماكرو (رمز تحكّم) يمكن أن يعتمد تعريفه الدقيق على السياق الذي يُستخدم فيه—ويمكن العثور على نقاش/شرح ممتاز لهذا في هذا [الجواب على tex.stackexchange](https://tex.stackexchange.com/a/55481).

* `\\` لا ينبغي استخدامه لإضافة مسافة عمودية بين الفقرات—فذلك يُعد ممارسة سيئة جدًا.
* `\\` هو مخصّص لفواصل الأسطر فقط (مشابهًا لـ Shift-Enter في Microsoft Word). والطريقة الصحيحة لإنشاء فقرة جديدة في LaTeX هي فصل فقراتك بأسطر فارغة في شيفرة المصدر.
* بدلًا من استخدام `\\` (أو `\newline`/`\vspace`) لمحاكاة فواصل الفقرات، أو لزيادة المسافة بين الفقرات، فإن الحل الموصى به لضبط المسافة بين الفقرات هو تحميل [parskip](https://ctan.org/pkg/parskip) الحزمة: أضف `\usepackage{parskip}` في مقدمة مستندك.
* استخدام `\\` في جميع فقرات المستند يمكن أن يتداخل مع خوارزميات LaTeX التي تحسب المواقع المثلى لوضع العناصر العائمة، وتقسيم الصفحات، إلخ، وقد يتسبب في أخطاء ترجمة في مستند كبير.
* الاستخدام المشروع لـ `\\` مُفسَّر في إجابات على [tex.stackexchange](https://tex.stackexchange.com/). على سبيل المثال، انظر:
  * [متى تستخدم `\par` ومتى `\\`, `\newline`، أو الأسطر الفارغة](https://tex.stackexchange.com/a/82666)
  * [ماذا يفعل `\\*` ؟](https://tex.stackexchange.com/a/55481)

## التحكم في الصناديق التي يبلّغك بها TeX

توفر محركات TeX عددًا من الأوامر البدائية منخفضة المستوى التي يمكنك استخدامها لتوجيه استدلالات TeX وتحديد قيمة عتبة لمدى «سوء» الصندوق قبل أن يبلغ عنه TeX. إليك بعض الروابط للقراء المهتمين بتلك الأوامر:

* [\hfuzz and \vfuzz](/latex/ar/bdaeyat-tex-latex/06-hfuzz.md)
* [\hbadness and \vbadness](/latex/ar/bdaeyat-tex-latex/05-hbadness.md)

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

للمزيد من القراءة الخلفية حول استخدام TeX للصناديق والغراء، يُحال القارئ المهتم إلى هذه الموارد:

* مقالة Overleaf [كيف يحسب TeX إعدادات الغراء في \hbox](/latex/ar/mqalat-mtamqh/24-how-tex-calculates-glue-settings-in-an-hbox.md).
* مقالة Overleaf من 17 صفحة كُتبت لترافق عنصر المساعدة هذا: [استكشاف الصناديق ناقصة الامتلاء أو زائدة الامتلاء وحسابات درجة السوء](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). وتناقش تلك المقالة أيضًا بدائيات TeX `\hfuzz` و `\hbadness`.
* الأسئلة الشائعة لـ TeX على <https://texfaq.org/FAQ-overfull.html>.
* [tex.stackexchange](https://tex.stackexchange.com/) تحتوي على ثروة من النصائح من أبرز خبراء TeX/LaTeX.


---

# 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/qaadh-almarfh/138-understanding-underfull-and-overfull-box-warnings.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.