> 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/it/base-di-conoscenza/138-understanding-underfull-and-overfull-box-warnings.md). # Comprendere gli avvisi di box underfull e overfull ## Introduzione Dopo la composizione di un documento LaTeX, Overleaf mostrerà spesso messaggi che segnalano un box \hbox sottopieno o sovrappieno `\hbox` (oppure `\vbox`), insieme ai cosiddetti `badness` valori per i box sottopieni o la quantità di cui i box sono sovrappieni. Innanzitutto, è importante notare che questi messaggi non sono errori—[vedi sotto per maggiori dettagli](#overfull-or-underfull-boxes-are-not-errors). Sono *avvisi* o, più correttamente, “messaggi diagnostici” che provengono dall’interno del motore TeX utilizzato per comporre il tuo documento LaTeX. In questo articolo di supporto forniremo alcune informazioni introduttive sulla fonte e sulla causa di questi messaggi ed elencheremo alcuni problemi comuni con soluzioni suggerite. Per i lettori interessati a maggiori dettagli, abbiamo pubblicato un articolo complementare nella Galleria di Overleaf: [Esplorare i box sottopieni o sovrappieni e i calcoli di badness](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). È inoltre possibile trovare un elenco di risorse aggiuntive [alla fine di questo articolo](#further-reading). ## Il mio progetto presenta avvisi di sovrappieno o sottopieno? Per verificare se il tuo progetto segnala questi avvisi, dovrai fare clic sull’icona mostrata nella schermata qui sotto. Anche se il documento può essere stato compilato senza errori, è molto comune vedere questi messaggi e chiunque sia abbastanza nuovo a TeX/LaTeX potrebbe chiedersi cosa significhino e se debba preoccuparsene. ![Immagine dello schermo che mostra Overleaf che segnala box sottopieni o sovrappieni](/files/03f421d55ca2b3a6331a84c1376ccc7661de9c94) Quando compone un documento, LaTeX cercherà di fare in modo che parti del contenuto rientrino nei confini di una certa “dimensione”; per esempio, quando compone paragrafi e spezza le righe in una lunghezza determinata—come si dimostra più facilmente usando un comando come `\parbox`. Se proviamo a comporre il seguente paragrafo usando una larghezza di riga di 50pt: ```latex \parbox{50pt}{Testo composto utilizzando una \texttt{\string\parbox}} ``` Overleaf segnala due `Avvisi Underfull \hbox...` avvisi: ![Immagine dello schermo che mostra Overleaf che segnala box sottopieni](/files/2dc604c78d9c02c6c23c9a734a8414922be14fb8) Questi `Avvisi Underfull \hbox...` Questi avvisi sorgono perché il motore TeX non riesce a produrre interruzioni di riga “gradevoli” entro i vincoli di questa \parbox. All’interno dei motori TeX ogni riga di un paragrafo composto diventa un \hbox, che il motore controllerà e segnalerà successivamente, generando potenzialmente avvisi per qualsiasi riga di testo composto che il motore TeX classifichi come “non desiderabile”. Come puoi vedere nelle immagini seguenti, le righe di testo sono estremamente distanziate e gli avvisi di TeX `Avvisi Underfull \hbox...` ti segnalano questo—sebbene, in questo esempio, sia chiaramente visibile. ![Immagine dello schermo che mostra una parbox](/files/e872273c605169cf01546ffe7c9ff430ed0bef3a) Nota: per questo esempio puoi evitare questi avvisi usando \raggedright: ```latex \parbox{50pt}{\raggedright Testo composto utilizzando una \texttt{\string\parbox}} ``` ![Immagine dello schermo che mostra una parbox](/files/4cd46b4f4dd8fe425a187236bb3d4ed5d736d00c) ## Box sovrappieni e sottopieni La `\parbox` L’esempio dimostra un problema molto più generale: quando elabora il tuo codice LaTeX, il motore TeX utilizzato per comporre il documento (pdfTeX, XeTeX o LuaTeX) potrebbe ritenere che le richieste di LaTeX producano contenuto composto che non “si adatta bene” entro i confini del box fornito o richiesto. In tal caso, il motore TeX emette avvisi e il materiale verrà composto, ma il risultato potrebbe non essere, in alcune occasioni, esteticamente gradevole e probabilmente dovrai correggerlo. Vale la pena comprendere il significato di quei messaggi e riconoscere quando è necessario intervenire per affrontarli. Questi avvisi relativi ai box hanno la forma ``` Overfull \hbox (pt troppo larga) ... alla riga/e ... Overfull \vbox (pt troppo alta) ... alla riga/e ... Underfull \hbox (badness ) ... alla riga/e ... Underfull \vbox (badness ) ... alla riga/e ... ``` Un `\hbox` si riferisce a un *box orizzontale* in cui un motore TeX dispone una lista di elementi fianco a fianco e `\vbox` si riferisce a un *box verticale* in cui il motore TeX impila gli elementi uno sopra l’altro. Se c’è troppo poco materiale il motore TeX segnalerà un `Underfull \hbox` avviso o un `Underfull \vbox` avviso: * **Box sottopieni** non hanno materiale sufficiente per riempire le dimensioni (del box) allocate per contenerli e il motore TeX ha dovuto “stirare” il contenuto nel tentativo di riempire quello spazio. Per i box sottopieni Overleaf segnalerà anche la cosiddetta “badness” di TeX (`badness `) che è una misura di quanto TeX abbia dovuto “stirare” il contenuto per riempire lo spazio riservato a contenerlo. I valori di badness normalmente vanno da 0 a 10000. Se c’è troppo materiale il motore TeX segnalerà un avviso \`Overfull \hbox\` o un avviso \`Overfull \vbox\`: * **Box sovrappieni** hanno troppo contenuto per rientrare nelle dimensioni (del box) allocate per contenerlo e TeX non può “comprimerlo” nello spazio disponibile. Il motore TeX segnala l’entità (``), in punti, di quanto il contenuto eccede lo spazio disponibile—il materiale è troppo largo per un dato `\hbox` o troppo alto per un dato `\vbox`. ## I box sovrappieni o sottopieni non sono errori Come notato, i messaggi di sovrappieno/sottopieno `\hbox` o `\vbox` non sono errori ma “messaggi di avviso diagnostici” prodotti dal motore TeX (pdfTeX, XeTeX o LuaTeX) utilizzato per comporre il tuo documento LaTeX. Sebbene *segnalati* a te da Overleaf, questi avvisi non sono *generato* da Overleaf: provengono dall’interno dei motori TeX. Durante la composizione, questi messaggi vengono scritti nel `.log` file—un file di testo prodotto dal motore TeX per registrare una gamma di informazioni mentre elabora il tuo codice LaTeX. Overleaf elabora il `.log` file per estrarre i messaggi di avviso di sovrappieno/sottopieno del motore TeX e li visualizza nell’interfaccia di Overleaf. Questo ti aiuta a localizzare e identificare parti del documento che potrebbero necessitare di modifiche per produrre il miglior risultato possibile della composizione. `\hbox` o `\vbox` Questo ti aiuta a localizzare e identificare parti del documento che potrebbero necessitare di modifiche per produrre il miglior risultato possibile della composizione. ## Devo preoccuparmi di questi avvisi? Gli utenti nuovi a TeX/LaTeX possono essere preoccupati da questi avvisi, chiedendosi se indichino un serio problema con il documento, ma spesso accade che la maggior parte di essi possa essere ignorata senza problemi. Tuttavia, questi avvisi a volte evidenziano una parte del documento che deve essere controllata e potrebbe richiedere modifiche per migliorare il risultato visibile della composizione. Può volerci un po' di pratica per interpretare questi messaggi, quindi se sei nuovo a TeX/LaTeX vale la pena dedicare tempo a costruire la tua esperienza individuando il punto nel codice sorgente che ha generato l'avviso. Facendo ciò imparerai presto a individuare gli avvisi che effettivamente evidenziano problemi che potresti dover affrontare. ## Come posso trovare la fonte dell'avviso? 1. Dall’interfaccia di Overleaf, fai clic su un messaggio di avviso e l’editor scorrerà fino alla posizione appropriata nel codice sorgente LaTeX. 2. A sinistra della posizione nel codice sorgente ci sarà un piccolo triangolo giallo contenente un punto esclamativo (!). 3. Se posizioni il puntatore del mouse sul triangolo Overleaf mostrerà il messaggio di avviso. Questo breve filmato dimostra i passaggi sopra. {% embed url="" %} ## Come posso trovare la posizione nel PDF corrispondente al mio codice LaTeX? Dopo aver individuato il codice LaTeX che ha generato un particolare avviso puoi passare alla posizione appropriata nel PDF usando le frecce situate sulla barra di separazione che divide i pannelli contenenti l’editor e il PDF composto. ![Immagine dello schermo che mostra una parbox](/files/5c19b1e3cccc2bd6d32cdf653fb9070adb79ba2d) Se non vedi queste frecce, il nostro articolo di supporto [Come passare al codice sorgente dal PDF composto (SyncTeX)](/latex/it/base-di-conoscenza/069-how-to-jump-to-the-source-code-from-the-typeset-pdf-synctex.md) mostra come abilitarle. ## Problemi comuni e come risolverli * Puoi usare il [pacchetto microtype](https://ctan.org/pkg/microtype?lang=en) che sfrutta le estensioni microtipografiche introdotte da pdfTeX—producendo una composizione di qualità superiore che può anche risultare in un minor numero di box difettosi. * Se hai problemi con gli URL e le interruzioni di riga puoi aggiungere l’opzione `breaklinks` al `hyperref` pacchetto: `\usepackage[breaklinks]{hyperref}`. * Come `\parbox`, `minipage` gli ambienti possono dare luogo ad avvisi di box sovrappieni o sottopieni quando il motore TeX cerca di spezzare i paragrafi in righe: ```latex \begin{minipage}{width} testo... \end{minipage} ``` Se possibile, aumenta il valore di `width` per dare al motore TeX una migliore possibilità di produrre buone interruzioni di riga—e/o usa il [pacchetto microtype](https://ctan.org/pkg/microtype?lang=en). ### Note sull’uso di \\\\ `\\` è una macro (un simbolo di controllo) la cui definizione precisa può dipendere dal contesto in cui viene usata---un’eccellente discussione/spiegazione si può trovare in questa [risposta su tex.stackexchange](https://tex.stackexchange.com/a/55481). * `\\` non dovrebbe essere usato per aggiungere spazio verticale tra i paragrafi—è considerata una pratica molto scorretta farlo. * `\\` è destinato solo alle interruzioni di riga (simile a Maiusc+Invio in Microsoft Word). Il modo corretto di generare un nuovo paragrafo in LaTeX è separare i paragrafi con righe vuote nel codice sorgente. * Invece di usare `\\` (oppure `\newline`/`\vspace`) per simulare le interruzioni di paragrafo, o per aumentare lo spazio tra i paragrafi, la soluzione raccomandata per impostare lo spazio tra i paragrafi è caricare il [pacchetto parskip](https://ctan.org/pkg/parskip) inserisci `\usepackage{parskip}` nel preambolo del documento. * Usare `\\` attraverso i paragrafi del documento può interferire con gli algoritmi di LaTeX che calcolano le posizioni ottimali per collocare i float, spezzare le pagine, ecc. e può causare errori di compilazione in un documento di grandi dimensioni. * L’uso legittimo di `\\` è spiegato nelle risposte su [tex.stackexchange](https://tex.stackexchange.com/). Per esempio, vedi: * [Quando usare `\par` e quando `\\`, `\newline`, o le righe vuote](https://tex.stackexchange.com/a/82666) * [Cosa fa `\\*` ?](https://tex.stackexchange.com/a/55481) ## Controllare quali box TeX ti segnala I motori TeX forniscono una serie di comandi primitivi a basso livello che puoi usare per guidare le euristiche di TeX e impostare un valore soglia per quanto un box debba essere “cattivo” prima che TeX lo segnali. Ecco alcuni link per i lettori interessati a quei comandi: * [\hfuzz e \vfuzz](/latex/it/primitivi-tex-latex/06-hfuzz.md) * [\hbadness e \vbadness](/latex/it/primitivi-tex-latex/05-hbadness.md) ## Letture aggiuntive Per ulteriori letture di sfondo sull’uso da parte di TeX di box e glue, il lettore interessato è rimandato a queste risorse: * L’articolo di Overleaf [Come TeX calcola le impostazioni della glue in un \hbox](/latex/it/articoli-approfonditi/24-how-tex-calculates-glue-settings-in-an-hbox.md). * Un articolo di Overleaf di 17 pagine scritto per accompagnare questa voce di supporto: [Esplorare i box sottopieni o sovrappieni e i calcoli di badness](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). In quell’articolo si discutono anche i primitivi TeX `\hfuzz` e `\hbadness`. * Le FAQ di TeX su . * [tex.stackexchange](https://tex.stackexchange.com/) contiene una grande quantità di consigli da parte di importanti esperti di 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/it/base-di-conoscenza/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.