PDF の別の場所を指す
label と ref、そして名前を自動で付ける cleveref。
PDF の別の場所を指す
「図 3 を参照」と手で入力するのは、守れない約束です。論文の前のほうに図を 1 つ追加すると、その後に手で入力した番号がすべて間違いになります。LaTeX はこれを 2 つの部分からなる仕組みで解決します。\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)」と出力します。
この例では、2 つの細部がとても重要です。1 つ目は、図の中ではラベルを \caption の後に置くことです。図のカウンタを進めるのはキャプションなので、その前にラベルを置くと、静かに現在のセクション番号を拾ってしまいます。2 つ目は、Figure~\ref{...} の ~ が改行されないスペースであることです。これにより、「Figure」が行末に、「3」が次の行頭に分かれることなく、単語と番号が同じ行に保たれます。
sec:、fig:、eq: という接頭辞は、まったくの慣例です。LaTeX は求めませんが、キーが読みやすくなり、エディタの自動補完がラベルを種類ごとにまとめられます。
?? が表示される理由
ラベルを追加して最初にコンパイルしたとき、\ref は ?? を出力します。番号は、前回の実行で書き出された .aux ファイルを通じて解決されるので、新しいラベルが表示されるには、もう一度コンパイルが必要です。この仕組みはなぜ複数回コンパイルするのかで説明しています。2 回続けてコンパイルしても残る ?? は、ほぼ必ず、\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 の後に読み込まなければならない数少ないパッケージの 1 つで、通常の規則とは逆です。早めに導入しましょう。手書きの「Figure~\ref」だらけの論文に、後から \cref を組み込むのは面倒です。