Сборка PDF через LaTeX

sobiraka [--tmpdir TMPDIR] latex [DOCUMENT] [--config CONFIG] [--output OUTPUT]

Эта команда собирает PDF-документацию из файла CONFIG (по умолчанию — sobiraka.yaml) с помощью языка разметки LaTeX.

В качестве аргумента DOCUMENT можно указать идентификатор документа, который требуется собрать. При этом в качестве аргумента OUTPUT можно указать имя для конечного файла PDF или директорию, в которой он должен быть создан. Если указана директория, то имя файла будет выбрано на основе свойства title.

Если аргумент DOCUMENT не передан, то Собирака последовательно соберёт все документы проекта. При этом в качестве аргумента OUTPUT можно указать только директорию, в которой должны быть созданы файлы PDF. Имя каждого файла будет выбрано на основе свойства title соответствующего документа.

Если аргумент OUTPUT не передан, сборка производится в директории build/pdf.

Во время сборки Собирака использует временную директорию TMPDIR (по умолчанию — build/tex). В ней создаются промежуточные файлы, необходимые для работы xelatex.

Сборка PDF через LaTeX имеет ряд недостатков.

  • Для сборки требуется пакет TeX Live, который занимает около 2 ГБ.
  • Сборка выполняется очень долго (минуту и более на крупных проектах).
  • Кастомизация внешнего вида возможна, но зачастую сложна и неинтуитивна.

Для новых проектов рекомендуется использовать сборку PDF через WeasyPrint.