Почему компилировать нужно не один раз
Файлы .aux, проходы библиографии и почему при первом запуске вместо ссылок печатается ??.
Почему компилировать нужно не один раз
Рано или поздно вы скомпилируете документ, откроете PDF и увидите ?? на месте номера рисунка или цитаты. Ничего не сломано. Одна компиляция — это один проход по вашему файлу, а часть информации за один проход узнать принципиально нельзя.
Вот проблема в миниатюре. На странице 2 вы пишете «см. рисунок \ref{fig:results}», но этот рисунок оказывается на странице 7. Когда движок верстает страницу 2, до страницы 7 он ещё не дошёл и понятия не имеет, какой номер получит рисунок. То же относится к оглавлению: ему нужны номера страниц всех разделов, хотя первая страница ещё даже не закончена.
Как движок это решает
Движок LaTeX читает ваш файл .tex, раскрывает каждый макрос и записывает PDF. Рядом с PDF он пишет небольшие вспомогательные файлы: .aux для меток и цитат, .toc для оглавления, .bbl для отформатированной библиографии. Эти файлы — записки, которые движок оставляет самому себе на будущее.
- При первом проходе движок верстает ваш текст и записывает в файл
.auxкаждый встретившийся\labelи\cite, а везде, где нужен ещё неизвестный номер, печатает??. - Если вы что-то цитируете, программа для библиографии (bibtex или biber) читает файл
.aux, ищет каждую цитату в вашей базе.bibи записывает отформатированный список литературы в файл.bbl. - При втором, а иногда и третьем проходе движок читает эти вспомогательные файлы обратно, и перекрёстные ссылки, записи оглавления и метки цитат наконец превращаются в настоящие номера.
Современные настройки запускают эти проходы автоматически, так что на практике команды вы набираете редко. Но знание цикла объясняет симптом: свежие ?? после добавления метки или цитаты означают лишь то, что вспомогательные файлы ещё не обновились, и одна лишняя компиляция всё исправит.
Движки в одной строке
Роль «движка» могут играть несколько программ. pdfLaTeX — классический выбор с самой широкой поддержкой журналов. XeLaTeX добавляет полноценный Unicode и позволяет использовать шрифты, установленные в вашей системе. LuaLaTeX тоже понимает Unicode и встраивает язык сценариев для продвинутых пакетов. Tectonic — современный движок, который скачивает пакеты по требованию, когда они нужны впервые. Oleafly включает его в поставку, поэтому новый проект компилируется без предварительной установки дистрибутива TeX.
Для большинства документов различия почти не важны: берите то, чего ждёт ваш шаблон или издание, и двигайтесь дальше. Когда нужно выбирать осознанно, смотрите сравнение движков.
Когда что-то действительно не работает
Неудачная компиляция выдаёт длинный журнал, и естественный порыв — читать его снизу вверх. Не поддавайтесь. Читайте первую ошибку в журнале и исправляйте только её: последующие ошибки очень часто оказываются каскадным шумом, порождённым первой. Если после двух подряд успешных компиляций вместо ссылок по-прежнему печатается ??, обычный виновник — опечатка в имени \label или \ref, а не пропущенный проход.