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 を組み込むのは面倒です。

論文の骨格 に戻る