指向 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 之后的宏包之一,与通常的规则相反。尽早采用它。要把 \cref 改造进一篇满是手写“Figure~\ref”的论文,是件很繁琐的事。

返回 论文骨架