latex-docker/README.md

Latex

The repository, hosted on git.cryptic.systems, contains Dockerfiles to build container images based on different base images. Any container image has the tex compiler and the minted package included. The main goal of all container image is to compile the text source code with highlighting provided by minted into a PDF file.

Images

Available Images:

• docker.io/volkerraschek/latex:latest-archlinux

You can find a complete list of all docker images based on different distributions on Docker Hub.

Usage

Latexmk

Here is an example based on ubuntu 18.04 to compile a PDF file with latexmk from index.tex. Run this command in your root directory of your Latex files or change the volume option with the ${PWD} variable.

$ docker run \
    --rm \
    --user="$(shell id -u):$(shell id -g)" \
    --net="none" \
    --volume="${PWD}:/workspace" volkerraschek/latex:latest-archlinux \
    latexmk \
      -shell-escape \
      -synctex=1 \
      -interaction=nonstopmode \
      -file-line-error \
      -pdf index.tex

pdflatex

Here is a example based on ubuntu 18.04 to compile a PDF file with pdflatex from index.tex. Run this command in your root directory of your Latex files or change the volume option with the ${PWD} variable.

$ docker run \
    --rm \
    --user="$(shell id -u):$(shell id -g)" \
    --net="none" \
    --volume="${PWD}:/workspace" volkerraschek/latex:latest-archlinux \
    pdflatex \
      -shell-escape \
      -synctex=1 \
      -interaction=nonstopmode \
      -enable-write18 index.tex