서로 충돌하는 패키지

hyperref는 마지막에, cleveref는 그 뒤에, 구식 조합, 최소 예제.

서로 충돌하는 패키지

LaTeX 패키지는 서로의 명령을 자유롭게 재정의할 수 있고, 많은 패키지가 의도적으로 그렇게 합니다. hyperref가 모든 상호 참조를 링크로 바꾸는 방식이 그렇습니다. 이는 두 패키지가 같은 명령을 서로 맞지 않는 가정으로 각각 고칠 수도 있다는 뜻이기도 하며, 결과는 Command \footnote already defined나 Option clash for package xcolor 같은 명백한 오류부터 조용히 틀린 출력까지 다양합니다. 충돌은 거의 언제나 잘 되던 프리앰블에 패키지를 추가한 직후에 드러나며, 이것이 가장 큰 단서이기도 합니다.

불러오는 순서가 싸움의 절반

많은 충돌은 순서만으로 해결되는데, 나중에 불러온 패키지가 마지막 말을 하기 때문입니다. 가장 중요한 규칙은 hyperref를 프리앰블의 끝 가까이에서 불러오라는 것입니다. hyperref는 LaTeX 상호 참조 장치의 상당 부분을 다시 쓰므로, 그 뒤에 불러온 패키지가 그 패치를 되돌릴 수 있습니다. 더 늦게 불러와야 하는 예외가 몇 가지 있는데, 실제로 마주치게 될 것은 cleveref로, hyperref 위에 얹히도록 설계되어 있으므로 반드시 그 뒤에 불러와야 합니다:

\usepackage{graphicx}
\usepackage{amsmath}
% ... everything else ...
\usepackage{hyperref}
\usepackage{cleveref} % after hyperref, by design

패키지 문서가 다른 패키지에 대한 위치를 지정하고 있다면 그대로 믿으세요. 그런 안내는 지금 겪으려는 충돌을 이미 누군가 겪었기 때문에 있는 것입니다.

구식 패키지와 그 대체품

어떤 충돌은 이미 수명이 다한 패키지를 그 후속 패키지와 함께 불러올 때 생깁니다. epsfig와 graphicx, subfigure와 subcaption, 또는 옛 times, mathptmx 심을 newtxtext 같은 최신 글꼴 패키지와 함께 쓰지 마세요. 옛 템플릿이 흔한 원인입니다. 템플릿이 작성되던 시점에 최신이던 것을 불러오는데, 거기에 최신 대체품을 얹기 때문입니다. 구식인 쪽을 지우고 대체품을 남기세요. nag 패키지는 컴파일할 때 오래된 사용법을 알려 줄 수 있습니다.

옵션 충돌

Option clash for package X는 패키지가 서로 다른 옵션으로 두 번 불러와졌다는 뜻이며, 문서 클래스가 몰래 한 번 불러온 경우가 많습니다. 새 옵션으로 다시 불러올 수는 없지만, 누군가 불러오기 전에 옵션을 주입할 수는 있습니다. \documentclass 앞에 \PassOptionsToPackage{table}{xcolor}를 두면 옵션이 먼저 오는 불러오기에 합쳐집니다.

최소 예제로 분리하기

원인이 분명하지 않을 때는 최소 동작 예제를 만드세요. \documentclass, 의심되는 두 패키지, 그리고 한 줄짜리 텍스트가 든 \begin{document}...\end{document}만 있는 문서입니다. 오류가 재현되면 오류가 사라질 때까지 불러오는 순서와 옵션을 바꿔 보세요. 재현되지 않으면 오류가 돌아올 때까지 다른 패키지들을 절반씩 다시 추가하세요. 이 이분 탐색은 몇 번의 컴파일 안에 수렴하며, 검색해 볼 명확한 패키지 쌍을 알려 줍니다. 같은 기법이 물려받은 프리앰블도 구해 주며, 컴파일되지 않는 대학 클래스 파일에서 설명합니다.

런타임(으)로 돌아가기