> 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/fr/base-de-connaissances/138-understanding-underfull-and-overfull-box-warnings.md). # Comprendre les avertissements de boîtes sous-remplies et surremplies ## Introduction Après la composition d’un document LaTeX, Overleaf affiche souvent des messages signalant une boîte sous-remplie ou surremplie `\\hbox` (ou `\\vbox`), ainsi que les soi-disant `badness` valeurs pour des boîtes sous-remplies ou des montants par lesquels des boîtes sont surremplies. Tout d’abord, il est important de noter que ces messages ne sont pas des erreurs —[voir ci-dessous pour plus de détails](#overfull-or-underfull-boxes-are-not-errors). Ce sont *des avertissements* ou, plus correctement, des « messages de diagnostic » qui proviennent de l’intérieur du moteur TeX utilisé pour composer votre document LaTeX. Dans cet article d’aide, nous fournirons quelques éléments de contexte introductifs sur la source et la cause de ces messages et listerons quelques problèmes courants avec des solutions suggérées. Pour les lecteurs souhaitant davantage de détails, nous avons publié un article d’accompagnement dans la galerie Overleaf : [Explorer les boîtes sous-remplies ou surremplies et les calculs de badness](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). Une liste de ressources supplémentaires se trouve également [à la fin de cet article](#further-reading). ## Mon projet comporte-t-il des avertissements de boîtes trop remplies ou sous-remplies ? Pour vérifier si votre projet signale ces avertissements, vous devrez cliquer sur l’icône montrée dans la capture d’écran ci-dessous. Même si votre document a pu être compilé sans erreur, il est très courant de voir ces messages et toute personne assez novice en TeX/LaTeX pourrait se demander ce qu’ils signifient et s’il faut s’en inquiéter. ![Capture d’écran montrant Overleaf signalant des boîtes sous-remplies ou surremplies](/files/d89fc26872bdcc35dd4e62dd080e1fe2b8a68b2e) Lors de la composition d’un document, LaTeX essaiera de faire en sorte que des parties de votre contenu s’insèrent dans les limites d’une certaine « taille » ; par exemple, lors de la composition de paragraphes et du retour à la ligne sur une certaine longueur — ce qui se démontre le plus facilement à l’aide d’une commande telle que `\\parbox`. Si nous essayons de composer le paragraphe suivant avec une largeur de ligne de 50 pt : ```latex \\parbox{50pt}{Du texte composé à l’aide d’une \\texttt{\\string\\parbox}} ``` Overleaf signale deux `Avertissements « Underfull \\hbox... »` avertissements : ![Capture d’écran montrant Overleaf signalant des boîtes sous-remplies](/files/fa76611f1a7f81d4a7130431158a94a2bf5cc233) Ces `Avertissements « Underfull \\hbox... »` avertissements apparaissent parce que le moteur TeX ne peut pas produire de sauts de ligne « jolis » dans les contraintes de cette \\\parbox. À l’intérieur des moteurs TeX, chaque ligne d’un paragraphe composé devient une \\\hbox, que le moteur vérifiera ensuite et à propos de laquelle il fera un rapport, pouvant générer des avertissements pour toute ligne de texte composée que le moteur TeX classe comme « non souhaitable ». Comme vous pouvez le voir sur les images suivantes, les lignes de texte sont extrêmement espacées et les avertissements de TeX vous l’indiquent — même si, dans cet exemple, cela est clairement visible. `Avertissements « Underfull \\hbox... »` Capture d’écran montrant une parbox ![Notez que, pour cet exemple, vous pouvez éviter ces avertissements en utilisant \\\raggedright :](/files/dd82b353a998edfb06650708594d096cfa10faa5) \\\parbox{50pt}{\\\raggedright Du texte composé à l’aide d’une \\\texttt{\\\string\\\parbox}} ```latex \\parbox{50pt}{\\raggedright Du texte composé à l’aide d’une \\texttt{\\string\\parbox}} ``` ![Notez que, pour cet exemple, vous pouvez éviter ces avertissements en utilisant \\\raggedright :](/files/dd207064cafcb0b7f14ca5b015505ca18d9debbb) ## Boîtes trop remplies et sous-remplies Le `\\parbox` Cet exemple illustre un problème beaucoup plus général : lors du traitement de votre code LaTeX, le moteur TeX utilisé pour composer votre document (pdfTeX, XeTeX ou LuaTeX) peut considérer que les requêtes de LaTeX aboutissent à un contenu composé qui ne « s’insère pas bien » dans les limites de la boîte fournie ou demandée. Si tel est le cas, le moteur TeX émet des avertissements et votre contenu sera composé, mais le résultat peut, à l’occasion, ne pas être esthétiquement satisfaisant et vous devrez probablement le corriger. Il vaut la peine de comprendre la signification de ces messages et de reconnaître quand vous devez agir pour y remédier. Ces avertissements liés aux boîtes prennent la forme ``` Overfull \\hbox (pt trop large) ... à la/aux ligne(s) ... Overfull \\vbox (pt trop haute) ... à la/aux ligne(s) ... Underfull \\hbox (badness ) ... à la/aux ligne(s) ... Underfull \\vbox (badness ) ... à la/aux ligne(s) ... ``` Une `\\hbox` désigne une *boîte horizontale* dans laquelle un moteur TeX place une liste d’éléments côte à côte et `\\vbox` désigne une *boîte verticale* dans laquelle le moteur TeX empile les éléments les uns au-dessus des autres. S’il y a trop peu de contenu, le moteur TeX signalera un `Underfull \\hbox` avertissement ou `Underfull \\vbox` avertissement : * **Boîtes sous-remplies** ne contiennent pas suffisamment de contenu pour remplir les dimensions (de la boîte) allouées pour l’accueillir et le moteur TeX a dû « étirer » le contenu pour tenter de remplir cet espace. Pour les boîtes sous-remplies, Overleaf signalera également le soi-disant « badness » de TeX (`badness `) qui mesure à quel point TeX a dû « étirer » votre contenu pour remplir l’espace qui lui était réservé. Les valeurs de badness vont normalement de 0 à 10000. S’il y a trop de contenu, le moteur TeX signalera un avertissement \`Overfull \\\hbox\` ou un avertissement \`Overfull \\\vbox\` : * **Boîtes surremplies** contiennent trop de contenu pour tenir dans les dimensions (de la boîte) allouées pour l’accueillir et TeX ne peut pas le « comprimer » dans l’espace fourni. Le moteur TeX indique la quantité (``), en points, de laquelle votre contenu dépasse l’espace disponible — votre contenu est trop large pour une `\\hbox` ou trop haut pour une `\\vbox`. ## Les boîtes surremplies ou sous-remplies ne sont pas des erreurs Comme indiqué, les `\\hbox` ou `\\vbox` messages ne sont pas des erreurs mais des « messages d’avertissement de diagnostic » produits par le moteur TeX (pdfTeX, XeTeX ou LuaTeX) utilisé pour composer votre document LaTeX. Bien que *signalés* par Overleaf, ces avertissements ne sont pas *généré* par Overleaf : ils proviennent de l’intérieur des moteurs TeX. Pendant la composition, ces messages sont écrits dans le `.log` fichier — un fichier texte produit par le moteur TeX pour enregistrer diverses informations lorsqu’il traite votre code LaTeX. Overleaf traite le `.log` fichier afin d’extraire les messages d’avertissement overfull/underfull du moteur TeX `\\hbox` ou `\\vbox` et les affiche dans l’interface Overleaf. Cela vous aide à localiser et à identifier les parties de votre document qui pourraient nécessiter des modifications afin d’obtenir le meilleur résultat typographique possible. ## Dois-je m’inquiéter de ces avertissements ? Les utilisateurs qui découvrent TeX/LaTeX peuvent être préoccupés par ces avertissements et se demander s’ils indiquent un problème grave dans leur document, mais il est souvent possible d’en ignorer la plupart sans risque. Cependant, ces avertissements mettent parfois en évidence une partie de votre document qui doit effectivement être vérifiée et qui peut nécessiter des modifications pour améliorer le rendu typographique visible. Il faut parfois un peu de pratique pour interpréter ces messages ; si vous débutez avec TeX/LaTeX, il vaut donc la peine de prendre le temps de développer votre expérience en localisant l’endroit de votre code source qui a généré l’avertissement. En procédant ainsi, vous apprendrez vite à repérer les avertissements qui signalent vraiment des problèmes auxquels vous devrez peut-être remédier. ## Comment puis-je trouver l’origine de l’avertissement ? 1. Depuis l’interface Overleaf, cliquez sur un message d’avertissement et l’éditeur fera défiler le code jusqu’à l’emplacement approprié dans votre code source LaTeX. 2. À gauche de l’emplacement dans votre code source, il y aura un petit triangle jaune contenant un point d’exclamation (!). 3. Si vous placez le pointeur de votre souris sur le triangle, Overleaf affichera le message d’avertissement. Ce court extrait vidéo montre les étapes ci-dessus. {% embed url="" %} ## Comment puis-je trouver l’emplacement dans le PDF correspondant à mon code LaTeX ? Après avoir localisé le code LaTeX qui a généré un avertissement particulier, vous pouvez accéder à la position appropriée dans le PDF en utilisant les flèches situées sur la barre de séparation entre les panneaux contenant l’éditeur et le PDF composé. ![Notez que, pour cet exemple, vous pouvez éviter ces avertissements en utilisant \\\raggedright :](/files/dd3b916e93dedfcf400336266d31757d7f6945c1) Si vous ne voyez pas ces flèches, notre article d’aide [Comment accéder au code source depuis le PDF composé (SyncTeX)](/latex/fr/base-de-connaissances/069-how-to-jump-to-the-source-code-from-the-typeset-pdf-synctex.md) explique comment les activer. ## Problèmes courants et comment les corriger * Vous pouvez utiliser la [paquet microtype](https://ctan.org/pkg/microtype?lang=en) qui exploite les extensions microtypographiques introduites par pdfTeX — produisant une composition de meilleure qualité, ce qui peut aussi entraîner moins de boîtes problématiques. * Si vous rencontrez des problèmes avec les URL et les sauts de ligne, vous pouvez ajouter l’option `breaklinks` au `paquet hyperref` package : `\\usepackage[breaklinks]{hyperref}`. * Comme `\\parbox`, `minipage` les environnements peuvent donner lieu à des avertissements de boîtes surremplies ou sous-remplies lorsque le moteur TeX essaie de couper les paragraphes en lignes : ```latex \\begin{minipage}{width} texte... \\end{minipage} ``` Si possible, augmentez la valeur de `width` afin de donner au moteur TeX de meilleures chances de produire de bons retours à la ligne — et/ou utilisez le [paquet microtype](https://ctan.org/pkg/microtype?lang=en). ### Remarques sur l’utilisation de \\\\\\\\ `\\\\` est une macro (un symbole de contrôle) dont la définition précise peut dépendre du contexte dans lequel elle est utilisée — une excellente discussion/explication peut être trouvée dans cette [réponse sur tex.stackexchange](https://tex.stackexchange.com/a/55481). * `\\\\` ne doit pas être utilisé pour ajouter de l’espace vertical entre les paragraphes — c’est considéré comme une très mauvaise pratique. * `\\\\` est destiné uniquement aux sauts de ligne (similaire à Maj+Entrée dans Microsoft Word). La bonne façon de créer un nouveau paragraphe en LaTeX est de séparer vos paragraphes par des lignes vides dans le code source. * Au lieu d’utiliser `\\\\` (ou `\\newline`/`\\vspace`) pour simuler des sauts de paragraphe, ou pour augmenter l’espacement entre les paragraphes, la solution recommandée pour définir l’espacement entre les paragraphes est de charger le [paquet parskip](https://ctan.org/pkg/parskip) : placez `\\usepackage{parskip}` dans le préambule de votre document. * Utiliser `\\\\` partout dans les paragraphes du document peut interférer avec les algorithmes de LaTeX qui calculent les emplacements optimaux pour placer les flottants, couper les pages, etc., et peut provoquer des erreurs de compilation dans un document volumineux. * L’utilisation légitime de `\\\\` est expliquée dans des réponses sur [tex.stackexchange](https://tex.stackexchange.com/). Par exemple, voir : * [Quand utiliser `\\par` et quand `\\\\`, `\\newline`, ou des lignes vides](https://tex.stackexchange.com/a/82666) * [Que fait `\\\\*` ?](https://tex.stackexchange.com/a/55481) ## Contrôler quelles boîtes TeX vous signale Les moteurs TeX fournissent un certain nombre de commandes primitives de bas niveau que vous pouvez utiliser pour guider les heuristiques de TeX et définir une valeur seuil à partir de laquelle une boîte doit être considérée comme « mauvaise » pour que TeX la signale. Voici quelques liens pour les lecteurs intéressés par ces commandes : * [\\\hfuzz et \\\vfuzz](/latex/fr/primitifs-tex-latex/06-hfuzz.md) * [\\\hbadness et \\\vbadness](/latex/fr/primitifs-tex-latex/05-hbadness.md) ## Lectures complémentaires Pour approfondir l’utilisation des boîtes et du glue par TeX, le lecteur intéressé est invité à consulter ces ressources : * L’article Overleaf [Comment TeX calcule les réglages de glue dans une \\\hbox](/latex/fr/articles-approfondis/24-how-tex-calculates-glue-settings-in-an-hbox.md). * Un article Overleaf de 17 pages rédigé pour accompagner cette page d’aide : [Explorer les boîtes sous-remplies ou surremplies et les calculs de badness](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). Cet article traite également des primitives TeX `\\hfuzz` et `\\hbadness`. * La FAQ TeX à l’adresse . * [tex.stackexchange](https://tex.stackexchange.com/) contient une mine de conseils de la part de grands experts 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/fr/base-de-connaissances/138-understanding-underfull-and-overfull-box-warnings.md?ask=&goal= ``` `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.