여러 번 컴파일해야 하는 이유

aux 파일, 참고문헌 처리 단계, 그리고 첫 실행에서 참조가 ??로 출력되는 이유.

여러 번 컴파일해야 하는 이유

언젠가는 문서를 컴파일하고 PDF를 열었는데, 그림 번호나 인용이 있어야 할 자리에 ??가 나와 있는 것을 보게 됩니다. 고장 난 것은 아무것도 없습니다. 컴파일 한 번은 파일을 한 차례 훑는 것이고, 어떤 정보는 한 차례 훑어서는 알 수 없기 때문입니다.

문제를 작게 줄여서 보겠습니다. 2페이지에 “see Figure \ref{fig:results}“라고 썼는데, 그 그림은 7페이지에 놓입니다. 엔진이 2페이지를 조판할 때는 아직 7페이지에 도달하지 못했으므로, 그 그림이 몇 번이 될지 알 수 없습니다. 목차도 마찬가지입니다. 목차는 첫 페이지가 끝나기도 전에 모든 절의 페이지 번호를 알아야 합니다.

엔진은 이 문제를 어떻게 해결할까

LaTeX 엔진은 .tex 파일을 읽고, 모든 매크로를 풀어서 PDF를 만듭니다. PDF와 함께 작은 보조 파일도 만듭니다. 레이블과 인용을 위한 .aux, 목차를 위한 .toc, 서식이 적용된 참고문헌을 위한 .bbl입니다. 이 파일들은 엔진이 다음 실행의 자신을 위해 남겨 두는 메모입니다.

  1. 첫 번째 단계에서 엔진은 텍스트를 조판하면서 만나는 모든 \label과 \cite를 .aux 파일에 기록하고, 아직 알지 못하는 번호가 필요한 자리에는 ??를 출력합니다.
  2. 인용이 하나라도 있으면, 참고문헌 도구(bibtex 또는 biber)가 .aux 파일을 읽고, .bib 데이터베이스에서 각 인용을 찾아, 서식이 적용된 참고문헌 목록을 .bbl 파일에 씁니다.
  3. 두 번째, 때로는 세 번째 단계에서 엔진이 그 보조 파일을 다시 읽어 들이므로, 상호 참조, 목차 항목, 인용 레이블이 마침내 실제 번호로 채워집니다.

요즘 환경은 이 단계들을 자동으로 실행해 주므로, 실제로 명령을 직접 입력할 일은 거의 없습니다. 하지만 이 순환을 알면 증상이 설명됩니다. 레이블이나 인용을 추가한 뒤 새로 나타난 ??는 보조 파일이 아직 따라오지 못했다는 뜻일 뿐이며, 한 번 더 컴파일하면 해결됩니다.

엔진 소개, 한 줄씩

“엔진” 역할을 할 수 있는 프로그램은 여러 가지입니다. pdfLaTeX는 저널 지원 범위가 가장 넓은 고전적인 선택입니다. XeLaTeX는 유니코드를 완전히 지원하며, 시스템에 설치된 글꼴을 쓸 수 있게 해 줍니다. LuaLaTeX도 유니코드를 지원하고, 고급 패키지를 위한 스크립트 언어를 내장하고 있습니다. Tectonic은 패키지가 처음 필요할 때 그때그때 내려받는 현대적인 엔진입니다. Oleafly는 이 엔진을 함께 제공하므로, TeX 배포판을 먼저 설치하지 않아도 새 프로젝트를 컴파일할 수 있습니다.

대부분의 문서에서는 그 차이가 거의 중요하지 않습니다. 템플릿이나 투고처가 요구하는 것을 고르고 넘어가세요. 신중하게 골라야 할 때는 엔진 비교를 참고하세요.

실제로 무언가 실패했을 때

컴파일에 실패하면 긴 로그가 쏟아지고, 본능적으로 아래에서부터 읽고 싶어집니다. 참으세요. 로그의 첫 번째 오류를 읽고 그것만 고치세요. 뒤에 나오는 오류는 첫 번째 오류가 일으킨 연쇄적인 잡음인 경우가 아주 많습니다. 성공적인 컴파일을 두 번 연속 했는데도 참조가 계속 ??로 출력된다면, 대개 원인은 빠진 단계가 아니라 \label 또는 \ref 이름의 오타입니다.

루프 열기(으)로 돌아가기