sltx 0.1.34

sltx-utility

sltx 0.1.x

1. Short overview
2. How tos'
   1. How to get
   2. How to setup
   3. How to compile
   4. How to run
3. Todos

Short overview

sltx is a simple (python 3.5+) script, i've written for my own purposes (LaTeX). It uses sltx-dep.yml files to track my latex dependencies over various repositories and installs them on the host-system. I use it only under linux, with texlive installed, but it should work for other os too. You can configure the installer for your host-system using the sltx-config.yml or supply it while installing.

How tos'

How to get

The script including the Package sltxpkg is available with pypi/sltx So simply install it like any other Python package with sltx with pip:

pip3 install sltx

Afterwards sltx should be available as a normal script! Afterwards you can updates with pip3 and the --upgrade-flag.

How to setup

If you just want the auto configuration, type

sltx auto-setup

Please note, that this command requires docker to be installed. If you have texlive or an comparable variant (having a texmf-home) installed on your local machine you may use the -d flag to download the LaTeX-libraries shipped with the container(s).

How to compile

If you just want to compile a document and have any docker container installed, use:

sltx compile <document>

If you do not want to compile in the docker-container (or if you have none), please use the following instead.

sltx raw-compile <document>

For further help add -h to the commands to get more information about arguments.

How to run

Just run sltx or sltx -h to get the help menu. If you want to install dependencies from a file like dep.yml run:

sltx dep dep.yml

If you have your own configuration, lets say it is name "config.yml" add -c config.yml.

If you want to generate a github workflow just type sltx gen-gha.

Todos

• add .sltx-src.yml or some similar file so that the repo itself can determine what it should serve? -- maybe allow different "sets"?

• Update functionality