> 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/83-what-does-pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-mean.md). # Mitä tarkoittaa "\pdfendlink ended up in different nesting level than \pdfstartlink"? ## Joitakin taustatietoja tästä virheestä (varoitus) Kuten niiden nimet vihjaavat, `\pdfstartlink` ja `\pdfendlink` komentoja käytetään luomaan hyperlinkkejä TeX/LaTeX:lla tuotetuissa PDF-tiedostoissa — esimerkiksi linkkejä PDF-tiedoston eri sivuille tai linkkejä verkkosivustoille. Nämä komennot ovat niin sanottuja *primitiiveistä*: TeX-moottoreihin sisäänrakennettuja matalan tason komentoja — ne eivät ole makroja. Tämän seurauksena useimmat käyttäjät eivät kohtaa niitä suoraan, vaan käyttävät niitä epäsuorasti pakettien tarjoamien makrojen (komentojen) kautta, kuten `hyperref`. Kirjoitushetkellä (joulukuu 2022) `\pdfstartlink` ja `\pdfendlink` niitä tukevat vain kaksi TeX-moottoria: pdfTeX ja LuaTeX (sekä LuaHBTeX). Historiallisesti sekä pdfTeX että LuaTeX tuottivat *virheen* tyyppisen viestin ```latex \pdfendlink ended up in different nesting level than \pdfstartlink ``` vastauksena matalan tason ongelmiin, jotka liittyvät laatikkosisäkkäisyyden syvyyteen. Huomaa, että tämän viestin teksti on peräisin syvältä TeX-moottoriohjelmistosta; sitä eivät tuota mitkään LaTeX-paketit eivätkä tietenkään Overleaf. TeX Live 2021:stä alkaen pdfTeX:n ja LuaTeX:n käsittelyssä taustalla olevan (laatikkosisäkkäisyys-)ongelman osalta on eroja, ja ne käyttäytyvät nyt eri tavoin: * pdfTeX antaa nyt tuon viestin **varoituksena**, se ei enää laukaise virhettä ja kääntäminen *ei* pääty; * LuaTeX (LuaHBTeX) käsittelee tätä ongelmaa edelleen **kohtalokkaana virheenä**, mikä aiheuttaa kääntämisen päättymisen — kyseisen virheilmoituksen sanamuoto poikkeaa hieman edellä annetusta. Lukijat, jotka haluavat tutkia tarkemmin tämän virheen taustalla olevaa syytä, voivat: * avata tämän Overleaf-projektin joka kääntyy onnistuneesti pdfLaTeXilla mutta laukaisee virheen LuaLaTeXilla; * selailla [syvällistä teknistä keskustelua GitHubissa](https://github.com/latex3/latex2e/issues/94), joka käytiin johtavien TeX- ja LaTeX-asiantuntijoiden välillä. ## Mikä sen aiheuttaa käytännön tasolla? Käyttäjän näkökulmasta tämä varoitus (tai virhe) voi laueta käytettäessä `hyperref` pakettia ja hyperlinkki — kuten viite, URL-osoite tai ristiviittaus — jakautuu kahdelle sivulle tai kahteen palstaan monipalstaisessa asiakirjassa; eli linkki alkaa lähellä yhden sivun (tai palstan) loppua ja päättyy seuraavalle sivulle (tai palstalle). Kuten todettiin, pdfTeX (pdfLaTeX) TeX Live 2021:llä tai uudemmalla ei enää tuota virhettä, mutta kirjoitushetkellä (joulukuu 2022) LuaLaTeX tekee niin edelleen. Jos käytät LuaLaTeXia, tilapäinen kiertotapa asiakirjaa tehdessäsi on poistaa hyperlinkit käytöstä kirjoittamalla ```latex \hypersetup{draft} ``` juuri ennen ```latex \begin{document} ``` Vaikka tämä estää hyperlinkkejä näkymästä asiakirjassasi, se välttää virheen kirjoittamisen aikana, ja kun olet valmis kääntämään lopullisen asiakirjan, voit kommentoida pois tai poistaa `\hypersetup{draft}`. Jos kohtaat epäonnisesti tämän ongelman vielä lopullisen käännöksen vaiheessa, ota uudelleen käyttöön `draft` ja käy sitten PDF-tiedostosi läpi löytääksesi mahdollisen syyllisen (viitteet, ristiviittaukset, sivun yläreunassa olevat kelluvat elementit...), jotta voit *toivottavasti*..., löytää tavan muokata/ilmaista tekstisi uudelleen ongelman välttämiseksi. ## Lisätietoja Jos kohtaat tämän ongelman kohtalokkaana virheenä, tarkan syyn jäljittäminen voi vaatia hieman salapoliisityötä. tex.stackexchangeissa on useita keskusteluja, mutta huomaa, että osa näistä sivuista on ajalta ennen kuin pdfTeX muutti virheen varoitukseksi: * * * --- # 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/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.