Перейти к содержанию

Проблемы с компиляцией

Если вы используете latexmk, вручную повторять компиляцию не нужно: он сам запускает lualatex и biber столько раз, сколько требуется. Первый запуск latexmk в этом проекте может занимать около 74 секунд, потому что latexmk строит служебное состояние и анализирует зависимости. Повторные сборки занимают около 18 секунд, а ручной режим --no-latexmk каждый раз занимает примерно 53-54 секунды. Повторные ручные запуски нужны только при полностью ручной компиляции из раздела Сборка без Docker. Для скрипта scripts/build_latex_manual.py старый ручной режим включается флагом --no-latexmk.

Минимальная диагностика

Если проект не компилируется:

  1. Запустите команду из cmd, а не из PowerShell.
  2. Если не сработало, переименуйте .tex файл в main.tex или другое название на латинице.
  3. Попробуйте минимальную команду:
task latex:local -- --target main.tex

latexmk main.tex

Если сборка падает из-за библиографии, проверьте, что используется biber, а не bibtex.1

PDF не обновился

Если итоговый PDF не обновился, проверьте папки .aux_files и .aux_files_docker: результат мог остаться внутри вспомогательной директории.

  1. В проекте используется biblatex с backend biber; bibtex читает другой формат вспомогательных файлов и не обработает такую библиографию корректно. ↩