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

Симптом

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

По-третє, перевірте наявність принаймні однієї команди \cite. Сервер форматує лише ті записи, які вимагає документ, тому чернетка без цитат отримує порожній список за дизайном. Під час раннього редагування ви можете примусово додати все за допомогою \nocite{*}, який запитує кожен запис у базі даних, не друкуючи нічого в тексті.

По-четверте, зіставте команду з системою. Класичні документи BibTeX закінчуються на \bibliographystyle{...} і \bibliography{refs}. документи biblatex завантажують базу даних у преамбулі за допомогою \addbibresource{refs.bib} і друкують її за допомогою \printbibliography. Змішування обох, наприклад, завантаження biblatex, але виклик \bibliography, призводить до цієї помилки. Те саме стосується запуску невідповідного бекенда: biblatex потребує biber, і подача йому класичного bibtex нічого не дає.

Читання власного журналу серверної частини

Сервер записує свої скарги у файл .blg поруч із вашим документом, і саме там з’являються неправильні записи, дублікати ключів і повідомлення «Я не можу відкрити файл бази даних». Якщо наведені вище кроки виглядають правильно, але список усе ще порожній, журнал .blg майже завжди вказує справжнього винуватця. Щоб дізнатися про знаки питання, які зберігаються після того, як з’явиться сама бібліографія, див.