> 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/asiakirjan-rakenne/09-hyperlinks.md). # Hyperlinkit LaTeX on erinomainen työkalu tulostettaville, ammattimaisen näköisille asiakirjoille, mutta sitä voidaan käyttää myös PDF-tiedostojen luomiseen erinomaisilla navigointityökaluilla. Tässä artikkelissa kuvataan, miten dokumenttiin luodaan hyperlinkkejä ja miten LaTeX-asiakirjat asetetaan katsottaviksi PDF-lukijalla. ## Johdanto Aloitetaan minimaalisella toimivalla esimerkillä yksinkertaisesti tuomalla **hyperref** paketti kaikki [ristiviitatut elementit](/latex/fi/asiakirjan-rakenne/03-cross-referencing-sections-equations-and-floats.md) tulevat hyperlinkeiksi. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{Hyperlinkkiesimerkki} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{Esipuhe} {\huge {\bf Esipuhe}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{Esimerkkimerkintä} {\huge {\bf Esimerkkimerkintä}} \Blindtext \mainmatter \chapter{Ensimmäinen luku} Tästä tulee tyhjä luku \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} Yhtälö \ref{eq:1} osoittaa summan, joka hajaantuu. Tätä kaavaa käytetään myöhemmin sivulla \pageref{second}. \Blindtext \clearpage \section{Toinen osa} \label{second} \blindtext \Blinddocument \end{document} ``` [Avaa tämä `hyperref` esimerkki Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+hyperref+example\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cusepackage%7Bblindtext%7D%0A%5Cusepackage%7Bhyperref%7D%0A%0A%5Ctitle%7BExample+of+Hyperlinks%7D%0A%5Cauthor%7BOverleaf%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cfrontmatter%0A%5Ctableofcontents%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BForeword%7D%0A%7B%5Chuge+%7B%5Cbf+Foreword%7D%7D%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BDummy+entry%7D%0A%7B%5Chuge+%7B%5Cbf+Dummy+entry%7D%7D%0A%0A%5CBlindtext%0A%5Cmainmatter%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0AThis+will+be+an+empty+chapter%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AThe+equation+%5Cref%7Beq%3A1%7D+shows+a+sum+that+is+divergent.+This+formula+will+be+used+later+on+page+%5Cpageref%7Bsecond%7D.%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D+%5Clabel%7Bsecond%7D%0A%0A%5Cblindtext%0A%5CBlinddocument%0A%5Cend%7Bdocument%7D) ![Hyperref-esimerkkiasiakirja](/files/5dd15655c8f6808b34dd1aa4d1f00982a12dbd21) Sisällysluettelon rivit muuttuvat linkeiksi asiakirjan vastaaville sivuille yksinkertaisesti lisäämällä asiakirjan johdantoon rivi ```latex \usepackage{hyperref} ``` On oltava varovainen tuotaessa `hyperref`: yleensä sen täytyy olla viimeinen tuotava paketti, mutta tähän sääntöön voi olla joitakin poikkeuksia. ## Tyylit ja värit Linkkien oletusmuotoilua voidaan muuttaa, jotta dokumenttiesi tiedot esitettäisiin selkeämmin. Alla on esimerkki: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf-esimerkki}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{Ensimmäinen luku} Tästä tulee tyhjä luku ja aion sijoittaa tähän jonkin verran tekstiä \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} Yhtälö \ref{eq:1} osoittaa summan, joka hajaantuu. Tätä kaavaa käytetään myöhemmin sivulla \pageref{second}. Lisäviitteitä varten katso \href{http://www.overleaf.com}{Jotakin Linkkiä} tai siirry seuraavaan URL-osoitteeseen: \url{http://www.overleaf.com} tai avaa seuraava tiedosto \href{run:./file.txt}{File.txt} On myös mahdollista linkittää suoraan mikä tahansa sana tai \hyperlink{thesentence}{mikä tahansa lause} dokumentissasi. \end{document} ``` [Avaa esimerkki `hyperref` paketista Overleafissa](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Another+hyperref+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ![HyperrefEx2OverleafVa.png](/files/ccb69febf95f3ec147153ce3d27c048f3722f90b) ![HyperrefEx2OverleafVb.png](/files/cd66d97e21e869ed401c0a0e858459a9aa1544af) Tämä on täydellinen esimerkki, joka selitetään kokonaan tämän artikkelin loppuosassa. Alla on kuvaus komennoista, jotka liittyvät linkkien väriin ja tyyliin. **\hypersetup{ ... }** Tämä asettaa asetukset, joilla määritetään linkkien käyttäytyminen asiakirjassa. Jokainen parametri on erotettava pilkulla, ja syntaksin on oltava muodossa parametri=arvo. **colorlinks=true** Linkit värjätään, oletusväri on punainen. **linkcolor=blue** Sisäiset linkit, eli ristiviitauselementeistä muodostetut linkit, näytetään sinisinä. **filecolor=magenta** Linkit paikallisiin tiedostoihin näytetään magentan värisinä (katso paikallisten tiedostojen linkittäminen). **urlcolor=cyan** Linkit verkkosivuille asetetaan syaanin värisiksi (katso verkko-osoitteiden linkittäminen). **urlstyle{same}** Oletusasetuksilla linkit tulostuvat mono-tyylisillä tasalevyisillä fonteilla; tämä komento muuttaa sen ja näyttää linkit samassa tyylissä kuin muu teksti. ## Verkko-osoitteiden linkittäminen Linkkejä verkkosoitteeseen tai sähköpostiin voidaan lisätä LaTeX-tiedostoon käyttäen `\url` -komentoa itse linkin näyttämiseen tai `\href` piilotetun linkin käyttämiseen ja sanan/lauseen näyttämiseen sen sijaan. ```latex Lisäviitteitä varten katso \href{http://www.overleaf.com}{Jotakin Linkkiä} tai siirry seuraavaan URL-osoitteeseen: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/e185cc663e02114e2f6b4b8eefb96bd1103fc5f0) Esimerkissä on kaksi komentoa, jotka luovat linkin lopulliseen asiakirjaan: **\href{ Linkkiä}** Tähän komentoon välitetään kaksi parametria; ensimmäinen on linkin URL-osoite, tässä tapauksessa , ja toinen on napsautettava näytettävä teksti, Jotakin Linkkiä. **\url{** Tämä komento näyttää parametrina annetun URL-osoitteen ja tekee siitä linkin; hyödyllinen, jos aiot tulostaa asiakirjan. [Avaa esimerkki hyperref-paketista Overleaffissa](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Paikallisten tiedostojen linkittäminen Komennot `\href` ja `\url` edellisessä osassa esiteltyjä voidaan käyttää paikallisten tiedostojen avaamiseen ```latex Lisäviitteitä varten katso \href{http://www.overleaf.com}{Jotakin Linkkiä} tai siirry seuraavaan URL-osoitteeseen: \url{http://www.overleaf.com} tai avaa seuraava tiedosto \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/44ff993696c2858d9cef80067525bdc89715fb97) Komento `\href{run:./file.txt}{File.txt}` tulostaa tekstin `File.txt` joka linkittää paikalliseen tiedostoon nimeltä `file.txt` sijaitsee nykyisessä työhakemistossa. Huomaa teksti `run:` ennen tiedostopolun alkua. Tiedostopolku noudattaa UNIX-järjestelmien käytäntöjä käyttäen `.` viittaamaan nykyiseen hakemistoon ja `..` edelliseen hakemistoon. Komento `\url{}` voidaan myös käyttää samalla syntaksilla kuin polussa kuvatulla, mutta sen on raportoitu aiheuttavan joitakin ongelmia. [Avaa esimerkki hyperref-paketista Overleaffissa](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Linkkien lisääminen manuaalisesti Aiemmin mainittiin, että kaikista ristiviitatuista elementeistä tulee linkkejä, kun **hyperref** tuodaan, joten voimme käyttää `\label` millä tahansa asiakirjassa ja viitata myöhemmin näihin tunnisteisiin linkkien luomiseksi. Tämä ei ole ainoa tapa lisätä hyperlinkkejä manuaalisesti. ```latex On myös mahdollista linkittää suoraan mikä tahansa sana tai \hyperlink{thesentence}{mikä tahansa lause} asiakirjassasi. Jos luet tämän tekstin, et saa mitään tietoa. Todellako? Eikö mitään tietoa ole? Esimerkiksi \hypertarget{thesentence}{tämä lause}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/f3bde6a844d3f697e7e5df2e9e2a609011a30524) Käyttäjän määrittämiä linkkejä varten on kaksi komentoa. **\hypertarget{thesentence}{tämä lause}** Tähän komentoon aaltosulkeissa välitetty ensimmäinen parametri on tämän lauseen yksilöllinen tunniste. Toinen parametri on teksti "tämä lause", ja se tulostetaan normaalisti (riippuen anchorcolor-arvosta, katso viiteopas), mutta kun tunnisteeseen "thesentence" osoittavaa linkkiä napsautetaan, PDF-tiedosto vierii tähän kohtaan. **\hyperlink{thesentence}{mikä tahansa lause}** Tämä komento tulostaa tekstin "mikä tahansa lause" napsautettavana elementtinä, joka ohjaa kohtaan, jonka tunniste on "thesentence". [Avaa esimerkki hyperref-paketista Overleaffissa](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## PDF:lle ominaiset asetukset Asiakirjan linkit luodaan ajatellen asiakirjaa, joka luetaan PDF-muodossa. PDF-tiedostoa voidaan edelleen personoida lisäämään lisätietoja ja muuttamaan tapaa, jolla PDF-lukija näyttää sen. Alla esimerkki: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf-esimerkki}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/b9326bfc51f9e7145e6321b56a17208b0d16c665) Käyttämällä komentoa `\hypersetup`, kuvattu osiossa [tyylit ja värit](#styles-and-colours), hyväksyy lisäparametreja lopullisen PDF-tiedoston määrittämiseksi. **pdftitle={Overleaf-esimerkki}** on PDF-tulostetiedoston otsikko, joka näytetään ikkunan otsikkopalkissa. Esimerkissä se on "Overleaf-esimerkki". **pdfpagemode=FullScreen** PDF-lukija avaa asiakirjan koko näytön tilassa. Katso [viiteopas](#reference-guide) täydellinen luettelo vaihtoehdoista, joita `\hypersetup`. [Avaa esimerkki hyperref-paketista Overleaffissa](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Viiteopas **Linkkien tyylivaihtoehdot** | Asetus | Oletusarvo | Kuvaus | | ------------- | ---------- | --------------------------------------------------------------------------------- | | `hyperindex` | tosi | Tekee hakemisto-merkintöjen sivunumeroista hyperlinkkejä | | `linktocpage` | epätosi | Tekee sisällysluettelossa linkiksi tekstin sijaan sivunumerot. | | `breaklinks` | epätosi | Sallii linkkien jakautumisen usealle riville. | | `colorlinks` | epätosi | Värittää linkkien ja ankkurien tekstin; nämä värit näkyvät tulostetussa versiossa | | `linkcolor` | punainen | Normaalien sisäisten linkkien väri | | `anchorcolor` | musta | Ankkuri- (kohde-) tekstin väri | | `citecolor` | vihreä | Bibliografisten viittausten väri | | `filecolor` | syaani | Paikalliset tiedostot avaavien linkkien väri | | `urlcolor` | magenta | URL-linkkien väri | | `frenchlinks` | epätosi | Käytä linkeissä värejen sijaan pieniä kapiteeleja | **PDF:lle ominaiset asetukset** | Asetus | Oletusarvo | Kuvaus | | ----------------- | ---------- | --------------------------------------------------------------------------------------------------------------------- | | `bookmarks` | tosi | Acrobatin kirjanmerkit kirjoitetaan, samoin kuin sisällysluettelo. | | `bookmarksopen` | epätosi | Kirjanmerkit näytetään niin, että kaikki alipuuna haarat ovat laajennettuina. | | `citebordercolor` | 0 1 0 | Viittausten ympärillä olevan laatikon väri RGB-muodossa. | | `filebordercolor` | 0 .5 .5 | Tiedostoihin johtavien linkkien ympärillä olevan laatikon väri RGB-muodossa. | | `linkbordercolor` | 1 0 0 | Normaalien linkkien ympärillä olevan laatikon väri RGB-muodossa. | | `menubordercolor` | 1 0 0 | Valikkolinkkien ympärillä olevan laatikon väri RGB-muodossa. | | `urlbordercolor` | 0 1 1 | URL-osoitteisiin johtavien linkkien ympärillä olevan laatikon väri RGB-muodossa. | | `pdfpagemode` | tyhjä | Määrittää, miten tiedosto avataan. Vaihtoehdot ovat UseThumbs (pikkukuvat), UseOutlines (kirjanmerkit) ja FullScreen. | | `pdftitle` | | Asettaa asiakirjan otsikon. | | `pdfauthor` | | Asettaa asiakirjan tekijän. | | `pdfstartpage` | 1 | Määrittää, millä sivulla PDF-tiedosto avataan. | ## Lisälukemista Lisätietoja on kohdassa * [Sisällysluettelo](/latex/fi/asiakirjan-rakenne/02-table-of-contents.md) * [Osat ja luvut](/latex/fi/asiakirjan-rakenne/01-sections-and-chapters.md) * [Ristiinviittaukset osioihin ja yhtälöihin](/latex/fi/asiakirjan-rakenne/03-cross-referencing-sections-equations-and-floats.md) * [Värien käyttäminen LaTeXissa](/latex/fi/muotoilu/13-using-colors-in-latex.md) * [Hallinta suuressa projektissa](/latex/fi/asiakirjan-rakenne/07-management-in-a-large-project.md) * [Hyperrefin käyttöopas](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [Hyperlinkkejä käsittelevä artikkeli Wikikirjoissa](http://en.wikibooks.org/wiki/LaTeX/Hyperlinks) --- # 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/asiakirjan-rakenne/09-hyperlinks.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.