> 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/kysymykset-ja-vastaukset/81-tips-and-tricks-for-troubleshooting-latex.md).

# Vinkkejä ja niksejä LaTeXin vianmääritykseen

On olemassa muutamia vinkkejä ja niksejä, joiden avulla voit tunnistaa ja ratkaista LaTeX-ongelmia. Suosittelemme yleensä virheenkorjausta käyttäen [Stop on First Error -käännöstila käytössä](/latex/fi/tietopankki/149-using-the-stop-on-first-error-compilation-mode.md), sillä näin vältät virheiden kasaantumisen. Kun olet kohdannut virheen, voit ratkaista sen seuraavien vaiheiden avulla:

1. **Onko kyseessä virhe vai varoitus?**

   Aloita katsomalla "Logs and output files" -kuvaketta, joka on juuri Recompile-painikkeen oikealla puolella.

   ![Varoitusilmaisin "Logs and output files" -kuvakkeessa](/files/8340a27b2643b473e8479dbb4b9db79f455b0222)

   Varoitusviestit näkyvät oranssina. Ne ovat usein vain ilmoituksia siitä, että LaTeX on havainnut jotain tavallisesta poikkeavaa ja tehnyt automaattisia muutoksia. Jos niillä ei ole vaikutusta asiakirjasi lopulliseen ulkoasuun, ne voi yleensä jättää huomiotta.

   Esimerkiksi monet float- ja marginaali-/väli-ongelmat LaTeX korjaa ilman käyttäjän toimenpiteitä. Overleaf ilmoittaa erityisestä varoitusluokasta, [ali- ja ylivuotolaatikkovaroitukset](/latex/fi/tietopankki/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors)—sinisellä—useimmat näistä voi turvallisesti jättää huomiotta, vaikka ne joskus korostavatkin asiakirjastasi kohdan, joka täytyy tarkistaa.

   ![Virheilmaisin "Logs and output files" -kuvakkeessa.](/files/2b4f0929e7fefad5769902a18b1e94b163b87c02)

   Virheviestit näkyvät punaisina. Ne ovat yleensä vakavampia ja voivat estää asiakirjan kääntymisen oikein. Vakavat virheet voivat estää asiakirjan kääntymisen kokonaan.

   On olemassa luettelo yleisistä virheistä ja niiden korjaamisesta [täällä](/latex/fi/latexin-perusteet/05-errors.md). Suosittelemme korjaamaan virheet mahdollisimman pian, sillä niiden kasaantuminen voi johtaa tulevaisuudessa vaikeasti jäljitettäviin ja vakaviin virheisiin.
2. **Ilmoittaako viesti tietyn virheen tai rivinumeron?**

   ![Virheilmoitus, jossa on mukana rivinumero.](/files/d04604fceb4a91ec7ad637fb0be3cfe0ebcf7da9)

   Monissa tapauksissa LaTeX-moottori on tarpeeksi älykäs päättelemään tarkan virheen ja antamaan rivinumeron. Yllä olevassa esimerkissä oli symboli `_`, joka LaTeXissa pitää merkitä näin: `\_`. Virheilmoitus kertoo jopa, että virhe on rivillä 29, korostaa kyseisen rivin ja näyttää otteen tekstistä, jossa ongelma sijaitsee. Voit napsauttaa virheilmoitusta siirtyäksesi suoraan tiedostoon ja rivinumeroon, jossa virhe esiintyy lähdekoodissa.

   Jos rivinumeroa ei näytetä, jatka alla olevien vaiheiden kokeilemista.
3. **Antaako virheteksti vihjeen?**

   ![Virheilmoitus, joka kertoo ongelman olevan .bbl-tiedostossa, viittaa ongelmaan lähdeluettelossa.](/files/eae88e67f7a0c0cc7e349ddeafb05861120f635a)

   Yllä olevassa virheilmoituksessa annetaan rivinumero, mutta ei tiedostolle, jota yleensä muokkaat. Tässä tiedostopääte .bbl antaa vihjeen siitä, että käännöksen estävä virhe on BibTeX-ongelma.

   Korostetun tekstin etsiminen .bib-tiedostostasi auttaa sinua löytämään virheen lähteen. Joskus [aputiedostojen ja lokitiedostojen tarkistaminen](/latex/fi/tietopankki/150-view-generated-files.md) saattaa paljastaa tarkempaa tietoa kuin lyhyemmät viestidialogit.
4. **Vertaile aiempia versioita ja palauta muutokset**

   Jos projektisi kääntyi aiemmin aivan hyvin, olet todennäköisesti lisännyt projektiin virheen viimeaikaisilla muokkauksillasi. Voit käyttää [Historia-ominaisuutta](/latex/fi/lisaa-aiheita/49-using-the-history-feature.md) viimeaikaisten muutosten palauttamiseen.
5. **Kokeile siirtää \end{document}**

   Jos et ole vieläkään rajannut virheen sijaintia, leikkaa `\end{document}` pää-.tex-tiedostosi aivan lopusta ja kokeile liittää sitä projektisi eri kohtiin. Aloita pää-.tex-tiedostosta ja tarvittaessa sitten mahdollisista alitiedostoista, joita kutsut pää-tiedostossasi käyttäen `\input{}` tai `\include{}`. Siirry järjestelmällisesti projektin/asiakirjan aivan lopusta kohti asiakirjan alkua ja toista tämä prosessi yksi osio kerrallaan. Kiinnitä erityistä huomiota yhtälöihin ja muihin monimutkaisiin osioihin, joissa pienet virheet ovat tavallisia.

   Tämän pitäisi auttaa sinua rajaamaan asiakirjaasi vähitellen yhä pienemmäksi, kunnes voit eristää osion, joka sisältää virheen. Jos asiakirja alkaa yhtäkkiä kääntyä, tiedät löytäneesi virheellisen osion. Monissa tapauksissa ongelma voi olla jotain niinkin yksinkertaista kuin väärin kirjoitettu komento, pakottamatta merkitty erikoismerkki tai puuttuva sulje.
6. **Onko kyse käännöksen "timeout"-virheestä?**

   Joissakin tapauksissa käyttäjät voivat kohdata aikakatkaisun aiheuttamia käännösvirheitä tietyissä olosuhteissa. Tämä johtuu palvelimillamme olevista resurssi- ja käännösaikarajoista. Meillä on eri aikarajat ilmaisille tileille ja maksullisille tileille. Meillä on useita vinkkejä, joilla voimme [saada asiakirjasi kääntymään nopeammin](/latex/fi/tietopankki/038-fixing-and-preventing-compile-timeouts.md)ja jos nämä eivät auta, voit vapaasti ottaa meihin yhteyttä lähettämällä [tukipyynnön](https://www.overleaf.com/contact).
7. **Onko kyseessä "PDF-renderöinti"-virhe?**

   Kuten muidenkin verkkopalvelujen kanssa, Overleafin käytössä voi joskus kohdata ongelmia. Selaimen tila, selainlaajennukset, palveluntarjoajien lyhyet häiriöt ja verkkoasetusten ongelmat voivat kaikki aiheuttaa ongelmia.

   Jos sinulla on yhteysongelmia tai jos osa editorista tai PDF-katseluohjelmasta ei lataudu tai näy odotetusti, kokeile vianmääritysvaiheita sivulla [tältä sivulta](/latex/fi/tietopankki/125-resolving-access-loading-and-display-problems.md).
8. **Kokeile foorumeita**

   Jos rivinumeroa ei anneta etkä pysty tulkitsemaan annettua virheilmoitusta, nopea "kopioi ja liitä" -kierros suosikkihakukoneeseesi saattaa paljastaa tietoa asiantuntijakäyttäjiltä, jotka ovat kohdanneet samanlaisen ongelman. Eräitä erinomaisia TeX-aiheisia foorumeita ovat [LaTeX Stack Exchange](https://tex.stackexchange.com/) ja [LaTeX Community](https://latex.org/forum/).
9. **Ota meihin yhteyttä**

   Viimeisenä, muttei vähäisimpänä, voit aina lähettää meille [tukipyynnön](https://www.overleaf.com/contact). Riippumatta ongelmastasi, olipa se LaTeXiin liittyvä tai sivustokohtainen, autamme mielellämme sinua saamaan Overleaf-kokemuksestasi kaiken irti.


---

# 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/kysymykset-ja-vastaukset/81-tips-and-tricks-for-troubleshooting-latex.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.