> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/latex/ru/drugie-temy/42-referencing-figures.md).

# Ссылки на рисунки

В LaTeX мы можем *label* элементы, которые пронумерованы (разделы, формулы и т. д.), а затем использовать это *label* на *ссылаться* на них в других местах, и те же команды применимы также к окружению figure (оно нумеруется).

## Основы меток и ссылок

```latex
\label{marker}
```

Это *маркером сноски* можно рассматривать как имя, которое мы присваиваем объекту, на который хотим ссылаться. Важно добавить `\label` *после* пронумерованный элемент, например `\section`, `\subsection`, `\caption` и т. д., иначе метка не «прикрепится» к правильному номеру или счётчику.

```latex
\ref{marker}
```

Это выводит номер, присвоенный объекту с меткой *маркером сноски*.

```latex
\pageref{marker}
```

Это выводит номер страницы, на которой объект с меткой *маркером сноски* появляется.

## Компиляция документа LaTeX с метками и ссылками

Это *маркером сноски* Текст, используемый для метки объектов, нигде в документе не отображается, а ссылки на него заменяются соответствующими номерами. Если мы сослёмся на несуществующую метку, LaTeX скомпилируется успешно, но с предупреждением о неопределённых ссылках. Ссылка на неизвестную метку будет заменена на *??*.

В примере из Overleaf, приведённом выше, вы можете видеть, что мы успешно могли добавить ссылки на рисунки, включённые в документ позже. Чтобы это стало возможным, LaTeX нужно запустить дважды — при первом запуске компилируются и сохраняются все метки и их положения, а при втором запуске все ссылки заменяются на соответствующие номера. Таким образом, нам нужно скомпилировать документ дважды, чтобы увидеть правильный результат.

## Использование осмысленных имён для ссылок на рисунки

Поскольку в качестве метки можно использовать любую строку, распространённой практикой является добавлять к метке несколько букв (в качестве префикса), чтобы указать, что именно помечается. Это становится важным, когда в документе есть много разных типов объектов, на которые есть ссылки, поскольку может быть полезно помнить, к какому типу объекта относится метка. Кроме того, это также позволяет ссылаться на разные типы объектов, используя общую строку.

Например, если документ содержит

* раздел о численности населения стран,
* таблицу, содержащую данные о численности населения, и
* рисунок со столбчатой диаграммой численности населения,

может быть удобно ссылаться на все из них, используя варианты *население*. Это можно сделать, используя метки

* *sec:population* для раздела,
* *tab:population* для таблицы, и
* *fig:population* для рисунка.

Ниже приведён пример для рисунков —

```latex
\begin{figure}[h!]
  \includegraphics[scale=1.7]{birds.jpg}
  \caption{Птицы}
  \label{fig:birds}
\end{figure}
```

Снова обратите внимание, что `\label` присваивается *после* `\caption`.

 [Открыть пример в Overleaf](https://www.overleaf.com/project/new/template/26046?id=111048636\&templateName=Example+to+cross-reference+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=)


---

# 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://ayakaleaf-pro.ayaka.space/latex/ru/drugie-temy/42-referencing-figures.md?ask=<question>&goal=<endgoal>
```

`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.