> 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/struktura-dokumentu/09-hyperlinks.md). # Hiperłącza LaTeX to świetne narzędzie do tworzenia profesjonalnie wyglądających dokumentów do druku, ale może być też używany do generowania plików PDF z doskonałymi narzędziami nawigacyjnymi. Ten artykuł opisuje, jak tworzyć hiperłącza w dokumencie oraz jak skonfigurować dokumenty LaTeX do przeglądania w czytniku PDF. ## Wstęp Zacznijmy od minimalnego działającego przykładu, po prostu importując **hyperref** pakiet all [elementy z odwołaniami krzyżowymi](/latex/pl/struktura-dokumentu/03-cross-referencing-sections-equations-and-floats.md) stają się hiperłączami. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{Przykład hiperłączy} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{Wstęp} {\huge {\bf Przedmowa}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{Przykładowy wpis} {\huge {\bf Przykładowy wpis}} \Blindtext \mainmatter \chapter{Pierwszy rozdział} To będzie pusty rozdział \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} Równanie \ref{eq:1} pokazuje sumę, która jest rozbieżna. Z tej formuły skorzystamy później na stronie \pageref{second}. \Blindtext \clearpage \section{Druga sekcja} \label{second} \blindtext \Blinddocument \end{document} ``` [Otwórz ten `hyperref` przykład w Overleaf](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) ![Przykładowy dokument hyerref](/files/c5d73c684bf899676674943033323058b904d780) Wiersze w spisie treści stają się łączami do odpowiednich stron w dokumencie po prostu przez dodanie w preambule dokumentu linii ```latex \usepackage{hyperref} ``` Trzeba uważać podczas importowania `hyperref`: zwykle musi to być ostatni importowany pakiet — ale mogą istnieć pewne wyjątki od tej reguły. ## Style i kolory Domyślne formatowanie łączy można zmienić, aby informacje w dokumentach były przedstawione czytelniej. Poniżej możesz zobaczyć przykład: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Przykład Overleaf}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{Pierwszy rozdział} To będzie pusty rozdział i umieszczę tutaj trochę tekstu \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} Równanie \ref{eq:1} pokazuje sumę, która jest rozbieżna. Ta formuła zostanie później użyta na stronie \pageref{second}. W celu dalszych odwołań zobacz \href{http://www.overleaf.com}{Coś Linkowatego} albo przejdź do następnego adresu URL: \url{http://www.overleaf.com} albo otwórz następny plik \href{run:./file.txt}{File.txt} Można też bezpośrednio połączyć dowolne słowo lub \hyperlink{thesentence}{dowolne zdanie} w twoim dokumencie. \end{document} ``` [Otwórz przykład `hyperref` pakietu w Overleaf](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/cd2410d8d9bea2d02fe89e85cd53f067a9c4a001) ![HyperrefEx2OverleafVb.png](/files/5078fba3feb8b7134f580652f2f6e68bb05e49e5) To jest kompletny przykład, który zostanie w pełni wyjaśniony w dalszej części artykułu. Poniżej znajduje się opis poleceń związanych z kolorem i stylowaniem łączy. **\hypersetup{ ... }** To ustawi opcje konfigurujące zachowanie łączy w dokumencie. Każdy parametr musi być oddzielony przecinkami, a składnia musi mieć format parametr=wartość. **colorlinks=true** Łącza będą kolorowe, domyślny kolor to czerwony. **linkcolor=blue** Łącza wewnętrzne, czyli te generowane przez elementy z odwołaniami krzyżowymi, są wyświetlane na niebiesko. **filecolor=magenta** Łącza do lokalnych plików będą wyświetlane w kolorze magenta (zobacz łączenie lokalnych plików). **urlcolor=cyan** Łącza do stron internetowych są ustawione na kolor cyjan (zobacz łączenie adresów internetowych). **urlstyle{same}** Domyślne ustawienia drukują łącza w jednolitym stylu czcionki o stałej szerokości; to polecenie zmienia to i wyświetla łącza w tym samym stylu co reszta tekstu. ## Łączenie adresów internetowych Łącza do adresu internetowego lub e-maila można dodać do pliku LaTeX za pomocą polecenia `\url` do wyświetlenia rzeczywistego łącza lub `\href` aby użyć ukrytego łącza i zamiast tego pokazać słowo/zdanie. ```latex W celu dalszych odwołań zobacz \href{http://www.overleaf.com}{Coś Linkowatego} albo przejdź do następnego adresu URL: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/7c46f6cd79443f4b5fec04ad90efb0bdded84c2f) W przykładzie są dwa polecenia, które generują łącze w końcowym dokumencie: **\href{ Linkowatego}** Do tego polecenia przekazywane są dwa parametry: pierwszy to adres URL łącza, w tym przypadku , a drugi to klikalny tekst, który ma zostać wyświetlony, Coś Linkowatego. **\url{** To polecenie wyświetli adres URL przekazany jako parametr i zamieni go w łącze, co jest przydatne, jeśli będziesz drukować dokument. [Otwórz przykład pakietu hyperref w Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Łączenie lokalnych plików Polecenia `\href` i `\url` przedstawione w poprzedniej sekcji może być użyte do otwierania lokalnych plików ```latex W celu dalszych odwołań zobacz \href{http://www.overleaf.com}{Coś Linkowatego} albo przejdź do następnego adresu URL: \url{http://www.overleaf.com} albo otwórz następny plik \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/6e4b50cf0b6532afd2949c1ad8c2c9a67eb82d09) Polecenie `\href{run:./file.txt}{File.txt}` drukuje tekst `File.txt` który prowadzi do lokalnego pliku o nazwie `file.txt` znajdującego się w bieżącym katalogu roboczym. Zauważ tekst `run:` przed ścieżką do pliku. Ścieżka pliku jest zgodna z konwencjami systemów UNIX, używając `.` do odwołania się do bieżącego katalogu oraz `..` do katalogu poprzedniego. Polecenie `\url{}` może być również używane, z tą samą składnią opisaną dla ścieżki, ale zgłaszane są pewne problemy. [Otwórz przykład pakietu hyperref w Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Wstawianie łączy ręcznie Wspomniano wcześniej, że wszystkie elementy z odwołaniami krzyżowymi stają się łączami, gdy tylko **hyperref** jest importowany, dzięki czemu możemy używać `\label` w dowolnym miejscu dokumentu i później odwoływać się do tych etykiet, aby tworzyć łącza. Nie jest to jedyny sposób ręcznego wstawiania hiperłączy. ```latex Można też bezpośrednio połączyć dowolne słowo lub \hyperlink{thesentence}{dowolne zdanie} w twoim dokumencie. Jeśli przeczytasz ten tekst, nie uzyskasz żadnych informacji. Naprawdę? Czy nie ma żadnych informacji? Na przykład \hypertarget{thesentence}{to zdanie}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/89a6849ec75fcf3e12af7a1f0de29fa4deb91c56) Istnieją dwa polecenia do tworzenia łączy definiowanych przez użytkownika. **\hypertarget{thesentence}{to zdanie}** Pierwszy parametr przekazany w nawiasach klamrowych do tego polecenia jest unikalnym identyfikatorem tego zdania. Drugi parametr to tekst "to zdanie" i zostanie wydrukowany normalnie (w zależności od wartości anchorcolor, zobacz przewodnik referencyjny), ale po kliknięciu łącza wskazującego identyfikator "thesentence" plik PDF przewinie się do tego miejsca. **\hyperlink{thesentence}{dowolne zdanie}** To polecenie drukuje tekst "dowolne zdanie" jako element klikalny, który przekierowuje do punktu, którego identyfikatorem jest "thesentence". [Otwórz przykład pakietu hyperref w Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## Opcje specyficzne dla PDF Łącza w dokumencie są tworzone z myślą o dokumencie, który będzie czytany w formacie PDF. Plik PDF można dodatkowo spersonalizować, aby dodać dodatkowe informacje i zmienić sposób wyświetlania go przez przeglądarkę PDF. Poniżej przykład: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Przykład Overleaf}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/cb11ef7f8aba127eeee306e1584ef52c42f263de) Używając polecenia `\hypersetup`, opisanego w sekcji [style i kolory](#styles-and-colours), można przekazać dodatkowe parametry do konfiguracji końcowego pliku PDF. **pdftitle={Przykład Overleaf}** Jest to tytuł wyjściowego pliku PDF, który ma być wyświetlany na pasku tytułu okna. W przykładzie jest to "Przykład Overleaf". **pdfpagemode=FullScreen** Dokument zostanie otwarty w trybie pełnoekranowym przez czytnik PDF. Zobacz [przewodnik referencyjny](#reference-guide) pełną listę opcji, które można przekazać do `\hypersetup`. [Otwórz przykład pakietu hyperref w Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Przewodnik referencyjny **Opcje stylu łączy** | Opcja | Wartość domyślna | Opis | | ------------- | ---------------- | ------------------------------------------------------------------------ | | `hyperindex` | true | Zamienia numery stron wpisów indeksu na hiperłącza | | `linktocpage` | false | Sprawia, że w spisie treści linkiem są numery stron zamiast tekstu. | | `breaklinks` | false | Pozwala dzielić łącza na wiele wierszy. | | `colorlinks` | false | Koloruje tekst łączy i kotwic; te kolory pojawią się w wersji drukowanej | | `linkcolor` | red | Kolor dla zwykłych łączy wewnętrznych | | `anchorcolor` | black | Kolor tekstu kotwicy (celu) | | `citecolor` | green | Kolor cytowań bibliograficznych | | `filecolor` | cyan | Kolor dla łączy otwierających lokalne pliki | | `urlcolor` | magenta | Kolor dla łączy URL | | `frenchlinks` | false | Używa małych wielkich liter zamiast kolorów dla łączy | **Opcje specyficzne dla PDF** | Opcja | Wartość domyślna | Opis | | ----------------- | ---------------- | ------------------------------------------------------------------------------------------------------------- | | `bookmarks` | true | Zapisuje zakładki Acrobata, podobnie jak spis treści. | | `bookmarksopen` | false | Zakładki są wyświetlane ze wszystkimi rozwiniętymi poddrzewami. | | `citebordercolor` | 0 1 0 | Kolor ramki wokół cytowań w formacie RGB. | | `filebordercolor` | 0 .5 .5 | Kolor ramki wokół łączy do plików w formacie RGB. | | `linkbordercolor` | 1 0 0 | Kolor ramki wokół zwykłych łączy w formacie RGB. | | `menubordercolor` | 1 0 0 | Kolor ramki wokół łączy menu w formacie RGB. | | `urlbordercolor` | 0 1 1 | Kolor ramki wokół łączy do adresów URL w formacie RGB. | | `pdfpagemode` | puste | Określa sposób otwierania pliku. Możliwości to UseThumbs (miniatury), UseOutlines (zakładki) oraz FullScreen. | | `pdftitle` | | Ustawia tytuł dokumentu. | | `pdfauthor` | | Ustawia autora dokumentu. | | `pdfstartpage` | 1 | Określa, na której stronie plik PDF zostanie otwarty. | ## Dalsza lektura Więcej informacji znajdziesz w * [Spis treści](/latex/pl/struktura-dokumentu/02-table-of-contents.md) * [Sekcje i rozdziały](/latex/pl/struktura-dokumentu/01-sections-and-chapters.md) * [Odwołania krzyżowe do sekcji i równań](/latex/pl/struktura-dokumentu/03-cross-referencing-sections-equations-and-floats.md) * [Używanie kolorów w LaTeX](/latex/pl/formatowanie/13-using-colors-in-latex.md) * [Zarządzanie w dużym projekcie](/latex/pl/struktura-dokumentu/07-management-in-a-large-project.md) * [Podręcznik Hyperref](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [Artykuł o hiperłączach w Wikibooks](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/pl/struktura-dokumentu/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.