Порожня бібліографія

Шлях, бекенд, відсутнє цитування, 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 майже завжди називає справжнього винуватця. Про знаки питання, які лишаються після того, як сама бібліографія з’явилася, див. Як прибрати загадкові позначки цитувань.

Назад до Читання логів