> 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/cs/znalostni-baze/149-using-the-stop-on-first-error-compilation-mode.md).

# Používání režimu kompilace Zastavit při první chybě

Tento článek vysvětluje, jak používat Overleafův **Zastavit při první chybě** režim kompilace a zároveň probírá některá důležitá související témata, včetně:

* Co je [režim kompilace LaTeXu](#introduction-to-latex-errors-and-compilation)?
* [Režimy kompilace v Overleafu](#compilation-modes-on-overleaf)
* Jak **Zastavit při první chybě** může být [užitečné při ladění](#benefits-of-using-the-stop-on-first-error-mode)

Chcete-li přeskočit základní informace, můžete rovnou přejít do části vysvětlující [jak povolit režim kompilace Zastavit po první chybě](#the-stop-on-first-error-compilation-mode).

## Úvod do chyb LaTeXu a kompilace

Převod dokumentu LaTeX do vysázeného souboru PDF je výsledkem procesu zvaného *kompilace*: spustitelný program, známý jako „kompilátor LaTeXu“, čte obsah vašeho dokumentu a provádí jeho jednotlivé příkazy LaTeXu, aby vygeneroval vysázený soubor PDF.

Při psaní značek LaTeXu (kódu) je docela přirozené udělat chyby, které během kompilace způsobí, že kompilátor vypíše chybová hlášení, jež se snaží vysvětlit, co si kompilátor *myslí* že způsobilo problém(y). Stejně jako u jiných programovacích jazyků může jediná chyba v kódu LaTeXu vašeho dokumentu vyvolat řetězec chyb, z nichž každá má své příslušné hlášení. V Overleafu jsou chybová hlášení z kompilace uživateli oznamována prostřednictvím [červeného oznámení vedle **Překompilovat** tlačítko](#overleafs-latex-error-reporting), a můžete kliknout na **Protokoly a výstupní soubory** ikonu, abyste si je zobrazili.

### Práce s chybami: režimy kompilace

Kompilátory LaTeXu, známé také jako [TeXové enginy](/latex/cs/clanky-do-hloubky/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), mají vestavěné (uživatelem volitelné) *režimy kompilace* , které určují, jak se s chybami zachází. Následující odrážkový seznam používá Overleafův *vlastní vysvětlující/popisný název* pro každý z těchto režimů:

* **Zkusit kompilovat navzdory chybám**—v zásadě se snažit dál kompilovat i přes vzniklé chyby, doufat v nejlepší a případně vytvořit soubor PDF, který však může obsahovat typografické chyby.
* **Zastavit při první chybě**—v podstatě se při prvním náznaku potíží „odhlásit“, zobrazit uživateli zprávu a skončit bez vytvoření PDF. Tím se zabrání spuštění následné řetězové reakce chyb a můžete se soustředit na opravu úplně první chyby a znovuspuštění kompilace dokumentu.
* **Pozastavit kompilaci a interagovat s uživatelem**—pozastavit kompilaci, nabídnout pomoc a poskytnout mechanismy, které uživatelům umožní chyby opravit a pokračovat v kompilaci. To je možné při lokální instalaci LaTeXu, ale na Overleafu nepraktické.

## Režimy kompilace v Overleafu

K řízení kompilace LaTeXu používá Overleaf [nástroj pro sestavení nazvaný latexmk](/latex/cs/znalostni-baze/064-how-does-overleaf-compile-my-project.md) který ve výchozím nastavení používá režim kompilace, který Overleaf označuje jako **Zkusit kompilovat navzdory chybám:** nástroj pro sestavení se pokusí vytvořit vysázený soubor PDF, i když jsou v něm [chyby kompilace LaTeXu](/latex/cs/zaklady-latexu/05-errors.md).

V **Zkusit kompilovat navzdory chybám** režimu kompilace se kompilátor LaTeXu nezastaví, pokud jsou zjištěny chyby; místo toho se pokusí „odhadnout“ záměr uživatele a na základě tohoto odhadu použije „opravy“ — problematický kód může být také „přeskočen“. Kompilátor *může* se vrátit do stavu, kdy může kompilace nakonec doběhnout do konce a vytvořit PDF, i když výsledné PDF může obsahovat nesprávný výstup. Často jsou nalezené chyby příliš závažné nebo četné na to, aby je kompilátor LaTeXu opravil, takže může přesto „odhlásit“ bez vytvoření PDF.

### Oznamování chyb LaTeXu v Overleafu

Jak bylo uvedeno výše, chybová hlášení vzniklá během kompilace jsou uživateli oznamována prostřednictvím červeného oznámení vedle **Překompilovat** tlačítka:

![Snímek obrazovky zobrazující chyby LaTeXu hlášené v Overleafu](/files/3736d905960f9b9f1b2afbcb327332e35c8ac5bc)

Můžete kliknout na **Protokoly a výstupní soubory** ikonu a zobrazit si podrobnější informace o chybě(ch). Například pokud jste omylem napsali `\texbf{word}` místo `\textbf{word}`, Overleaf by stále zobrazil náhled zkompilovaného PDF spolu s chybovou zprávou o nedefinovaném příkazu, ale „word“ by v PDF nebylo tučně!

## Režim kompilace Zastavit po první chybě

Uživatelé nyní mohou změnit režim kompilace LaTeXu přepnutím na **Zastavit při první chybě** režim, který způsobí, že Overleaf okamžitě ukončí kompilaci při zjištění první chyby.

### Jak povolit Zastavit po první chybě

Vyberte malý trojúhelník vedle **Překompilovat** tlačítka a poté zvolte **Zastavit při první chybě** z balíčku **Překompilovat** rozbalovací nabídce:

![Snímek obrazovky ukazující, jak povolit režim kompilace Zastavit při první chybě](/files/d80e3024b7ef8302b37f57f48ad529f682e451a4)

#### Rozsah tohoto nastavení režimu

Ta **Zastavit při první chybě** režim je nastavení pro konkrétního uživatele a konkrétní projekt. Povolení tohoto režimu nebude *ne* ovlivňovat vaše další projekty ani žádné spolupracovníky ve stejném projektu.

### Vypnutí režimu Zastavit po první chybě

Když **Zastavit při první chybě** je-li povolen, můžete se vrátit k výchozímu režimu kompilace výběrem modrého tlačítka **Zakázat „Zastavit po první chybě“** umístěného v dialogovém okně, které se zobrazí při chybě kompilace:

![Snímek obrazovky zobrazující hlášení o neúspěšné kompilaci](/files/45a8105dbc5dd4a746184d758ea392231da5870a)

Můžete také přejít do **Překompilovat** rozbalovací nabídky a vybrat **Zkusit kompilovat navzdory chybám** režim:

![Snímek obrazovky ukazující, jak vypnout režim kompilace Zastavit po první chybě](/files/ccf3fc642f2be79c362f7070425a24fed9a34d71)

### Další poznámky a doporučení

Pokud je váš projekt bez chyb kompilace LaTeXu, zobrazí se jako obvykle náhled PDF. Pokud váš projekt *ne* obsahuje chyby kompilace LaTeXu, kompilace se okamžitě zastaví při první chybě. První chybová zpráva se zobrazí tak, jak je ukázáno na snímku obrazovky níže, abyste se mohli soustředit na ladění chyby ve zdrojovém kódu. V tomto snímku je chyba způsobena nesprávným použitím `\caption{...}\label{...}` uvnitř prostředí tabular. Řádek 15 by měl být přesunut před `\begin{tabular}`.

![Snímek obrazovky zobrazující typickou chybu LaTeXu](/files/e2dd9a46e1b91691777043608f7cd161ab366a2d)

Klikněte na **Překompilovat** po opravě každé chyby a poté tento proces ladění zopakujte pro každou následující chybu kompilace. Když je váš projekt bez chyb LaTeXu,  **Zastavit při první chybě** režim zobrazí úspěšně zkompilované PDF.

### Výhody používání režimu Zastavit po první chybě

* **Pomáhá při ladění časových limitů kompilace.** Některé typy chyb kompilace jsou tak závažné (např. neúmyslná rekurze), že mohou zablokovat **Zkusit kompilovat navzdory chybám** režim kompilace, což vede k [časovému limitu kompilace](/latex/cs/znalostni-baze/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) v projektu Overleaf. Povolení **Zastavit při první chybě** režimu může pomoci takové chyby lokalizovat a odladit.
* **Nedovolte, aby se vám chyby hromadily.** Někteří uživatelé mohou preferovat chování jiných editorů LaTeXu, v nichž se kompilace zastaví při první nalezené chybě LaTeXu, aby ji mohli před opětovným spuštěním kompilace opravit. Zabránění řetězení chyb — spouštění laviny dalších chyb — se vyhýbá nutnosti ladit 100 a více chybových hlášení kompilace, což může být obtížné a poněkud únavné.
* **Povolení režimu Zastavit po první chybě může rychle odhalit vaše chyby (pokud nějaké jsou).** Pokud máte rozsáhlý nebo složitý dokument, jehož kompilace trvá déle,  **Zkusit kompilovat navzdory chybám** režim vyžaduje, abyste počkali, až kompilace skončí. Pokud máte chyby, které je třeba opravit, může být časově náročné čekat, než uvidíte první chybu kompilace a pokusíte se ji opravit.
* **Naučit se ladit chyby je nezbytnou součástí učení se LaTeXu.** Ta **Zastavit při první chybě** režim může začátečníkům s LaTeXem pomoci brzy si osvojit a zavést dobré návyky při psaní kódu v LaTeXu a možná urychlit jejich cestu k jeho zvládnutí. Chyby LaTeXu se mohou zdát tak podivné a esoterické, že je velmi lákavé je ignorovat a nechat kompilátor pokračovat — v naději, že se nakonec objeví PDF, i když bude obsahovat typografické chyby. Z dlouhodobého hlediska může ignorování chyb kompilace vést ke špatným návykům při kódování, které by vás nakonec mohly v budoucnu dostat do potíží, možná při odevzdávání důležitého časopiseckého článku! Pokud učíte třídu LaTeXu, vaši studenti mohou používat **Zastavit při první chybě** režim k rozvíjení dovedností v ladění chyb LaTeXu.

## Chyby, které zjevně nevznikají ve vašich souborech

Pokud kompilaci ručně zastavíte v **Zkusit kompilovat navzdory chybám** režimu a poté povolíte **Zastavit při první chybě**, další kompilace může skončit několika zdánlivě náhodnými chybovými hlášeními, například `! Soubor skončil při skenování použití \@writefile`, která se nezdají pocházet z vašich souborů. Takové chyby mohou být způsobeny zkrácenými soubory vytvořenými a zbylými z předchozí neúspěšné kompilace. V takovém případě možná budete chtít provést [Překompilovat od začátku](/latex/cs/znalostni-baze/028-clearing-the-cache.md) aby další kompilace, stále v **Zastavit při první chybě** režimu, měla šanci začít z čistého stavu a zobrazit první relevantní chybu. Pokud stále dostáváte chyby ze zdánlivě neexistujícího souboru — např. `output.aux`, `output.toc` atd. — podívejte se na [tuto stránku nápovědy](/latex/cs/znalostni-baze/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

## Některé podrobnosti na nižší úrovni

Ta **Zkusit kompilovat navzdory chybám** režim kompilace běží `latexmk` s následujícími příznaky:

```latex
latexmk -f -interaction=nonstopmode …
```

Ta **Zastavit při první chybě** režim kompilace spustí latexmk místo toho s následujícími příznaky:

```latex
latexmk -halt-on-error -interaction=nonstopmode …
```

Když už jste tady, možná by vás také zajímalo přečíst si více o [jak Overleaf používá `latexmk` nástroj](/latex/cs/znalostni-baze/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/cs/znalostni-baze/149-using-the-stop-on-first-error-compilation-mode.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.