procsiab/texlive-it repository overview

⁠TexLive multi-arch with Italian language

This image was built to use with CI/CD LaTeX testing and deploying pipeline, on an x86_64 machine; the image itself is based on Debian slim, and it uses bash. Moreover, the mountpoint for the compiler's workspace is under the /workspace folder (you should mount there the volume containing your sources)

Also, the container images for ARMv7, AARCH64 and x86_X64 platforms are automatically built from this repository, and available from Docker Hub⁠

⁠Building with Dockerfile

The Dockerfile is written to allow cross-architecture builds, using QEMU's user-static package: to build the image on x86 for another platform do the following:

• be sure to install qemu-user-static if you need to run the container on an architecture different from the local one;
• to build the container for aarch64, run cp $(which qemu-aarch64-static) .;
• run the build process with docker build -t myregistry/texlive-it:amd64 -f Dockerfile.aarch64 . (or with podman using podman build -t myregistry/texlive-it:amd64 -f Dockerfile.aarch64 .).

If you want to use a target architecture different from ARM 64 bit, just change the Dockerfile according to the needed qemu-static-* binary file, and copy it into the repo directory as shown above. Also, remember to specify the correct base image at the banning of the Dockerfile.

⁠Configure TexLive

You can change the installation candidates by editing the texlive.profile file, including adding or removing languages (by default Italian will be installed).

Using the file packages.txt you can provide additional packages names to be downloaded using the tlmgr package manager, when building the container image.

⁠Compiling documents from the container

1. Change directory to your soruce code root;
2. run the following command:

docker run --rm -it -v $(pwd):/workdir:z procsiab/texlive-it:1.2-amd64 bash

1. to output a PDF, from the prompt inside the container, invoke the compiler as follows:

latexmk -quiet -pdf -pdflatex="pdflatex -interaction=nonstopmode"