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