Пустая библиография

Путь, бэкенд, отсутствующий 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 почти всегда называет настоящего виновника. Если вопросительные знаки остаются и после того, как сама библиография появилась, см. урок «Как убрать загадочные метки цитирования».

Вернуться к Чтение логов