View Source Get Started
Installation
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
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
).