Tectonic Install Learn Contribute The Tectonic Typesetting System

For those new to it, TeX is a programming language that you use to create typeset documents rather than computer software. TeX is quite archaic in some ways, but it’s still the tool of choice for documents that require precision typography or ones that involve lots of mathematical equations, which makes it especially important in the sciences. Tectonic converts TeX files into PDF files.

Tectonic is beta software but has been demonstrated to work well in a variety of real-world situations. Contributions in any form — documentation, bug reports, test cases, new features — are most welcome. The user forum is the place to start.

What’s in it for me?

Tectonic automatically downloads support files so you don’t have to install a full LaTeX system in order to start using it. If you start using a new LaTeX package, Tectonic just pulls down the files it needs and continues processing. The underyling “bundle” technology allows for completely reproducible document compiles . Thanks to the Dataverse Project for hosting the large LaTeX resource files!

so you don’t have to install a full LaTeX system in order to start using it. If you start using a new LaTeX package, Tectonic just pulls down the files it needs and continues processing. The underyling “bundle” technology allows for . Tectonic has sophisticated logic and automatically loops TeX and BibTeX as needed, and only as much as needed. In its default mode it doesn’t write TeX’s intermediate files and always produces a fully-processed document .

as needed, and only as much as needed. In its default mode it and . The tectonic command-line program is quiet and never stops to ask for input .

command-line program is . Thanks to the power of XeTeX, Tectonic can use modern OpenType fonts and is fully Unicode-enabled .

and is . The Tectonic engine has been extracted into a completely self-contained library so that it can be embedded in other applications.

so that it can be embedded in other applications. Tectonic has been forked from the old-fashioned WEB2C implementation of TeX and is developed in the open on GitHub using modern tools like the Rust language.

on GitHub using modern tools like the Rust language. Tectonic can be used as a GitHub Action to typeset your documents whenever a change to them is made. Thanks to Vinay Sharma for creating the action.

user@host $ tectonic paper.tex Running TeX ... note: warnings were issued by the TeX engine; use --print and/or --keep-logs for details. Running BibTeX ... Rerunning TeX because bibtex was run ... Rerunning TeX because "paper.aux" changed ... Rerunning TeX because "paper.aux" changed ... Running xdvipdfmx ... Writing paper.pdf (383521 bytes) Skipped writing 3 intermediate files (use --keep-intermediates to keep them) user@host $

About the name

The name of the project is “Tectonic,” spelled and pronounced like a regular word because it is one. Enough with the cutesy obscurantism. In cases where the name might lead to ambiguities, it should be expanded to “Tectonic typesetting.”

If you’re feeling expansive, you can interpret the name as suggesting a large change in the TeX world. Or you can think of it as suggesting a salubrious offering for weary TeX users. Either way, the root of the word does go back to the ancient Greek τέκτων, ”carpenter,” which Donald Knuth — the creator of TeX and a devout Christian — might appreciate.

Acknowledgments

Tectonic would not have been possible without decades’ worth of hard work by the people behind LaTeX, TeXLive, XeTeX, and (x)dvipdfm-x. We stand on the shoulders of giants!

The Dataverse Project kindly hosts the large bundles of LaTeX resource files that enable Tectonic’s web-download capabilities.

Copyright and licensing

Tectonic is licensed under the MIT License. This is the license under which the codebase from which it is primarily derived, XeTeX, is distributed. Various other elements of the TeX system on which Tectonic is based are licensed under other open-source licenses.