Почему компилировать нужно не один раз

Файлы .aux, проходы библиографии и почему при первом запуске вместо ссылок печатается ??.

Почему компилировать нужно не один раз

Рано или поздно вы скомпилируете документ, откроете PDF и увидите ?? на месте номера рисунка или цитаты. Ничего не сломано. Одна компиляция — это один проход по вашему файлу, а часть информации за один проход узнать принципиально нельзя.

Вот проблема в миниатюре. На странице 2 вы пишете «см. рисунок \ref{fig:results}», но этот рисунок оказывается на странице 7. Когда движок верстает страницу 2, до страницы 7 он ещё не дошёл и понятия не имеет, какой номер получит рисунок. То же относится к оглавлению: ему нужны номера страниц всех разделов, хотя первая страница ещё даже не закончена.

Как движок это решает

Движок LaTeX читает ваш файл .tex, раскрывает каждый макрос и записывает PDF. Рядом с PDF он пишет небольшие вспомогательные файлы: .aux для меток и цитат, .toc для оглавления, .bbl для отформатированной библиографии. Эти файлы — записки, которые движок оставляет самому себе на будущее.

  1. При первом проходе движок верстает ваш текст и записывает в файл .aux каждый встретившийся \label и \cite, а везде, где нужен ещё неизвестный номер, печатает ??.
  2. Если вы что-то цитируете, программа для библиографии (bibtex или biber) читает файл .aux, ищет каждую цитату в вашей базе .bib и записывает отформатированный список литературы в файл .bbl.
  3. При втором, а иногда и третьем проходе движок читает эти вспомогательные файлы обратно, и перекрёстные ссылки, записи оглавления и метки цитат наконец превращаются в настоящие номера.

Современные настройки запускают эти проходы автоматически, так что на практике команды вы набираете редко. Но знание цикла объясняет симптом: свежие ?? после добавления метки или цитаты означают лишь то, что вспомогательные файлы ещё не обновились, и одна лишняя компиляция всё исправит.

Движки в одной строке

Роль «движка» могут играть несколько программ. pdfLaTeX — классический выбор с самой широкой поддержкой журналов. XeLaTeX добавляет полноценный Unicode и позволяет использовать шрифты, установленные в вашей системе. LuaLaTeX тоже понимает Unicode и встраивает язык сценариев для продвинутых пакетов. Tectonic — современный движок, который скачивает пакеты по требованию, когда они нужны впервые. Oleafly включает его в поставку, поэтому новый проект компилируется без предварительной установки дистрибутива TeX.

Для большинства документов различия почти не важны: берите то, чего ждёт ваш шаблон или издание, и двигайтесь дальше. Когда нужно выбирать осознанно, смотрите сравнение движков.

Когда что-то действительно не работает

Неудачная компиляция выдаёт длинный журнал, и естественный порыв — читать его снизу вверх. Не поддавайтесь. Читайте первую ошибку в журнале и исправляйте только её: последующие ошибки очень часто оказываются каскадным шумом, порождённым первой. Если после двух подряд успешных компиляций вместо ссылок по-прежнему печатается ??, обычный виновник — опечатка в имени \label или \ref, а не пропущенный проход.

Вернуться к Открыть цикл