Tectonic is distributed as a single executable,
tectonic, that is meant to be
invoked from the command line. We’re starting to refer to this program’s
command-line interface as the “V1” interface, because a new “V2”
interface is currently under development.
The V1 interface is “rustc-like”, offering a single primary workflow with lots of options controlling its behavior. In comparison, the V2 interface is “cargo-like”, with a variety of subcommands anchored around a Tectonic.toml file defining a document to build.
The V1 interface is the default. If you want to use the V2 interface, you need to take special steps, as described in its documentation.
The V1 interface takes an input TeX file and compiles it. Basic usage is often as simple as:
This will compile the file and create
myfile.pdf if nothing went wrong. You
can use an input filename of
- to have Tectonic process standard input. (In
this case, the output file will be named
In the V1 interface there are a variety of options that control the engine’s
behavior. If you have Tectonic installed, you can view them with
The following are the available flags.
|Use this Zip-format bundle file to find resource files instead of the default|
|How much chatter to print when running [default: default] [possible values: default, minimal]|
|The name of the "format" file used to initialize the TeX engine [default: latex]|
|Prints help information|
|Tell the engine that no file at |
|Keep the intermediate files generated during processing|
|Keep the log files generated during processing|
|Write Makefile-format rules expressing the dependencies of this run to |
|Use only resource files cached locally|
|The directory in which to place output files [default: the directory containing INPUT]|
|The kind of output to generate [default: pdf] [possible values: pdf, html, xdv, aux, format]|
|Which engines to run [default: default] [possible values: default, tex, bibtex_first]|
|Print the engine's chatter during processing|
|Rerun the TeX engine exactly this many times after the first|
|Generate SyncTeX data|
|Prints version information|
|Use this URL find resource files instead of the default|