指向 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」。
這個範例有兩個細節非常重要。第一,在圖的環境中,label 必須放在 \caption 之後,因為是圖說讓圖的計數器加一;放在它前面的 label 會悄悄抓到目前章節的編號。第二,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」片語的論文,非常乏味。