참고문헌이 비어 있을 때
경로, 백엔드, 빠진 cite, printbibliography와 bibliography의 차이.
참고문헌이 비어 있을 때
증상
문서는 치명적인 오류 없이 컴파일되지만 참고문헌 절이 통째로 없거나, 제목만 나오고 그 아래가 비어 있습니다. 본문의 모든 \cite가 동시에 굵은 물음표로 나타나는 경우도 많습니다. 멈춘 것은 없으므로 쫓아갈 뚜렷한 오류가 없고, 바로 그 점이 이 문제를 답답하게 만듭니다.
발생 원인
참고문헌은 LaTeX 혼자서 만드는 것이 아닙니다. 먼저 LaTeX가 인용된 키의 목록을 보조 파일에 기록합니다. 별도의 백엔드 프로그램(bibtex 또는 biber)이 .bib 데이터베이스를 읽어 해당하는 항목의 서식을 만듭니다. 마지막으로 다음 실행에서 LaTeX가 서식이 만들어진 결과를 다시 읽어 들입니다. 참고문헌이 비었다는 것은 이 파이프라인이 어딘가에서 끊겼다는 뜻입니다. 백엔드가 아예 실행되지 않았거나, 실행되었지만 데이터베이스를 찾지 못했거나, 데이터베이스는 찾았지만 요청된 키가 없었거나, 문서가 잘못된 명령으로 결과를 요청하고 있는 경우입니다.
원인을 순서대로 점검하기
첫째, 문서가 가리키는 위치에 데이터베이스 파일이 있는지 확인하세요. \bibliography{refs}와 \addbibresource{refs.bib}는 둘 다 메인 파일을 기준으로 refs.bib를 찾으므로, bib/ 하위 폴더에 있는 파일은 bib/refs 또는 bib/refs.bib로 지정해야 합니다. 경로가 틀리면 조용히 실패합니다.
둘째, 백엔드가 실제로 실행되었는지 확인하세요. 한 번의 컴파일로는 결코 충분하지 않습니다. 전체 순서는 LaTeX, 그다음 bibtex 또는 biber, 그다음 LaTeX를 두 번 더 실행하는 것입니다. Oleafly가 빌드 과정을 대신 관리해 주며, Biber를 쓰는 프로젝트에서는 TinyTeX나 시스템에 설치된 TeX 엔진을 선택하세요. 그러나 직접 구동한 빌드나 잘못 설정된 편집기 도구 체인은 가운데 단계를 건너뛸 수 있고, 그 결과가 바로 비어 있는 참고문헌 목록입니다.
셋째, \cite 명령이 하나라도 있는지 확인하세요. 백엔드는 문서가 요청한 항목만 서식화하므로, 아직 인용이 없는 초안은 설계상 빈 목록이 됩니다. 초고를 쓰는 초반에는 \nocite{*}로 전부 강제로 넣을 수 있습니다. 이 명령은 본문에는 아무것도 출력하지 않으면서 데이터베이스의 모든 항목을 요청합니다.
넷째, 명령을 시스템에 맞추세요. 클래식 BibTeX 문서는 \bibliographystyle{...}와 \bibliography{refs}로 끝납니다. biblatex 문서는 프리앰블에서 \addbibresource{refs.bib}로 데이터베이스를 불러오고 \printbibliography로 출력합니다. 둘을 섞으면, 예를 들어 biblatex를 불러오면서 여전히 \bibliography를 호출하면 바로 이 실패가 일어납니다. 잘못된 백엔드를 실행하는 경우도 마찬가지입니다. biblatex에는 biber가 필요하며, 클래식 bibtex를 먹이면 아무것도 나오지 않습니다.
백엔드 자체의 로그 읽기
백엔드는 불만 사항을 문서 옆의 .blg 파일에 기록하며, 잘못된 형식의 항목, 중복된 키, “I couldn’t open database file” 메시지가 그곳에 나타납니다. 위 단계가 모두 맞아 보이는데도 목록이 여전히 비어 있다면, 진짜 원인은 거의 항상 .blg 로그에 적혀 있습니다. 참고문헌 자체가 나타난 뒤에도 물음표가 남는 경우는 정체불명의 인용 물음표 없애기를 보세요.