Посилання на інші частини PDF

label і ref, а також cleveref для автоматичних назв.

Посилання на інші частини PDF

Писати вручну «див. рисунок 3» — це обіцянка, яку ви не зможете дотримати. Додайте один рисунок раніше в статті, і кожен номер, надрукований вручну далі, стане хибним. LaTeX розв’язує це механізмом із двох частин: \label прикріплює обрану вами назву до пронумерованого об’єкта, а \ref друкує той номер, який цей об’єкт зрештою отримав. Ви посилаєтеся на назви, а компілятор стежить, щоб номери були правильними.

Label і ref

\section{Methods}\label{sec:methods}
\begin{equation}\label{eq:main} ... \end{equation}
\begin{figure}
...
\caption{...}\label{fig:pipeline}
\end{figure}
See Section~\ref{sec:methods}, Eq.~\eqref{eq:main}, and Figure~\ref{fig:pipeline}.

\label{sec:methods} записує під ключем sec:methods останній призначений номер, тут це номер розділу. Згодом \ref{sec:methods} друкує цей номер, а \eqref є варіантом з amsmath, який додає прийняті для формул круглі дужки й друкує «(1)», а не «1».

У цьому прикладі дві деталі мають велике значення. По-перше, усередині рисунка мітка має стояти після \caption, бо саме підпис збільшує лічильник рисунків; мітка перед ним мовчки візьме замість цього поточний номер розділу. По-друге, ~ у Figure~\ref{...} — це нерозривний пробіл: він тримає слово й номер в одному рядку, щоб «Figure» не опинилося в кінці одного рядка, а «3» на початку наступного.

Префікси sec:, fig: та eq: — лише домовленість. LaTeX їх не вимагає, але вони роблять ключі зрозумілими й дають змогу автодоповненню в редакторі групувати ваші мітки за видом.

Чому ви бачите ??

Під час першої компіляції після додавання мітки \ref друкує ??. Номери визначаються через файл .aux, записаний під час попереднього запуску, тож новій мітці потрібна ще одна компіляція, щоб з’явитися; механізм пояснено в статті чому доводиться компілювати більше одного разу. Якщо ?? лишається після двох компіляцій поспіль, майже завжди це означає, що ключ у \ref не збігається з ключем у \label.

cleveref пише слово за вас

З cleveref (завантажуйте після hyperref):

\usepackage{cleveref}
\cref{fig:pipeline}

\cref{fig:pipeline} друкує «Figure 3» разом із назвою типу й підлаштовується, якщо мітка виявиться на таблиці чи формулі. \Cref пише з великої літери на початку речення, а \cref{eq:a,eq:b,eq:c} стискає перелік у діапазон. Зверніть увагу на порядок завантаження: cleveref — один із небагатьох пакетів, що мають іти після hyperref, що протилежне звичайному правилу. Використовуйте його з самого початку. Переробляти статтю, повну рукописних фраз «Figure~\ref», на \cref — нудна робота.

Назад до Кістяк статті