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를 끼워 넣는 것은 지루한 일입니다.