Параметры командной строки

Это параметры командной строки, относящиеся к обычному авторизации документа. Для получения полного списка выполните «latex --help» в командной строке.

Во многих реализациях вы можете указать параметры командной строки, добавив их префиксы «-» или «--». Это относится как к TeX Live (включая MacTeX), так и к MiKTeX. Мы будем использовать обе конвенции взаимозаменяемо. Если параметр принимает значение, его можно указать как отдельный аргумент («--foo val»), или как один аргумент со знаком «=» («--foo=val»), но пробелы вокруг «=» не допускаются. Мы будем в основном использовать синтаксис «=».

-version

Показать текущую версию, например «pdfTeX 3.14159265-2.6-1.40.16 (TeX Live 2015/Debian)», вместе с небольшим количеством дополнительной информации и завершить работу.

-help

Вывести краткое сообщение об использовании, полезное в качестве подсказки, и завершить работу.

-interaction=mode ¶

TeX компилирует документ в одном из четырёх режимов взаимодействия: batchmode, nonstopmode, scrollmode, errorstopmode. В режиме errorstopmode (по умолчанию) TeX останавливается на каждой ошибке и запрашивает вмешательство пользователя. В режиме batchmode он ничего не выводит на терминал, сообщения об ошибках отображаются, как если бы пользователь нажимал RETURN при каждой ошибке, а отсутствующие файлы приводят к прерыванию работы. В режиме nonstopmode диагностические сообщения появляются на терминале, но, как и в режиме batch, взаимодействия пользователя нет. В режиме scrollmode TeX останавливается при отсутствии файлов или вводе с клавиатуры, но больше ничего.

Например, запуск LaTeX с этой командной строкой

pdflatex -interaction=batchmode filename

устраняет большую часть вывода на терминал.

-jobname=string

Установить значение jobname TeX в заданную строку. Файл журнала и выходной файл будут именоваться как строка.log и строка.pdf. см. Имя задачи.

-output-directory=directory

Записать файлы в каталог каталог. Он должен уже существовать. Это относится ко всем внешним файлам, созданным TeX или LaTeX, таким как файл журнала (.log) для выполнения, файлы (.aux, .toc и т.д.) созданные LaTeX, а также основной выходной файл .pdf или .dvi.

При указании выходного каталога каталог также автоматически проверяется на наличие любого файла, который он должен ввести, чтобы внешние файлы могли быть повторно прочитаны, если это необходимо. Истинный текущий каталог (в котором был запущен LaTeX) остаётся неизменным и также проверяется на наличие входных файлов.

--enable-write18

--disable-write18

--shell-escape

--no-shell-escape

Включить или отключить \write18{shell_command} (см. \write18). Первые два параметра поддерживаются как TeX Live, так и MiKTeX, а последние два являются синонимами, поддерживаемыми TeX Live.

Включение этой функциональности имеет серьёзные последствия для безопасности, поскольку позволяет файлу LaTeX выполнить любое произвольное command. Поэтому по умолчанию неограниченное \write18 не разрешено. (По умолчанию TeX Live, MacTeX и MiKTeX позволяют запускать ограниченное количество программ, относящихся к TeX, которые они распространяют).

Например, если вы вызываете LaTeX с параметром no-shell-escape, а в вашем документе вы вызываете \write18{ls -l}, то ошибка не произойдёт, но в файле журнала будет сказано «runsystem(ls -l)...disabled».

-halt-on-error

Прекратить обработку при первой ошибке.

-file-line-error

-no-file-line-error

Включить или отключить сообщения об ошибках в стиле filename:lineno:error. Эти сообщения доступны только в TeX Live или MacTeX.