> 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/uk/struktura-dokumenta/09-hyperlinks.md). # Гіперпосилання LaTeX — чудовий інструмент для друкованих професійно виглядаючих документів, але його також можна використовувати для створення PDF-файлів із чудовими засобами навігації. У цій статті описано, як створювати гіперпосилання у вашому документі та як налаштувати документи LaTeX для перегляду у PDF-читачі. ## Вступ Почнімо з мінімального робочого прикладу, просто імпортувавши **hyperref** пакет all [перехресно посилені елементи](/latex/uk/struktura-dokumenta/03-cross-referencing-sections-equations-and-floats.md) стануть гіперпосиланнями. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{Приклад гіперпосилань} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{Передмова} {\huge {\bf Передмова}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{Тестовий запис} {\huge {\bf Тестовий запис}} \Blindtext \mainmatter \chapter{Перший розділ} Це буде порожній розділ \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} Рівняння \ref{eq:1} показує суму, що розбігається. Ця формула буде використана пізніше на сторінці \pageref{second}. \Blindtext \clearpage \section{Другий розділ} \label{second} \blindtext \Blinddocument \end{document} ``` [Відкрийте цей `hyperref` приклад в 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) ![Приклад документа hyperref](/files/1660e2e29084a5c5b437e370026f772c205d9589) Рядки в змісті стають посиланнями на відповідні сторінки документа просто шляхом додавання в преамбулу документа рядка ```latex \usepackage{hyperref} ``` Потрібно бути обережним під час імпортування `hyperref`: зазвичай, його потрібно імпортувати останнім пакетом — хоча з цього правила можуть бути деякі винятки. ## Стилі та кольори Форматування посилань за замовчуванням можна змінити, щоб інформація у ваших документах подавалася зрозуміліше. Нижче ви можете побачити приклад: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf Example}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{Перший розділ} Це буде порожній розділ, і я розміщу тут трохи тексту \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} Рівняння \ref{eq:1} показує суму, що розбігається. Ця формула буде пізніше використана на сторінці \pageref{second}. Для подальших посилань див. \href{http://www.overleaf.com}{Щось із посиланням} або перейдіть до наступної URL: \url{http://www.overleaf.com} або відкрийте наступний файл \href{run:./file.txt}{File.txt} Також можна напряму посилатися на будь-яке слово або \hyperlink{thesentence}{будь-яке речення} у вашому документі. \end{document} ``` [Відкрийте приклад `hyperref` пакета в 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/2a0e16de1775179d867f03c2b7ba8684bc784714) ![HyperrefEx2OverleafVb.png](/files/951ddefe8fad0342f2dcd3eefa50def16dd3e045) Це повний приклад, його буде повністю пояснено в решті статті. Нижче наведено опис команд, пов’язаних із кольором і стилем посилань. **\hypersetup{ ... }** Це встановить параметри для налаштування поведінки посилань у документі. Кожен параметр має бути розділений комами, а синтаксис має бути у форматі параметр=значення. **colorlinks=true** Посилання будуть кольоровими, типовий колір — червоний. **linkcolor=blue** Внутрішні посилання, тобто ті, що створені перехресно посиленими елементами, відображаються синім. **filecolor=magenta** Посилання на локальні файли будуть показані пурпуровим кольором (див. посилання на локальні файли). **urlcolor=cyan** Посилання на вебсайти встановлюються блакитним кольором (див. посилання на веб-адреси). **urlstyle{same}** Параметри за замовчуванням друкують посилання моноширинним шрифтом із пробілами; ця команда змінює це й відображає посилання тим самим стилем, що й решта тексту. ## Посилання на веб-адреси Посилання на веб-адресу або електронну пошту можна додати до файлу LaTeX за допомогою `\url` команди для відображення самого посилання або `\href` для використання прихованого посилання й показу замість нього слова/речення. ```latex Для подальших посилань див. \href{http://www.overleaf.com}{Щось із посиланням} або перейдіть до наступної URL: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/27921749496f4fea7fe6d2dd97f3bd575da35bfe) У прикладі є дві команди, які створюють посилання у фінальному документі: **\href{ із посиланням}** Цій команді передаються два параметри: перший — це URL посилання, у цьому випадку , а другий — текст, на який можна натиснути, що має бути показаний: Щось із посиланням. **\url{** Ця команда покаже URL, переданий як параметр, і зробить його посиланням; це корисно, якщо ви будете друкувати документ. [Відкрити приклад пакета hyperref в 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) ## Посилання на локальні файли Команди `\href` та `\url` з попереднього розділу можна використовувати для відкриття локальних файлів ```latex Для подальших посилань див. \href{http://www.overleaf.com}{Щось із посиланням} або перейдіть до наступної URL: \url{http://www.overleaf.com} або відкрийте наступний файл \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/fbf5d5a974adc27bca1342e62b739e8939c2c4c3) Команда `\href{run:./file.txt}{File.txt}` виводить текст `File.txt` що посилається на локальний файл під назвою `file.txt` розташований у поточному робочому каталозі. Зверніть увагу на текст `run:` перед шляхом до файлу. Шлях до файлу відповідає домовленостям систем UNIX, використовуючи `.` для позначення поточного каталогу та `..` для попереднього каталогу. Команда `\url{}` також можна використовувати, з тією ж синтаксичною формою, що й для шляху, але повідомляється, що це має деякі проблеми. [Відкрити приклад пакета hyperref в 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) ## Додавання посилань вручну Раніше було зазначено, що всі перехресно посилені елементи стають посиланнями, щойно **hyperref** імпортовано, тож ми можемо використовувати `\label` у будь-якому місці документа й пізніше посилатися на ці мітки для створення посилань. Це не єдиний спосіб додавати гіперпосилання вручну. ```latex Також можна напряму посилатися на будь-яке слово або \hyperlink{thesentence}{будь-яке речення} у вашому документі. Якщо ви читаєте цей текст, то не отримаєте жодної інформації. Справді? Хіба тут немає інформації? Наприклад \hypertarget{thesentence}{це речення}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/c730be3b92dcd7494e0b803fed6dd40cbfee6793) Є дві команди для створення користувацьких посилань. **\hypertarget{thesentence}{це речення}** Перший параметр, переданий у фігурних дужках цій команді, є унікальним ідентифікатором для цього речення. Другий параметр — це текст "це речення", і він буде надрукований звичайним чином (залежно від значення anchorcolor, див. довідник), але коли буде натиснуто посилання, що вказує на ідентифікатор "thesentence", PDF-файл прокрутиться до цього місця. **\hyperlink{thesentence}{будь-яке речення}** Ця команда виводить текст "будь-яке речення" як клікабельний елемент, що перенаправляє до точки, ідентифікатор якої — "thesentence". [Відкрити приклад пакета hyperref в Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## Спеціальні параметри PDF Посилання в документі створюються з урахуванням того, що документ буде читатися у форматі PDF. PDF-файл можна додатково налаштувати, щоб додати додаткову інформацію та змінити спосіб, у який його відображає PDF-переглядач. Нижче наведено приклад: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf Example}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/4ee5a3387ea955029fb6c4d6a5769e9c9dce0507) Використовуючи команду `\hypersetup`, описану в розділі [стилі та кольори](#styles-and-colours), вона приймає додаткові параметри для налаштування фінального PDF-файлу. **pdftitle={Overleaf Example}** є заголовком вихідного PDF-файлу, який відображатиметься в рядку заголовка вікна. У прикладі це "Overleaf Example". **pdfpagemode=FullScreen** Документ буде відкрито в режимі повного екрана PDF-читачем. Дивіться [довідковий посібник](#reference-guide) для повного списку параметрів, які можна передати до `\hypersetup`. [Відкрити приклад пакета hyperref в 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) ## Довідковий посібник **Параметри стилю посилань** | Параметр | Значення за замовчуванням | Опис | | ------------- | ------------------------- | -------------------------------------------------------------------------------- | | `hyperindex` | true | Робить номери сторінок елементів покажчика гіперпосиланнями | | `linktocpage` | false | Робить посиланням у змісті номери сторінок, а не текст. | | `breaklinks` | false | Дозволяє розривати посилання на кілька рядків. | | `colorlinks` | false | Забарвлює текст посилань і якорів; ці кольори з’являтимуться в друкованій версії | | `linkcolor` | red | Колір для звичайних внутрішніх посилань | | `anchorcolor` | black | Колір тексту якоря (цілі) | | `citecolor` | green | Колір бібліографічних цитувань | | `filecolor` | cyan | Колір для посилань, що відкривають локальні файли | | `urlcolor` | magenta | Колір для пов’язаних URL-адрес | | `frenchlinks` | false | Використовує малі капітелі замість кольорів для посилань | **Спеціальні параметри PDF** | Параметр | Значення за замовчуванням | Опис | | ----------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------- | | `bookmarks` | true | Записуються закладки Acrobat, подібно до змісту. | | `bookmarksopen` | false | Закладки показуються з розгорнутими всіма піддеревами. | | `citebordercolor` | 0 1 0 | Колір рамки навколо цитувань у форматі RGB. | | `filebordercolor` | 0 .5 .5 | Колір рамки навколо посилань на файли у форматі RGB. | | `linkbordercolor` | 1 0 0 | Колір рамки навколо звичайних посилань у форматі RGB. | | `menubordercolor` | 1 0 0 | Колір рамки навколо меню-посилань у форматі RGB. | | `urlbordercolor` | 0 1 1 | Колір рамки навколо посилань на URL-адреси у форматі RGB. | | `pdfpagemode` | порожньо | Визначає, як відкривається файл. Можливі варіанти: UseThumbs (мініатюри), UseOutlines (закладки) та FullScreen. | | `pdftitle` | | Встановлює заголовок документа. | | `pdfauthor` | | Встановлює автора документа. | | `pdfstartpage` | 1 | Визначає, на якій сторінці відкривається PDF-файл. | ## Додаткове читання Для отримання додаткової інформації див. * [Зміст](/latex/uk/struktura-dokumenta/02-table-of-contents.md) * [Розділи та глави](/latex/uk/struktura-dokumenta/01-sections-and-chapters.md) * [Перехресні посилання на розділи та рівняння](/latex/uk/struktura-dokumenta/03-cross-referencing-sections-equations-and-floats.md) * [Використання кольорів у LaTeX](/latex/uk/formatuvannya/13-using-colors-in-latex.md) * [Керування у великому проєкті](/latex/uk/struktura-dokumenta/07-management-in-a-large-project.md) * [Посібник з hyperref](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [Стаття про гіперпосилання на 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/uk/struktura-dokumenta/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.