> 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/otazky-a-odpovedi/83-what-does-pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-mean.md). # Co znamená "\pdfendlink ended up in different nesting level than \pdfstartlink"? ## Některé souvislosti k této chybě (varování) Jak jejich názvy napovídají, `\pdfstartlink` a `\pdfendlink` příkazy se používají k vytváření hypertextových odkazů v PDF souborech vytvořených v TeXu/LaTeXu — například odkazů na různé stránky v souboru PDF nebo odkazů na webové stránky. Tyto příkazy jsou tzv. *primitivy*: nízkoúrovňové příkazy zabudované do enginů TeXu — nejsou to makra. V důsledku toho se s nimi většina uživatelů nesetká přímo, ale používá je nepřímo prostřednictvím maker (příkazů) poskytovaných balíčky, jako je `hyperref`. V době psaní tohoto textu (prosinec 2022) `\pdfstartlink` a `\pdfendlink` jsou podporovány jen dvěma enginy TeXu: pdfTeX a LuaTeX (a LuaHBTeX). Historicky jak pdfTeX, tak LuaTeX generovaly *chybu* hlášení ve tvaru ```latex \pdfendlink ended up in different nesting level than \pdfstartlink ``` v reakci na nízkoúrovňové problémy související s hloubkou vnoření boxů. Upozorňujeme, že text této zprávy pochází hluboko ze softwaru enginu TeXu; nevytváří jej žádný balíček LaTeX ani samozřejmě Overleaf. Od TeX Live 2021 se pdfTeX a LuaTeX rozešly v tom, jak nakládají se základním problémem (vnořování boxů), a nyní se chovají odlišně: * pdfTeX nyní toto hlášení vydává jako **varování**, již nevyvolává chybu a kompilace *ne* končí; * LuaTeX (LuaHBTeX) nadále považuje tento problém za **fatální chybu**, což způsobí ukončení kompilace — znění této chybové zprávy se mírně liší od té uvedené výše. Čtenáři, kteří chtějí dále prozkoumat základní příčinu této chyby, mohou: * otevřít tento projekt na Overleafu který se úspěšně zkompiluje s pdfLaTeXem, ale s LuaLaTeXem vyvolá chybu; * procházet [podrobnou technickou diskusi na GitHubu](https://github.com/latex3/latex2e/issues/94), vedenou mezi předními odborníky na TeX a LaTeX. ## Co ji způsobuje v praxi? Na úrovni uživatele může být toto varování (nebo chyba) vyvoláno při používání `hyperref` balíčku a hypertextový odkaz — například citace, URL nebo křížový odkaz — se rozpadne přes dvě stránky nebo dva sloupce ve vícesloupcovém dokumentu; tj. odkaz začíná blízko konce jedné stránky (nebo sloupce) a končí na další stránce (nebo sloupci). Jak bylo uvedeno, pdfTeX (pdfLaTeX) s TeX Live 2021 nebo novějším již nevytváří chybu, ale v době psaní tohoto textu (prosinec 2022) to LuaLaTeX stále dělá. Pokud používáte LuaLaTeX, dočasným řešením při práci na dokumentu je zakázat hypertextové odkazy napsáním ```latex \hypersetup{draft} ``` těsně před vaším ```latex \begin{document} ``` Přestože tím zabráníte zobrazování hypertextových odkazů v dokumentu, vyhnete se tím chybě při psaní a až budete připraveni zkompilovat finální dokument, můžete zakomentovat nebo smazat `\hypersetup{draft}`. Pokud budete mít tu smůlu, že se s tímto problémem setkáte i ve fázi finální kompilace, znovu zapněte `koncept` a poté projít své PDF a najít možného viníka (citace, křížové odkazy, plovoucí objekty v horní části stránek...), abyste mohli, *doufejme*..., najít způsob, jak upravit/přeformulovat text, aby se problému předešlo. ## Další informace Pokud se s tímto problémem setkáte jako s fatální chybou, může být potřeba trochu detektivní práce k dohledání přesné příčiny. Na tex.stackexchange je několik diskusí, ale všimněte si, že některé z těchto stránek vznikly ještě před tím, než pdfTeX snížil závažnost chyby na varování: * * * --- # 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/otazky-a-odpovedi/83-what-does-pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-mean.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.