CARGO_README.md

The Tectonic Typesetting System

The tectonic crate delivers a modernized, complete, self-contained TeX/LaTeX engine, powered by XeTeX and TeXLive. It provides a CLI and ties together the functionality of a large collection of sub-crates.

• User Website
• The Tectonic Book
• Installation of the CLI
• Detailed Build Instructions
• API Documentation
• Issues
• Changelog

Building Tectonic

The Tectonic crates collectively depend on a relatively large number of third-party libraries. See the Book’s build instructions for a listing and guidance on setting up the build.

The crate build can be customized with the following Cargo features:

• external-harfbuzz: build against an external version of the Harfbuzz text shaping library, rather than a vendored version (the default)
• geturl-curl: use the curl crate to implement HTTP requests. In order for this to take effect, you must use --no-default-features because geturl-reqwest is a default feature and it takes precedence
• geturl-reqwest: use the reqwest crate to implement HTTP requests (enabled by default)
• native-tls-vendored: if using reqwest, activate the vendored option in the native-tls crate, causing OpenSSL to be vendored

The Book describes some less-used features and provides a bit more detail.

Sub-crates

The main tectonic crate ties together the functionality of a number of sub-crates:

• tectonic_bridge_core
• tectonic_bridge_flate
• tectonic_bridge_freetype2
• tectonic_bridge_graphite2
• tectonic_bridge_harfbuzz
• tectonic_bridge_icu
• tectonic_bundles
• tectonic_cfg_support
• tectonic_dep_support
• tectonic_docmodel
• tectonic_engine_bibtex
• tectonic_engine_xdvipdfmx
• tectonic_engine_xetex
• tectonic_errors
• tectonic_geturl
• tectonic_io_base
• tectonic_pdf_io
• tectonic_status_base
• tectonic_xdv
• tectonic_xetex_layout