정체불명의 인용 물음표 없애기

오타, 빠진 패스, 잘못된 경로, BibTeX와 Biber 불일치.

정체불명의 인용 물음표 없애기

증상

문서는 컴파일되지만 인용이 나와야 할 자리에 굵은 물음표 [?]가 보이고, 로그에는 LaTeX Warning: Citation 'knuth84' undefined 같은 줄이 들어 있습니다. 모든 인용에서 나타날 때도 있고 한두 개에서만 나타날 때도 있습니다. 오류가 아니라 경고이기 때문에 PDF는 그대로 만들어지고, 독자가 알려 주기 전까지는 물음표를 놓치기 쉽습니다.

왜 생기는가

LaTeX는 인용을 직접 처리하지 않습니다. 첫 번째 패스에서 요청된 각 키를 보조 파일에 기록합니다. 그다음 백엔드 프로그램(bibtex 또는 biber)이 .bib 데이터베이스에서 그 키를 찾아 서식이 적용된 항목을 만듭니다. 이후 LaTeX 패스를 두 번 더 돌리면 그 결과가 문서에 반영됩니다. 물음표는 마지막 패스 시점에 그 키에 해당하는 서식 항목이 없었다는 뜻입니다. 이 증상의 원인은 모두 이 흐름 어딘가가 끊어졌다는 것입니다.

원인을 순서대로 확인하세요

먼저 키 자체를 확인하세요. \cite{knuth84}와 @article{knuth1984,...}는 서로 다른 문자열이며, 대소문자까지 정확히 일치해야 합니다. 경고에 나온 키를 .bib 파일에서 검색하세요. 어느 쪽이든 오타가 가장 흔한 원인이며, 로그에서 가장 먼저 나오는 키 누락 경고부터 해결하면 됩니다.

다음으로 컴파일 순서가 전부 실행되었는지 확인하세요. 순서는 LaTeX, bibtex 또는 biber, 그리고 LaTeX 두 번입니다. 백엔드가 아직 실행되지 않았으므로 컴파일을 한 번만 해서는 인용이 해결되지 않습니다. Oleafly가 빌드 패스를 관리합니다. 참고문헌에 Biber가 필요하면 TinyTeX나 시스템 TeX 엔진을 사용하세요. 직접 빌드하거나 편집기 설정이 잘못되어 있으면 첫 번째 패스에서 멈출 수 있습니다.

세 번째로 데이터베이스 경로를 확인하세요. \bibliography{refs}와 \addbibresource{refs.bib}는 메인 파일을 기준으로 경로를 찾으므로, 하위 폴더에 있는 데이터베이스는 bib/refs 또는 bib/refs.bib처럼 써야 합니다. 경로가 틀리면 아무 말 없이 실패하고, 보통 참고문헌 목록 전체가 사라집니다. 이 더 큰 문제는 비어 있는 참고문헌을 참고하세요.

마지막으로 백엔드가 시스템과 맞는지 확인하세요. biblatex를 불러오는 문서는 biber로 처리해야 합니다. 기존 bibtex로 처리하면 쓸 만한 출력이 나오지 않고, 몇 번을 다시 컴파일해도 모든 인용이 물음표로 남습니다.

그래도 해결되지 않으면

오래된 보조 파일이 예전의 깨진 상태를 붙잡고 있을 수 있습니다. 문서 옆에 있는 .aux, .bbl, .blg 파일을 지우고 처음부터 다시 빌드하세요. .blg 파일은 지우기 전에 읽어 볼 만합니다. 백엔드가 직접 남긴 로그이고, 없는 데이터베이스와 잘못된 항목을 구체적으로 알려 줍니다.

출처 인용(으)로 돌아가기