Kun asiat menevät pieleen

LaTeXin tapa reagoida virheisiin ei ole ihan sellainen kuin mihin 2020-luvun ohjelmoija on tottunut, ja oletuskäyttäytyminen on hyvinkin erikoinen. Mietit jo ehkä sitäkin, miksi käännöskomento oli niin mutkikas: mihin tarvittiin -interaction=nonstopmode?

Puuttuva loppu

Kokeillaanpa. Tehdään dokumenttiin pieni virhe ja jätetään lopusta \end{document} pois. Aloita puhtaalta pöydältä ja poista kaikki tiedostot. Kirjoita nimellä lapio.tex tällainen dokumentti:

\documentclass{article}
\begin{document}
Testi

Yritä nyt kääntää tätä seuraavalla komennolla:

pdflatex lapio.tex

Mitä tapahtui?

Kysymys 1

LaTeX ei valittanut mitään, käännös onnistui ja tuloksena syntyi ehjä PDF-tiedosto, vaikka lähdekoodi oli virheellinen.

LaTeX ei valittanut mitään, käännös näytti menevän läpi, mutta tuloksena olikin tyhjä PDF-tiedosto.

Käännös päätyi virheeseen. Ruudulle tulostui paljon ilmoituksia, mutta kun tarkasti katsoo niiden joukossa lukee myös ! LaTeX Error: Missing \end{document}.

Käännös päätyi virheeseen. Ruudulle tulostui paljon ilmoituksia, ja seassa on esimerkiksi ! Emergency stop. ja !  ==> Fatal error occurred, no output PDF file produced!, mutta ei mitään vihjettä siitä, että vika on puuttuva \end{document}.

Käännös ei koskaan päättynyt. Ruudulle tulostui alkuun normaalin näköistä tekstiä ja sen jälkeen rivi, jossa on pelkkä *. Mitään muuta ei tapahdu vaikka kuinka pitkään odotan, eikä LaTeX koskaan palaa takaisin komentorivikehotteeseen. Painamalla ctrl + d näköjään pääsee tästä eteenpäin ja saa lopulta jonkin virheilmoituksenkin.

Kokeillaan nyt, mitä -interaction=nonstopmode vaikuttaa. Käytetään samaa virheellistä dokumenttia ja käännetään se nyt näin:

pdflatex -interaction=nonstopmode lapio.tex

Mitä tapahtui?

Kysymys 1

LaTeX ei valittanut mitään, käännös onnistui ja tuloksena syntyi ehjä PDF-tiedosto, vaikka lähdekoodi oli virheellinen.

LaTeX ei valittanut mitään, käännös näytti menevän läpi, mutta tuloksena olikin tyhjä PDF-tiedosto.

Käännös päätyi virheeseen. Ruudulle tulostui paljon ilmoituksia, mutta kun tarkasti katsoo niiden joukossa lukee myös ! LaTeX Error: Missing \end{document}.

Käännös päätyi virheeseen. Ruudulle tulostui paljon ilmoituksia, ja seassa on esimerkiksi ! Emergency stop. ja !  ==> Fatal error occurred, no output PDF file produced!, mutta ei mitään vihjettä siitä, että vika on puuttuva \end{document}.

Käännös ei koskaan päättynyt. Ruudulle tulostui alkuun normaalin näköistä tekstiä ja sen jälkeen rivi, jossa on pelkkä *. Mitään muuta ei tapahdu vaikka kuinka pitkään odotan, eikä LaTeX koskaan palaa takaisin komentorivikehotteeseen. Painamalla ctrl + d näköjään pääsee tästä eteenpäin ja saa lopulta jonkin virheilmoituksenkin.

Kumpikaan ei taida olla ihan sellainen lopputulos, jota haluaisimme nähdä, mutta jälkimmäinen lienee hiukan vähemmän mystinen. Käytämme siis toistaiseksi kokeiluissamme komentoa pdflatex -interaction=nonstopmode lapio.tex.

Puuttuva alku

Tehdään vielä muutama kokeilu. Mitä tapahtuu, jos unohdetaankin \begin{document}? Luo siis tällainen virheellinen dokumentti:

\documentclass{article}
Testi
\end{document}

Ja käännä se näin:

pdflatex -interaction=nonstopmode lapio.tex

Mitä tapahtui?

Kysymys 1

LaTeX ei valittanut mitään, käännös onnistui ja tuloksena syntyi ehjä PDF-tiedosto, vaikka lähdekoodi oli virheellinen.

LaTeX ei valittanut mitään, käännös näytti menevän läpi, mutta tuloksena olikin tyhjä PDF-tiedosto.

Käännös päätyi virheeseen. Ruudulle tulostui paljon ilmoituksia, mutta kun tarkasti katsoo niiden joukossa lukee myös ! LaTeX Error: Missing \begin{document}.

Käännös päätyi virheeseen. Ruudulle tulostui paljon ilmoituksia, ja seassa on esimerkiksi ! Emergency stop. ja !  ==> Fatal error occurred, no output PDF file produced!, mutta ei mitään vihjettä siitä, että vika on puuttuva \begin{document}.

Käännös ei koskaan päättynyt. Ruudulle tulostui alkuun normaalin näköistä tekstiä ja sen jälkeen rivi, jossa on pelkkä *. Mitään muuta ei tapahdu vaikka kuinka pitkään odotan, eikä LaTeX koskaan palaa takaisin komentorivikehotteeseen. Painamalla ctrl + d näköjään pääsee tästä eteenpäin ja saa lopulta jonkin virheilmoituksenkin.

Kun oikein tarkasti lukee LaTeXin tulostetta, joskus siellä on hyödyllistäkin tietoa. LaTeX itseasiassa onnistui kyllä kertomaan, missä kohtaa vika tarkalleen ottaen oli. Kun katsot tulostetta, näet siellä myös tällaisen pätkän:

l.2 T
     esti

Ollaan siis tiedoston rivillä 2 (l.2), ja rivinvaihdolla on merkitty ongelman tarkka paikka: LaTeX on juuri saanut luettua kirjaimen "T" ja seuraavaksi olisi vuorossa "esti", mutta jo tässä T-kirjaimen kohdalla LaTeX ei tiennyt, mitä tehdä. LaTeX ei odottanut tavallista tekstiä ennen \begin{document}-komentoa, eikä tiedä, mitä sille tekisi.

Puuttuva sisältö

Kokeillaan vielä tällaista dokumenttia, josta puuttuu kokonaan sisältö:

\documentclass{article}
\begin{document}
\end{document}

Huolehdi taas, että aloitat puhtaalta pöydältä ja hakemistossa ei ole mitään muuta kuin pelkkä lapio.tex-tiedosto. Käännä tiedosto näin:

pdflatex -interaction=nonstopmode lapio.tex

Mitä tapahtui? Valitse paras vastine:

Kysymys 1

LaTeX ei tuottanut lainkaan PDF-tiedostoa.

LaTeX tuotti PDF-tiedoston, jossa ei ole yhtään sivua.

LaTeX tuotti PDF-tiedoston, jossa on yksi sivu, mutta sivulla ei ole mitään sisältöä, ei edes sivunumeroa.

LaTeX tuotti PDF-tiedoston, jossa on yksi sivu, jonka ainoa sisältö on sivunumero.

LaTeX tuotti PDF-tiedoston, jota ei ole kuitenkaan mahdollista avata PDF-katseluohjelmassa.

Nämä kokeilut virheellisten dokumenttien kanssa on hyvä pitää mielessä jatkossa, jos törmäät LaTeXin kanssa mystisiin virhetilanteisiin.

Palautusta lähetetään...

×

Identtinen palautus

Tämä palautus on identtinen aikaisemman palautuksen kanssa. Oletko varma, että haluat lähettää palautuksen?

Peruuta Lähetä