> 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/nl/kennisbank/149-using-the-stop-on-first-error-compilation-mode.md). # De compilatiemodus Stop on First Error gebruiken Dit artikel legt uit hoe je Overleafs **Stop bij eerste fout** compileermodus gebruikt, samen met een bespreking van enkele belangrijke achtergrondonderwerpen, waaronder: * Wat is een [LaTeX-compileermodus](#introduction-to-latex-errors-and-compilation)? * [Compileermodi in Overleaf](#compilation-modes-on-overleaf) * Hoe **Stop bij eerste fout** kan zijn [nuttig voor het debuggen](#benefits-of-using-the-stop-on-first-error-mode) Als je de achtergrondinformatie wilt overslaan, kun je direct naar het gedeelte gaan dat uitlegt [hoe je de compileermodus Stoppen bij de eerste fout inschakelt](#the-stop-on-first-error-compilation-mode). ## Inleiding tot LaTeX-fouten en compilatie Het omzetten van een LaTeX-document naar een opgemaakt PDF-bestand is het resultaat van een proces dat *compilatie*heet: een uitvoerbaar programma, bekend als een “LaTeX-compiler”, leest de inhoud van je document en voert de bijbehorende LaTeX-opdrachten uit om het opgemaakte PDF-bestand te genereren. Wanneer je LaTeX-opmaak (code) schrijft, is het heel normaal om fouten te maken die tijdens de compilatie ertoe leiden dat de compiler foutmeldingen geeft die proberen uit te leggen wat de compiler *denkt* de oorzaak is van het probleem/de problemen. Net als bij andere programmeertalen kan één fout in de LaTeX-code van je document een reeks fouten veroorzaken, elk met de bijbehorende melding. Op Overleaf worden compilatiefoutmeldingen aan de gebruiker gemeld via [een rode melding naast de **Opnieuw compileren** knop](#overleafs-latex-error-reporting), en je kunt op het **Logboeken en uitvoerbestanden** pictogram klikken om ze te bekijken. ### Omgaan met fouten: compileermodi LaTeX-compilers, ook bekend als [TeX-engines](/latex/nl/diepgaande-artikelen/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), hebben ingebouwde (door de gebruiker te kiezen) *compileermodi* die bepalen hoe met fouten wordt omgegaan. De volgende opsomming gebruikt Overleafs *eigen verklarende/beschrijvende naam* voor elk van die modi: * **Probeer te compileren ondanks fouten**—in wezen: blijf proberen te compileren ondanks het tegenkomen van fouten, hopend op het beste, mogelijk resulterend in een PDF-bestand, maar één dat opmaakfouten kan bevatten. * **Stop bij eerste fout**—in feite “afhaken” bij het eerste teken van problemen, een bericht aan de gebruiker geven en afsluiten zonder een PDF te maken. Zo wordt voorkomen dat een daaropvolgende reeks fouten wordt geactiveerd, zodat je je kunt richten op het oplossen van de allereerste fout en het document opnieuw kunt compileren. * **Compilatie onderbreken om met de gebruiker te communiceren**—de compilatie pauzeren om hulp te bieden en mechanismen aan te reiken waarmee gebruikers fouten kunnen oplossen en de compilatie kunnen voortzetten. Dit is mogelijk met een lokale LaTeX-installatie, maar onpraktisch op Overleaf. ## Compileermodi in Overleaf Om het compilatieproces van LaTeX te beheren, gebruikt Overleaf een [bouwtool genaamd latexmk](/latex/nl/kennisbank/064-how-does-overleaf-compile-my-project.md) die standaard een compileermodus gebruikt waar Overleaf naar verwijst als **Probeer te compileren ondanks fouten:** de bouwtool zal proberen een opgemaakte PDF te produceren, zelfs als er [LaTeX-compilatiefouten](/latex/nl/latex-basis/05-errors.md). In de **Probeer te compileren ondanks fouten** compileermodus stopt de LaTeX-compiler niet als er fouten worden gedetecteerd; in plaats daarvan probeert hij de bedoeling van de gebruiker “zo goed mogelijk te raden” en past hij “oplossingen” toe op basis van die gok — problematische code kan ook worden “overgeslagen”. De compiler *kan* terugkeren naar een toestand waarin het compilatieproces uiteindelijk kan worden voltooid om een PDF te maken, hoewel de geproduceerde PDF onjuiste uitvoer kan bevatten. Vaak zijn de aangetroffen fouten te ernstig, of te talrijk, voor de LaTeX-compiler om op te lossen, dus hij kan nog steeds “afhaken” zonder een PDF te produceren. ### Overleafs LaTeX-foutenrapportage Zoals hierboven vermeld, worden foutmeldingen die tijdens de compilatie worden gegenereerd aan de gebruiker gemeld via een rode melding naast de **Opnieuw compileren** knop: ![Schermafbeelding met LaTeX-fouten gemeld in Overleaf](/files/3bf27ac7e51e17eb119e7c2c5b24d89b6b854607) Je kunt op het **Logboeken en uitvoerbestanden** pictogram klikken om meer details over de fout(en) te bekijken. Bijvoorbeeld, als je per ongeluk had getypt `\texbf{word}` in plaats van `\textbf{word}`, dan zou Overleaf nog steeds een gecompileerde PDF-voorvertoning tonen samen met de foutmelding over de onbekende opdracht, maar “word” zou in de PDF niet vet zijn! ## De compileermodus Stoppen bij de eerste fout Gebruikers kunnen nu de LaTeX-compileermodus wijzigen door over te schakelen naar de **Stop bij eerste fout** modus die ervoor zorgt dat Overleaf de compilatie onmiddellijk beëindigt zodra de eerste fout wordt gedetecteerd. ### Hoe Stoppen bij de eerste fout in te schakelen Selecteer het kleine driehoekje naast de **Opnieuw compileren** knop en kies vervolgens **Stop bij eerste fout** uit de **Opnieuw compileren** keuzemenu in: ![Screenshot die laat zien hoe u de compileermodus Stop bij eerste fout inschakelt](/files/19f1eedbd48c69a009729415e125b512184c26de) #### Bereik van deze modusinstelling De **Stop bij eerste fout** modus is een instelling per gebruiker, per project. Het inschakelen van deze modus zal *niet* invloed hebben op je andere projecten of op eventuele medewerkers in hetzelfde project. ### Stoppen bij de eerste fout uitschakelen Wanneer **Stop bij eerste fout** is ingeschakeld, kun je terugschakelen naar de standaardcompileermodus door op de blauwe knop **‘Stoppen bij de eerste fout’ uitschakelen** te klikken die zich bevindt in het dialoogvenster dat verschijnt wanneer er een compilatiefout is: ![Schermafbeelding met een melding over het mislukken van de compilatie](/files/b09c1b4ce2df011bbd599473c96040951b54fd3c) Je kunt ook naar het **Opnieuw compileren** keuzemenu gaan en de **Probeer te compileren ondanks fouten** modus selecteren: ![Schermafbeelding die laat zien hoe je de compileermodus Stoppen bij de eerste fout uitschakelt](/files/4a7d835d12f87b3915002aa50a698783cc6ddf4b) ### Aanvullende opmerkingen en advies Als je project vrij is van LaTeX-compilatiefouten, wordt zoals gewoonlijk een PDF-voorvertoning getoond. Als je project *doet* LaTeX-compilatiefouten bevat, stopt de compilatie onmiddellijk bij de eerste fout. De eerste foutmelding wordt weergegeven zoals in de schermafbeelding hieronder, zodat je je kunt concentreren op het debuggen van de fout in je broncode. In deze schermafbeelding komt de fout door onjuist gebruik van `\caption{...}\label{...}` binnen een tabular-omgeving. Regel 15 moet worden verplaatst naar vóór `\begin{tabular}`. ![Schermafbeelding met een typische LaTeX-fout](/files/4673ee6d59367bbc2265a472feef3623768481f8) Klik op **Opnieuw compileren** na het corrigeren van elke fout, en herhaal vervolgens dit debugproces voor elke volgende compilatiefout. Wanneer je project vrij is van LaTeX-fouten, zal de **Stop bij eerste fout** modus de succesvol gecompileerde PDF tonen. ### Voordelen van het gebruik van de modus Stoppen bij de eerste fout * **Helpt bij het debuggen van compilatietime-outs.** Sommige soorten compilatiefouten zijn zo ernstig (bijv. per ongeluk recursie) dat ze de **Probeer te compileren ondanks fouten** compileermodus kunnen blokkeren, wat leidt tot een [compilatietime-out](/latex/nl/kennisbank/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) in een Overleaf-project. Het inschakelen van de **Stop bij eerste fout** modus kan helpen om dergelijke fouten te lokaliseren en te debuggen. * **Laat je fouten niet opstapelen.** Sommige gebruikers geven misschien de voorkeur aan het gedrag van andere LaTeX-editors, waarbij het compilatieproces stopt bij de eerste LaTeX-fout die wordt aangetroffen, zodat ze de fout kunnen corrigeren voordat ze opnieuw compileren. Voorkomen dat fouten zich opstapelen — en zo een lawine van verdere fouten veroorzaken — voorkomt dat je 100+ foutmeldingen moet debuggen, wat lastig en enigszins tijdrovend kan worden. * **Het inschakelen van de modus Stoppen bij de eerste fout kan je fouten (als die er zijn) snel detecteren.** Als je een groot of complex document hebt dat langer nodig heeft om te compileren, vereist de **Probeer te compileren ondanks fouten** modus dat je wacht tot de compilatie klaar is. Als er fouten zijn die je moet oplossen, kan het tijdrovend zijn om te moeten wachten voordat je de eerste compilatiefout ziet en probeert deze te repareren. * **Leren fouten te debuggen is een essentieel onderdeel van het leren van LaTeX.** De **Stop bij eerste fout** modus kan LaTeX-beginners helpen al vroeg goede LaTeX-codeergewonten te leren en over te nemen, en misschien hun weg naar LaTeX-vaardigheid te versnellen. LaTeX-fouten kunnen zo bizar en esoterisch lijken dat het erg verleidelijk is ze te negeren en de compiler door te laten gaan — hopend dat er uiteindelijk een PDF verschijnt, zelfs als die PDF opmaakfouten bevat. Op de lange termijn kan het negeren van compilatiefouten leiden tot slechte codeergewoonten die je uiteindelijk later in de problemen kunnen brengen, misschien bij het indienen van een belangrijk tijdschriftartikel! Als je een les over LaTeX geeft, kunnen je studenten de **Stop bij eerste fout** modus gebruiken om vaardigheden te ontwikkelen in het debuggen van LaTeX-fouten. ## Fouten die niet lijken voort te komen uit je bestanden Als je de compilatie handmatig stopt in de **Probeer te compileren ondanks fouten** modus en vervolgens **Stop bij eerste fout**inschakelt, kan de volgende compilatie resulteren in enkele ogenschijnlijk willekeurige foutmeldingen, zoals `! File ended while scanning use of \@writefile`, die niet lijken te komen uit je bestanden. Dergelijke fouten kunnen te wijten zijn aan afgeknotte bestanden die zijn gegenereerd door, en overgebleven zijn van, de vorige onvolledige compilatie. In dat geval wil je misschien een [Opnieuw compileren vanaf nul](/latex/nl/kennisbank/028-clearing-the-cache.md) uitvoeren, zodat de volgende compilatie, nog steeds in **Stop bij eerste fout** modus, kans heeft om vanaf een schone lei te starten en de eerste relevante fout te tonen. Als je nog steeds fouten krijgt van een ogenschijnlijk niet-bestaand bestand — bijv., `output.aux`, `output.toc` enz. — neem dan een kijkje op [deze hulppagina](/latex/nl/kennisbank/066-how-to-find-and-fix-errors-reported-in-generated-files.md). ## Enkele details op lager niveau De **Probeer te compileren ondanks fouten** compileermodus voert `latexmk` uit met de volgende vlaggen: ```latex latexmk -f -interaction=nonstopmode … ``` De **Stop bij eerste fout** compileermodus zal latexmk in plaats daarvan uitvoeren met de volgende vlaggen: ```latex latexmk -halt-on-error -interaction=nonstopmode … ``` Nu je hier toch bent, vind je het misschien ook interessant om meer te lezen over [hoe Overleaf de `latexmk` tool gebruikt](/latex/nl/kennisbank/064-how-does-overleaf-compile-my-project.md). --- # 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/nl/kennisbank/149-using-the-stop-on-first-error-compilation-mode.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.