> 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/fi/tietopankki/138-understanding-underfull-and-overfull-box-warnings.md). # Alitäyttyneiden ja ylitäyttyneiden laatikkovaroitusten ymmärtäminen ## Johdanto LaTeX-dokumenttia ladottaessa Overleaf näyttää usein viestejä, jotka ilmoittavat ali- tai ylitäytetystä `\hbox` (tai `\vbox`), sekä niin sanottuja `huonous` arvoja ali­täytetyille laatikoille tai määriä, joilla laatikot ovat ylitäyttyneitä. Ensinnäkin on tärkeää huomata, että nämä viestit eivät ole virheitä—[katso lisätietoja alta](#overfull-or-underfull-boxes-are-not-errors). Ne ovat *varoituksia* tai, tarkemmin sanottuna, “diagnostiikkaviestejä”, jotka tulevat LaTeX-dokumenttisi ladonnassa käytetyn TeX-ytimen sisältä. Tässä ohjeartikkelissa annamme alustavan taustan näiden viestien lähteeseen ja syyhyn sekä luettelemme joitakin yleisiä ongelmia ehdotettuine ratkaisuineen. Tarkempia tietoja etsiville olemme julkaisseet aiheeseen liittyvän artikkelin Overleaf-galleriassa: [Ali- tai ylitäytettyjen laatikoiden ja badness-laskelmien tutkiminen](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). Lisäresurssien luettelo löytyy myös [tämän artikkelin lopusta](#further-reading). ## Sisältääkö projektini ylitäyttö- tai alitäyttövaroituksia? Tarkistaaksesi, ilmoittaako projektisi nämä varoitukset, sinun täytyy napsauttaa alla olevassa kuvakaappauksessa näkyvää kuvaketta. Vaikka dokumenttisi olisi kääntynyt ilman virheitä, näitä viestejä näkee hyvin usein, ja TeX/LaTeXiin vasta tutustunut saattaa pohtia, mitä ne tarkoittavat ja pitäisikö niistä olla huolissaan. ![Kuvakaappaus, jossa Overleaf ilmoittaa ali- tai ylitäytetyistä laatikoista](/files/b9f7643d72abe709bdfcbc853449d08d537e6b8f) Dokumenttia ladottaessa LaTeX yrittää saada sisältösi osat mahtumaan tietyn “koon” rajoihin; esimerkiksi kappaleita ladottaessa ja rivejä tietyn mittaisiksi jaettaessa—mikä on helpoimmin osoitettavissa komennolla kuten `\parbox`. Jos yritämme ladota seuraavan kappaleen 50pt:n rivileveydellä: ```latex \parbox{50pt}{Jotakin tekstiä ladottuna käyttäen \texttt{\string\parbox}} ``` Overleaf ilmoittaa kaksi `Ali­täytetty \hbox...` varoitusta: ![Kuvakaappaus, jossa Overleaf ilmoittaa ali­täytetyistä laatikoista](/files/8191ef7ea4b2948a7c622c0387eb85480bf0bb9c) Nämä `Ali­täytetty \hbox...` varoitukset johtuvat siitä, että TeX-ydin ei voi tuottaa “siistejä” rivinvaihtoja tämän \parboxin rajoitusten puitteissa. TeX-ytimissä ladotun kappaleen jokainen rivi muuttuu \hboxiksi, jonka ydin tarkistaa ja josta se raportoi myöhemmin, mikä voi tuottaa varoituksia kaikista ladotun tekstin riveistä, joita TeX-ydin luokittelee “ei-toivotuiksi”. Kuten seuraavista kuvista näkyy, tekstirivit ovat erittäin väljästi aseteltuja, ja TeXin `Ali­täytetty \hbox...` varoitukset kertovat tästä—vaikka tässä esimerkissä se onkin selvästi näkyvissä. ![Kuvakaappaus, jossa näkyy \parbox](/files/2eb0c7e93cd7be25e5b1d2ab3eeee45ef77a4995) Huomaa, että tässä esimerkissä voit välttää nämä varoitukset käyttämällä \raggedright-komentoa: ```latex \parbox{50pt}{\raggedright Jotakin tekstiä ladottuna käyttäen \texttt{\string\parbox}} ``` ![Kuvakaappaus, jossa näkyy \parbox](/files/a02d086d02e0d71da529e3662b0c681fc5da98f3) ## Ylitäytetyt ja alitäytetyt laatikot Se `\parbox` esimerkki havainnollistaa paljon yleisempää ongelmaa: LaTeX-koodiasi käsiteltäessä dokumenttisi ladonnassa käytetty TeX-ydin (pdfTeX, XeTeX tai LuaTeX) saattaa katsoa, että LaTeXin pyynnöt johtavat ladottuun sisältöön, joka ei “mahdu siististi” annetun tai pyydetyn laatikon rajoihin. Tällöin TeX-ydin antaa varoituksia ja materiaalisi ladotaan, mutta tulos ei välttämättä ole ajoittain esteettisesti toivottava, ja sinun on luultavasti korjattava se. On hyödyllistä ymmärtää näiden viestien merkitys ja tunnistaa, milloin sinun täytyy toimia niiden korjaamiseksi. Nämä laatikoihin liittyvät varoitukset ovat muotoa ``` Overfull \hbox (pt liian leveä) ... rivillä/riveillä ... Overfull \vbox (pt liian korkea) ... rivillä/riveillä ... Underfull \hbox (badness ) ... rivillä/riveillä ... Underfull \vbox (badness ) ... rivillä/riveillä ... ``` Muuttuvan fontin `\hbox` tarkoittaa *vaakalaatikkoa* johon TeX-ydin sijoittaa kohteiden luettelon vierekkäin ja `\vbox` tarkoittaa *pystylaatikkoa* jossa TeX-ydin pinoaa kohteet päällekkäin. Jos materiaalia on liian vähän, TeX-ydin ilmoittaa `Ali­täytetty \hbox` varoituksen tai `Ali­täytetty \vbox` varoituksen: * **Ali­täytetyt laatikot** eivät sisällä riittävästi materiaalia täyttämään niille varatut (laatikon) mitat, ja TeX-ydin joutuu “venyttämään” sisältöä pyrkiessään täyttämään tuon tilan. Ali­täytettyjen laatikoiden kohdalla Overleaf ilmoittaa myös TeXin niin sanotun “badnessin” (`badness `) joka mittaa, kuinka paljon TeXin on täytynyt “venyttää” sisältöäsi täyttääkseen sille varatun tilan. Badness-arvot ovat tavallisesti välillä 0–10000. Jos materiaalia on liikaa, TeX-ydin ilmoittaa \`Overfull \hbox\` -varoituksen tai \`Overfull \vbox\` -varoituksen: * **Ylitäytetyt laatikot** sisältävät liikaa sisältöä mahtuakseen niille varattuihin (laatikon) mittoihin, eikä TeX voi “puristaa” sitä annettuun tilaan. TeX-ydin ilmoittaa määrän (``), pisteinä, joilla sisältösi ylittää käytettävissä olevan tilan—materiaalisi on liian leveä tietylle `\hbox` tai liian korkea tietylle `\vbox`. ## Ylitäytetyt tai alitäytetyt laatikot eivät ole virheitä Kuten todettu, ylitäyttö-/alitäyttö- `\hbox` tai `\vbox` viestit eivät ole virheitä, vaan TeX-ytimen (pdfTeX, XeTeX tai LuaTeX) tuottamia “diagnostisia varoitusviestejä”, jota käytetään LaTeX-dokumenttisi ladontaan. Vaikka *ilmoitettu* Overleafin sinulle, nämä varoitukset eivät ole *luotu* Overleafin tuottamia: ne tulevat TeX-ytimien sisältä. Ladonnan aikana nämä viestit kirjoitetaan `.log` tiedostoon—TeX-ytimen tuottamaan tekstitiedostoon, johon tallennetaan erilaisia tietoja sen käsitellessä LaTeX-koodiasi. Overleaf käsittelee `.log` tiedoston poimiakseen TeX-ytimen ylitäyttö-/alitäyttö- `\hbox` tai `\vbox` varoitusviestit ja näyttää ne Overleafin käyttöliittymässä. Tämä auttaa sinua paikantamaan ja tunnistamaan dokumenttisi osia, joita saatetaan joutua muokkaamaan parhaan mahdollisen ladontatuloksen saavuttamiseksi. ## Pitäisikö minun huolestua näistä varoituksista? TeX/LaTeXiin vasta tutustuneet käyttäjät voivat olla huolissaan näistä varoituksista ja miettiä, viittaavatko ne vakavaan ongelmaan dokumentissa, mutta usein suurin osa niistä voidaan jättää huomiotta turvallisesti. Toisinaan nämä varoitukset kuitenkin paljastavat dokumentistasi kohdan, joka todella täytyy tarkistaa ja jota saatetaan joutua muokkaamaan näkyvän ladontatuloksen parantamiseksi. Näiden viestien tulkitseminen vaatii hieman harjoittelua, joten jos olet uusi TeX/LaTeXin käyttäjä, kannattaa käyttää aikaa kokemuksen kartuttamiseen etsimällä lähdekoodistasi varoituksen aiheuttanut kohta. Sen avulla opit pian tunnistamaan varoitukset, jotka todella tuovat esiin ongelmia, joihin sinun ehkä täytyy puuttua. ## Miten löydän varoituksen lähteen? 1. Napsauta Overleafin käyttöliittymässä varoitusviestiä, niin editori siirtyy sopivaan kohtaan LaTeX-lähdekoodissasi. 2. Lähdekoodisi kyseisen kohdan vasemmalla puolella on pieni keltainen kolmio, jossa on huutomerkki (!). 3. Kun viet hiiren osoittimen kolmion päälle, Overleaf näyttää varoitusviestin. Tämä lyhyt videoleike havainnollistaa edellä kuvatut vaiheet. {% embed url="" %} ## Miten löydän LaTeX-koodiani vastaavan kohdan PDF:stä? Kun olet paikantanut tietyn varoituksen aiheuttaneen LaTeX-koodin, voit siirtyä PDF:n sopivaan kohtaan käyttämällä nuolia, jotka sijaitsevat editorin ja ladotun PDF:n sisältävät paneelit erottavalla jakopalkilla. ![Kuvakaappaus, jossa näkyy \parbox](/files/6215ca20ca2603f065fe315c8a9d42d7544cfd33) Jos et näe näitä nuolia, ohjeartikkelimme [Miten siirtyä ladotusta PDF:stä lähdekoodiin (SyncTeX)](/latex/fi/tietopankki/069-how-to-jump-to-the-source-code-from-the-typeset-pdf-synctex.md) näyttää, miten ne otetaan käyttöön. ## Yleisiä ongelmia ja niiden korjaaminen * Voit käyttää [microtype-paketti](https://ctan.org/pkg/microtype?lang=en) joka hyödyntää pdfTeXin esittämiä mikrotypografisia laajennuksia—tuottaen korkealaatuisempaa ladontaa, mikä voi myös vähentää huonojen laatikoiden määrää. * Jos sinulla on ongelmia URL-osoitteiden ja rivinvaihtojen kanssa, voit lisätä option `breaklinks` pakettiin `hyperref` pakettia: `\usepackage[breaklinks]{hyperref}`. * Kuten `\parbox`, `minipage` ympäristöt voivat aiheuttaa ylitäytettyjen tai alitäytettyjen laatikoiden varoituksia, kun TeX-ydin yrittää jakaa kappaleita riveiksi: ```latex \begin{minipage}{width} teksti... \end{minipage} ``` Jos mahdollista, suurenna `width` antaaksesi TeX-ytimelle paremman mahdollisuuden tuottaa hyviä rivinvaihtoja—ja/tai käytä [microtype-paketti](https://ctan.org/pkg/microtype?lang=en). ### Huomautuksia \\\\-komennon käytöstä `\\` on makro (ohjaussymboli), jonka tarkka määritelmä voi riippua siitä yhteydestä, jossa sitä käytetään—erinomainen keskustelu/selitys löytyy tästä [vastauksesta sivustolla tex.stackexchange](https://tex.stackexchange.com/a/55481). * `\\` sitä ei pitäisi käyttää lisäämään pystysuuntaista väliä kappaleiden väliin—sitä pidetään erittäin huonona käytäntönä. * `\\` on tarkoitettu vain rivinvaihtoihin (samanlainen kuin Vaihto+Enter Microsoft Wordissa). Oikea tapa aloittaa uusi kappale LaTeXissa on erottaa kappaleet lähdekoodissa tyhjillä riveillä. * Sen sijaan, että käyttäisit `\\` (tai `\newline`/`\vspace`) simuloimaan kappaleenvaihtoja tai lisäämään kappaleiden välistä väliä, suositeltu tapa määrittää kappaleiden välinen väli on ladata [parskip](https://ctan.org/pkg/parskip) paketti: lisää `\usepackage{parskip}` asiakirjasi johdantoon. * Käyttämällä `\\` koko dokumentin kappaleissa voi häiritä LaTeXin algoritmeja, jotka laskevat optimaalisen paikan kelluville objekteille, sivunvaihdoille jne., ja se voi aiheuttaa käännösvirheitä suuressa dokumentissa. * Hyväksyttävä käyttö `\\` selitetään vastauksissa sivustolla [tex.stackexchange](https://tex.stackexchange.com/). Esimerkiksi katso: * [Milloin käyttää `\par` ja milloin `\\`, `\newline`, tai tyhjiä rivejä](https://tex.stackexchange.com/a/82666) * [Mitä `\\*` tekee?](https://tex.stackexchange.com/a/55481) ## Sen hallinta, mitkä laatikot TeX raportoi sinulle TeX-ytimet tarjoavat joukon matalan tason alkeiskomentoja, joilla voit ohjata TeXin heuristiikkaa ja asettaa raja-arvon sille, kuinka “huono” laatikon täytyy olla, ennen kuin TeX raportoi siitä. Tässä on joitakin linkkejä lukijoille, jotka ovat kiinnostuneita näistä komennoista: * [\hfuzz and \vfuzz](/latex/fi/tex-latex-primitiivit/06-hfuzz.md) * [\hbadness and \vbadness](/latex/fi/tex-latex-primitiivit/05-hbadness.md) ## Lisälukemista Lisätaustaa TeXin laatikoiden ja liiman käytöstä kiinnostunut lukija löytää näistä lähteistä: * Overleaf-artikkeli [Miten TeX laskee liima-asetukset \hboxissa](/latex/fi/syvalliset-artikkelit/24-how-tex-calculates-glue-settings-in-an-hbox.md). * 17-sivuinen Overleaf-artikkeli, joka on kirjoitettu tämän ohjeen tueksi: [Ali- tai ylitäytettyjen laatikoiden ja badness-laskelmien tutkiminen](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). Kyseinen artikkeli käsittelee myös TeXin alkeiskomentoja `\hfuzz` ja `\hbadness`. * TeX FAQ osoitteessa . * [tex.stackexchange](https://tex.stackexchange.com/) sisältää runsaasti neuvoja johtavilta TeX/LaTeX-asiantuntijoilta. --- # 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/fi/tietopankki/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.