> 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/pl/pytania-i-odpowiedzi/83-what-does-pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-mean.md). # Co oznacza „\pdfendlink ended up in different nesting level than \pdfstartlink”? ## Kilka informacji wprowadzających do tego błędu (ostrzeżenia) Jak sugerują ich nazwy, `\pdfstartlink` i `\pdfendlink` polecenia służą do tworzenia hiperłączy w plikach PDF generowanych przez TeX/LaTeX — na przykład łączy do różnych stron w pliku PDF lub łączy do witryn internetowych. Polecenia te są tak zwanymi *prymitywów*: niskopoziomowymi poleceniami wbudowanymi w silniki TeX — nie są to makra. W konsekwencji większość użytkowników nie spotyka się z nimi bezpośrednio, lecz używa ich pośrednio za pomocą makr (poleceń) dostarczanych przez pakiety takie jak `hyperref`. W chwili pisania tego tekstu (grudzień 2022) `\pdfstartlink` i `\pdfendlink` są obsługiwane tylko przez dwa silniki TeX: pdfTeX i LuaTeX (oraz LuaHBTeX). Historycznie zarówno pdfTeX, jak i LuaTeX generowały *błąd* komunikat o treści ```latex \pdfendlink znalazł się na innym poziomie zagnieżdżenia niż \pdfstartlink ``` w odpowiedzi na niskopoziomowe problemy związane z głębokością zagnieżdżania ramek. Zwróć uwagę, że treść tego komunikatu pochodzi z głębi oprogramowania silnika TeX; nie jest on generowany przez żaden pakiet LaTeX ani, rzecz jasna, przez Overleaf. Począwszy od TeX Live 2021, pdfTeX i LuaTeX zaczęły inaczej obsługiwać podstawowy problem (zagnieżdżania ramek) i teraz wykazują odmienne zachowanie: * pdfTeX teraz wyświetla ten komunikat jako **ostrzeżenie**, nie powoduje już błędu, a kompilacja *nie* zostaje przerwana; * LuaTeX (LuaHBTeX) nadal traktuje ten problem jako **błąd krytyczny**, co powoduje przerwanie kompilacji — treść tego komunikatu o błędzie nieco różni się od podanej powyżej. Czytelnicy, którzy chcą bliżej zbadać przyczynę tego błędu, mogą: * otworzyć ten projekt Overleaf który kompiluje się poprawnie w pdfLaTeX, ale wywołuje błąd w LuaLaTeX; * przejrzeć [szczegółową dyskusję techniczną na GitHubie](https://github.com/latex3/latex2e/issues/94), prowadzoną przez czołowych ekspertów od TeX-a i LaTeX-a. ## Co praktycznie powoduje ten problem? Na poziomie użytkownika to ostrzeżenie (lub błąd) może zostać wywołane podczas używania pakietu `hyperref` oraz gdy hiperłącze — na przykład cytat, adres URL lub odsyłacz — zostaje przerwane między dwiema stronami lub dwoma kolumnami w dokumencie wielokolumnowym; tzn. łącze zaczyna się pod koniec jednej strony (lub kolumny) i kończy na następnej stronie (lub kolumnie). Jak wspomniano, pdfTeX (pdfLaTeX) z TeX Live 2021 lub nowszym nie generuje już błędu, ale w chwili pisania tego tekstu (grudzień 2022) LuaLaTeX nadal to robi. Jeśli używasz LuaLaTeX, tymczasowym obejściem podczas pracy nad dokumentem jest wyłączenie hiperłączy przez wpisanie ```latex \hypersetup{draft} ``` tuż przed swoim ```latex \begin{document} ``` Chociaż zapobiega to wyświetlaniu hiperłączy w dokumencie, pozwala uniknąć błędu podczas pisania, a gdy będziesz gotowy do skompilowania końcowego dokumentu, możesz zakomentować lub usunąć `\hypersetup{draft}`. Jeśli jednak nadal napotkasz ten problem na etapie końcowej kompilacji, ponownie włącz `wersja robocza` a następnie przejrzeć plik PDF, aby znaleźć możliwego sprawcę (cytaty, odsyłacze, elementy pływające u góry stron...), tak abyś mógł, *oby*..., znaleźć sposób na edycję/przeredagowanie tekstu, aby uniknąć problemu. ## Dalsze informacje Jeśli napotkasz ten problem jako błąd krytyczny, ustalenie dokładnej przyczyny może wymagać pewnej pracy detektywistycznej. Na tex.stackexchange istnieje kilka dyskusji, ale zauważ, że niektóre z tych stron pochodzą sprzed obniżenia przez pdfTeX tego błędu do rangi ostrzeżenia: * * * --- # 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/pl/pytania-i-odpowiedzi/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.