View Source Get Started

Installation

With Igniter (recommended)

First, to use mix igniter.new, the archive must be installed.

To install Igniter, run:

mix archive.install hex igniter_new

Then, install Tectonic:

mix igniter.install tectonic

Manual

Add the tectonic dependency to your mix.exs:

defp deps do
  [
    {:tectonic, "~> 0.1"}
  ]
end

Edit config/config.exs to specificy the Tectonic version to install:

config :tectonic, version: "0.15.0"

And then run mix deps.get && mix deps.compile to install the dependencies.

By default, the Tectonic binary will be automatically installed/updated at application startup.

You can also install it manually by running:

$ mix tectonic.install

or if your platform isn't officially supported by Tectonic, you can supply a third party path to the binary:

$ mix tectonic.install [url]

And invoke tectonic with:

$ mix tectonic default -X compile --untrusted myfile.tex

You can also use it within your Elixir code:

Tectonic.run(:default, ~w[-X compile myfile.tex])

The executable is kept at _build/tectonic-TARGET. Where TARGET is your system target architecture.

Profiles

The first argument to tectonic is the execution profile. You can define multiple execution profiles with the current directory, the OS environment, and default arguments to the tectonic task:

config :tectonic,
  version: "0.15.0",
  compile: [
    cd: "/tmp",
    env: %{TECTONIC_UNTRUSTED_MODE: true},
    args: ~w(
      -X compile
    )
  ]

When mix tectonic compile is invoked, the task arguments will be appended to the ones configured above. Note profiles must be configured in your config/config.exs, as tectonic runs without starting your application (and therefore it won't pick settings in config/runtime.exs).