tectonic 0.4.1

A modernized, complete, embeddable TeX/LaTeX engine. Tectonic is forked from the XeTeX extension to the classic “Web2C” implementation of TeX and uses the TeXLive distribution of support files.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# build tectonic with vcpkg on Windows, Linux or macOS

## prerequisites

This guide assumes you have [git](https://git-scm.com/) installed and are
comfortable using the command-line.

## setting up your environment

If you are running macOS prior to 10.15 (Catalina), or a version of Xcode that is not up to date, you may need to [install gcc](#Install-gcc-on-macOS). Windows and Linux should be ready to go if you have a recent compiler installed.

## Install cargo-vcpkg

```sh
cargo install cargo-vcpkg
```

## Install tectonic dependencies using vcpkg

```sh
$ cargo vcpkg build
		Cloning https://github.com/microsoft/vcpkg
	cargo build
		Checkout rev 6d36e2a
	Compiling vcpkg
	Installing freetype harfbuzz[icu,graphite2]
	Compiling bzip2 (triplet x64-osx)
	Compiling zlib (triplet x64-osx)
	Compiling libpng (triplet x64-osx)
	Compiling freetype (triplet x64-osx)
	Compiling libiconv (triplet x64-osx)
	Compiling gettext (triplet x64-osx)
	Compiling graphite2 (triplet x64-osx)
	Compiling icu (triplet x64-osx)
	Compiling ragel (triplet x64-osx)
	Compiling harfbuzz (triplet x64-osx)
		Finished in 247.89s

```

## Build tectonic

Now we need to configure tectonic so it knows we are using `vcpkg` to build
the binary. This is done by setting the `TECTONIC_DEP_BACKEND` environment variable. `TECTONIC_DEP_BACKEND="vcpkg"` tells `tectonic` to use `vcpkg` instead of trying to resolve the libraries using `pkgconfig`.

For Linux and macOS, run `cargo build` with the appropriate environment variables, like this:

```sh
TECTONIC_DEP_BACKEND="vcpkg" cargo build --release
```

Or on Windows, like this for powershell:

```bat
$Env:TECTONIC_DEP_BACKEND="vcpkg"
$Env:RUSTFLAGS="-Ctarget-feature=+crt-static"
cargo build --release
```

Or like this for cmd:

```bat
set TECTONIC_DEP_BACKEND="vcpkg"
set RUSTFLAGS="-Ctarget-feature=+crt-static"
cargo build --release
```

This will take a couple of minutes but should eventually print something like:

```sh
    Finished release [optimized] target(s) in 3m 39s
```

The binary should be in `target/release`.

## Install gcc on macOS

If the `cargo vcpkg build` step fails on macOS, you may need to install another compiler. One way to do this is using [homebrew](https://brew.sh/) to install gcc.

```sh
brew install gcc
```