컴파일되지 않는 대학 클래스 파일
문제 분류 순서: 첫 오류, 엔진, 오래된 패키지, 이진 탐색.
컴파일되지 않는 대학 클래스 파일
대학 학위논문 템플릿은 일종의 레거시 코드입니다. 대학원생 한 명이 15년 전 당시의 TeX 배포판에 맞춰 클래스 파일을 쓰고 졸업했고, 그 뒤 LaTeX 생태계가 변하는 동안 파일은 그대로 멈춰 있습니다. 지금 universitythesis.cls를 내려받았는데 화면 가득 오류가 쏟아진다면, 클래스가 망가졌다기보다 시간 속에 갇혀 있는 경우가 대부분입니다. 그래도 실패 유형은 예측할 수 있고, 정해진 순서로 점검하면 대부분 해결됩니다.
첫 번째 오류만 보세요
LaTeX 오류는 연쇄적으로 발생합니다. 클래스 앞부분의 정의되지 않은 명령 하나가 아무 의미 없는 후속 오류를 수십 개 만들어 낼 수 있습니다. 로그에서 !로 시작하는 첫 줄까지 스크롤해 그 오류를 고치고, 다른 것을 읽기 전에 다시 컴파일하세요. 이 과정을 반복하면 무시무시해 보이던 오류 더미가 서너 번 만에 사라지는 경우가 많습니다. 첫 오류가 알 수 없는 명령이라면 정의되지 않은 제어 시퀀스에서 진단 과정을 따라가 보세요.
엔진을 확인하세요
많은 템플릿이 특정 엔진을 전제로 만들어져 있어서, 다른 엔진으로 컴파일하면 이상하게 실패합니다. fontspec을 불러오거나 글꼴을 이름으로 지정하는 클래스는 XeLaTeX나 LuaLaTeX가 필요하고, pdftex 전용 기본 명령(primitive)을 바탕으로 만든 클래스는 두 엔진 모두에서 실패할 수 있습니다. 클래스 파일 맨 위의 주석이나 대학의 안내문에서 의도한 엔진이 적힌 곳을 찾아, 다른 디버깅을 하기 전에 그 엔진에 맞추세요. 엔진별 차이는 이 프로젝트에는 어떤 엔진을 쓸까에 정리되어 있습니다.
직접 고칠 수 있는 부분만 현대화하세요
오래된 템플릿은 이미 배포판에 현대적인 대체 패키지가 있는 구식 패키지를 불러오고, 그 둘이 서로 충돌합니다. 대표적인 조합은 서로 충돌하는 패키지에 있습니다. 실용적인 전략은 대학의 서식 요건이 들어 있는 클래스 파일 자체는 건드리지 않고, 직접 쓴 프리앰블만 현대화하는 것입니다. 구식 \usepackage 줄을 지우고, hyperref는 늦게 불러오고, 클래스가 이미 불러온 것은 다시 불러오지 마세요.
프리앰블을 이진 탐색하세요
눈으로 봐서는 원인을 모르겠다면, 프리앰블의 뒤쪽 절반을 주석 처리하고 다시 컴파일하세요. 오류가 사라졌다면 원인은 주석 처리한 쪽에 있습니다. 그중 절반을 되살리고 같은 과정을 반복하세요. 몇 번만 컴파일하면 문제의 한 줄을 찾아낼 수 있으며, 직접 쓰지 않은 프리앰블을 머릿속으로 따져 보는 것보다 훨씬 빠릅니다.
고생하기 전에 검색하세요
그 대학의 모든 학생이 같은 클래스를 컴파일하므로, 같은 오류를 이미 만난 사람이 거의 틀림없이 있습니다. 오류 메시지 전문을 클래스 파일 이름과 함께 검색하고, 대학이나 후배 학생이 패치한 포크를 GitHub에서 관리하고 있는지 확인하세요. 관리되는 포크가 있다면 그것을 쓰는 편이 이미 알려진 버그를 혼자 다시 고치는 것보다 낫습니다.