Crate tectonic

Tectonic is a complete TeX/LaTeX engine converted into a standalone library. It is derived from the XeTeX variant of TeX and uses the support files packages by the TeX Live project. Tectonic would not be possible without the hard work that has gone into these projects.

Because Tectonic is based on the XeTeX engine, it can take advantage of the features of modern fonts (TrueType, OpenType, etc.), outputs directly to the PDF file format, and supports Unicode inputs. Tectonic differs from other TeX engines in the following ways:

• Dependencies on environment variables and configuration files have been eliminated.
• All I/O is routed through pluggable backends. Support data can be fetched from a single “bundle” file, and the engine’s (copious) output can be hidden or postprocessed.
• The command-line frontend, tectonic, has a modernized user interface that never asks for user input.
• The frontend is just a thin shim over the Tectonic Rust crate, so that the full engine can be embedded anywhere you can run Rust code.

The main module of this crate provides an all-in-wonder function for compiling LaTeX code to a PDF:

use tectonic;

let latex = r#"
\documentclass{article}
\begin{document}
Hello, world!
\end{document}
"#;

let pdf_data: Vec<u8> = tectonic::latex_to_pdf(latex).expect("processing failed");
println!("Output PDF size is {} bytes", pdf_data.len());

The driver module provides a high-level interface for driving the engines in more realistic circumstances.

Re-exports

pub use crate::engines::bibtex::BibtexEngine;

pub use crate::engines::spx2html::Spx2HtmlEngine;

pub use crate::engines::tex::TexEngine;

pub use crate::engines::tex::TexResult;

pub use crate::engines::xdvipdfmx::XdvipdfmxEngine;

pub use crate::errors::Error;

pub use crate::errors::ErrorKind;

pub use crate::errors::Result;

Modules

config	User configuration settings for the Tectonic engine.
digest	Helpers to tidy up the computation of digests in various places.
driver	This module contains the high-level interface that ties together the various engines. The main struct is ProcessingSession, which knows how to run (and re-run if necessary) the various engines in the right order.
engines	Access to Tectonic’s processing backends.
errors	Tectonic error types and support code.
io	Tectonic’s pluggable I/O backend.
status	A framework for showing status messages to the user.
unstable_opts	Unstable options for the Tectonic engine.

Macros

ctry	“Chained try” — like try!, but with the ability to add context to the error message.
errmsg	Use string formatting to create an Error of kind errors::ErrorKind::Msg.
tt_error	Report a formatted error message to the user.
tt_error_styled	Show formatted text to the user, styled as an error message.
tt_note	Report a formatted informational message to the user.
tt_warning	Report a formatted warning message to the user.

Constants

FORMAT_SERIAL

Functions

latex_to_pdf

Compile LaTeX text to a PDF.