This repo contains the process and tools to create a Docker image for working with TeX Live. It is a manual process not governed entirely by a Dockerfile, since Tex Live installation is not automatic.

This image has the following tags:

• tl2019: TeX Live for 2019, Pandoc version 2.8.1;

• tl2020: TeX Live for 2020 as 2020-04-06, Pandoc version 2.11.4. This tag includes ImageMagick for image processing.

• tl2021: TeX Live for 2021 as 2021-03-25, Pandoc version 2.14.0.3-1. This tag also includes ImageMagick for image processing.

This build process is pretty much time and resource consuming. Consider running it on a workstation.

Steps to build the image:

• download the desired TeX Live ISO image from CTAN. It is not in the docker folder because they are really big and there is no point in incoporating it into the Docker build context. Copy it to the texlive folder and rename it to texlive.iso. Document the version used;

• download the latest release of .deb package of Pandoc from its page. Copy it to the docker/assets/pandoc folder and rename to pandoc.deb. Document the version used;

• run the texlive/000-mount-iso.sh script as sudo. It will mount the ISO into the texlive-mount-point folder;

• create a base image for working the TeX Live installation by running the docker/000 script;

• configure the common context with the name of the TeX Live distribution (the year) and activate it;

• create a non-volatile container running docker/010 and install and configure in it TeX Live. This container mounts the ISO image at /texlive. In the latest release (2021), there was an install-tl script. All default parameters were accepted, make sure A4 is used as default. Then just hit the option to start install, I;

• still inside the temporal installation container, run the /ext-src/scripts/texlive-postinstall.sh script to post-configure the installation and create users;

• when happy, exit the container and execute script 020 to commit changes to a new image called malkab/latex;

• push image with 030;

• clean up: execute 040 to delete installation container and unmount ISO;

• test with 050;

• document new versions used and create Docker tag.