latexci

latexci is a docker container that can be used to automatically compile latex documents as part of a CI/CD workflow. Moreover, the container provides the possibility to automatically generated diff pdfs which are made available as artifacts after the execution of the CI/CD pipeline.

latexci is based on alpine linux and contains a medium texlive installation which should be sufficient for most of the use-cases. However, this configuration can be easily changed in the texlive.profile file. For more information, please consult the texlive manual. In case your LaTeX document relies on packages that are not available, please use texliveonfly for building your latex documents in your CI/CD chain; texliveonfly automatically fetches packages which are not installed, yet:

texliveonfly -c latexmk -a "-pdf -f -synctex=0" mydoc.tex

Status

Installation instructions

# build the docker container
docker build -t latexci .
# start the container
docker run -it latexci

Releases

All the releases are made available on Docker Hub. You can pull the latest image by executing the command below.

docker pull julianthome/latexci:latest