Danh mục tài liệu tham khảo trống

Đường dẫn, backend, trích dẫn bị thiếu, printbibliography và bibliography.

Danh mục tài liệu tham khảo trống

Triệu chứng

Tài liệu của bạn biên dịch mà không có lỗi nghiêm trọng, nhưng mục Tài liệu tham khảo biến mất hoàn toàn, hoặc tiêu đề hiện ra mà không có gì bên dưới. Thường thì cùng lúc đó, mọi \cite trong văn bản đều hiện thành một dấu hỏi chấm đậm. Không có gì bị sập, nên không có lỗi rõ ràng nào để lần theo, và đó là điều khiến trường hợp này gây bực bội.

Vì sao nó xảy ra

Danh mục tài liệu tham khảo không chỉ do một mình LaTeX tạo ra. Trước tiên LaTeX ghi danh sách các khóa được trích dẫn vào một tệp phụ. Một chương trình backend riêng (bibtex hoặc biber) đọc cơ sở dữ liệu .bib của bạn và định dạng các mục khớp. Cuối cùng LaTeX đọc kết quả đã định dạng đó vào lại ở lượt chạy tiếp theo. Danh mục trống có nghĩa là chuỗi này bị đứt ở đâu đó: backend chưa bao giờ chạy, hoặc nó chạy nhưng không tìm thấy cơ sở dữ liệu, hoặc nó tìm thấy cơ sở dữ liệu nhưng không có khóa nào được yêu cầu, hoặc tài liệu đang đòi kết quả bằng sai lệnh.

Kiểm tra các nguyên nhân theo thứ tự

Thứ nhất, hãy xác nhận tệp cơ sở dữ liệu nằm đúng chỗ mà tài liệu khai báo. \bibliography{refs} và \addbibresource{refs.bib} đều tìm refs.bib theo đường dẫn tương đối so với tệp chính, nên một tệp nằm trong thư mục con bib/ phải được ghi là bib/refs hoặc bib/refs.bib. Đường dẫn sai sẽ thất bại một cách âm thầm.

Thứ hai, hãy chắc chắn backend đã thực sự chạy. Một lần biên dịch không bao giờ đủ; chu trình đầy đủ là LaTeX, rồi bibtex hoặc biber, rồi LaTeX thêm hai lần nữa. Oleafly quản lý các lượt build cho bạn; hãy chọn TinyTeX hoặc một engine TeX của hệ thống cho dự án dùng Biber. Tuy vậy, một lần build chạy tay hoặc chuỗi công cụ của trình soạn thảo được cấu hình sai có thể bỏ qua bước ở giữa, và kết quả chính là một danh sách tài liệu tham khảo trống.

Thứ ba, hãy kiểm tra có ít nhất một lệnh \cite trong tài liệu. Backend chỉ định dạng những mục mà tài liệu yêu cầu, nên một bản nháp chưa có trích dẫn nào sẽ có danh sách trống theo đúng thiết kế. Trong giai đoạn soạn thảo ban đầu, bạn có thể ép đưa mọi mục vào bằng \nocite{*}, lệnh này yêu cầu mọi mục trong cơ sở dữ liệu mà không in gì trong văn bản.

Thứ tư, hãy chọn lệnh khớp với hệ thống. Tài liệu BibTeX cổ điển kết thúc bằng \bibliographystyle{...} và \bibliography{refs}. Tài liệu biblatex nạp cơ sở dữ liệu trong phần preamble bằng \addbibresource{refs.bib} và in ra bằng \printbibliography. Trộn hai cách, chẳng hạn nạp biblatex nhưng vẫn gọi \bibliography, gây ra đúng lỗi này. Chạy sai backend cũng vậy: biblatex cần biber, và đưa bibtex cổ điển cho nó thì không cho ra gì cả.

Đọc nhật ký của chính backend

Backend ghi các phàn nàn của nó vào một tệp .blg cạnh tài liệu của bạn, và đó là nơi các mục sai định dạng, khóa trùng lặp và thông báo “I couldn’t open database file” xuất hiện. Nếu các bước trên đều có vẻ đúng mà danh sách vẫn trống, nhật ký .blg hầu như luôn chỉ ra thủ phạm thật sự. Với các dấu hỏi chấm vẫn còn sau khi danh mục tài liệu tham khảo đã xuất hiện, hãy xem Xóa các dấu trích dẫn bí ẩn.

Quay lại Đọc hiểu nhật ký biên dịch