> 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/ru/struktura-dokumenta/09-hyperlinks.md). # Гиперссылки LaTeX — отличный инструмент для печатных документов профессионального вида, но его также можно использовать для создания PDF-файлов с отличными средствами навигации. В этой статье описывается, как создавать гиперссылки в документе и как настроить документы LaTeX для просмотра в PDF-ридере. ## Введение Начнём с минимального рабочего примера, просто подключив **hyperref** пакет all [элементы с перекрёстными ссылками](/latex/ru/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{First 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/88f464d6a377ddbdccffb222e06440f6834c2a83) Строки в оглавлении становятся ссылками на соответствующие страницы в документе, если просто добавить в преамбулу документа строку ```latex \usepackage{hyperref} ``` Нужно быть осторожным при подключении `hyperref`: обычно его приходится подключать последним, — но из этого правила могут быть исключения. ## Стили и цвета Форматирование ссылок по умолчанию можно изменить, чтобы информация в ваших документах была представлена более ясно. Ниже приведён пример: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Пример Overleaf}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{First 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/3eb39c4cfcff3ab382a6b01f934c8e03d02f3d31) ![HyperrefEx2OverleafVb.png](/files/c4872f1b12681aef65d3a92469d8cbb1fded0771) Это полный пример, он будет полностью объяснён в остальной части статьи. Ниже приведено описание команд, связанных с цветом и оформлением ссылок. **\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/4a66aaa1c76d0703863c54cd4c84f95ac0b13d53) В примере есть две команды, которые создают ссылку в итоговом документе: **\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/e14c4d245bfc7a1626ae6b644baba48733823fef) Команда `\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/346ac7396197f236782a507972aea784cf431889) Существует две команды для создания пользовательских ссылок. **\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}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/9f96f96ac6a3a6497529c2bc57c654252cab4dc6) Используя команду `\hypersetup`, описанную в разделе [стили и цвета](#styles-and-colours), она принимает дополнительные параметры для настройки итогового PDF-файла. **pdftitle={Пример Overleaf}** Это заголовок выходного PDF-файла, который будет показан в строке заголовка окна. В примере это "Пример Overleaf". **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/ru/struktura-dokumenta/02-table-of-contents.md) * [Разделы и главы](/latex/ru/struktura-dokumenta/01-sections-and-chapters.md) * [Перекрёстные ссылки на разделы и уравнения](/latex/ru/struktura-dokumenta/03-cross-referencing-sections-equations-and-floats.md) * [Использование цветов в LaTeX](/latex/ru/formatirovanie/13-using-colors-in-latex.md) * [Управление в большом проекте](/latex/ru/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/ru/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.