tectonic 命令

常用示例

说明

tectonic is a modernized, self-contained LaTeX engine that automatically downloads packages, runs the correct number of compilation passes, and produces reproducible output. Unlike traditional TeX distributions, it requires no separate TeX Live installation — missing packages are fetched from the network on demand. The engine automatically handles the multiple compilation passes that LaTeX typically requires for resolving references, tables of contents, bibliographies, and cross-references. Watch mode (--watch) recompiles whenever source files change, providing live preview when paired with a PDF viewer. Tectonic uses bundles — self-contained package collections — to ensure reproducible builds where the same input always produces identical output. The --only-cached flag enables offline compilation using previously downloaded packages. The V2 CLI (activated with -X) provides a cargo-like interface anchored around a Tectonic.toml file. Use `tectonic -X build` for project builds and `tectonic -X compile` for freestanding documents. This approach makes Tectonic well-suited for CI/CD pipelines and collaborative writing projects under version control.

参数

-o _DIR_

Output directory.

--synctex

Generate SyncTeX data.

--keep-intermediates

Keep .aux, .log, etc.

--keep-logs

Keep log files.

--only-cached

Don't download packages.

--watch, -w

Watch and recompile.

-b _FILE_

Use bundle file.

--print

Print mode (PDF to stdout).

--format _FMT_

Output format.

--untrusted

Disable shell-escape.

-c _FILE_

Config file.

-h, --help

Show help.

-X _SUBCOMMAND_

Activate V2 CLI (build, compile, new, init, dump, show, watch).