phist91/latex-texlive-pygments repository overview

⁠phist91/latex-texlive-pygments

Docker image providing a full TeX Live installation with Pygments (and therefore minted package) support. TeX Live will be downloaded via CTAN mirrors, leading to an up-to-date LaTeX major release installation by the time of image building. Build may fail at times because of CTAN choosing a broken mirror.

The Dockerfiles can be found on GitLab: https://gitlab.com/phist91/dockerfiles⁠

The image tags specify the day on which the image was built, e.g., 2024-02-01 denotes February 1, 2024. This should be helpful when older package versions are needed. Since February 2024, you can also specify the architecture (currently, amd64 or arm64), but if you do not, it will be picked automatically. I'm trying to push new images for these two architectures at least once a month.

⁠Usage

⁠For compiling local LaTeX documents

You can create a Docker container using the image and pass a directory from your machine as a volume to execute LaTeX binaries in that directory. For example, if you want to run the command latexmk in the folder /path/to/local/texfiles:

docker run --rm --volume=/path/to/local/texfiles:/texworkdir -it phist91/latex-texlive-pygments:latest /bin/bash -c "cd /texworkdir && latexmk"

See the ltxmk.sh example script on GitLab⁠ for an example how to use this command in a script.

⁠For GitLab CI

You can use the image for your Docker-powered GitLab CI pipeline. For example, your .gitlab-ci.yml could look like this:

latex:
  image: phist91/latex-texlive-pygments:latest
  script:
    - latexmk
  artifacts:
    paths:
      - my-document.pdf
    expire_in: 30 days