This repo holds source files for a set of Docker containers suitable for generating documents via LaTeX, pandoc and similar tools. Each container is described in turn below.
Source files for a Docker container providing Latex and pdflatex, including several latex packages I find useful for several projects.
The container uses an Ubuntu 16.04 base and installs texlive from a PPA which provides the latest texlive (at the time of creation apt sources provided texlive 2017 which results in some trouble down the road with tex repositories).
See the setup.sh file for a list of included LaTeX packages.
The container's entrypoint is set to pdflatex and its working directory /io is exposed as a volume. Input files should be placed in /io and the outout files will be placed there as well. As an example, to generate a pdf from /path/to/test.tex, run
docker run --rm --name pdflatex -v /path/to:/io kimvanwyk/latex test.texThe output file will be placed in /path/to.
For ease of use, the included script run_pdflatex.sh will execute pdflatex for a supplied path and place the produced file into the same path. The realpath command is required to use it. The same example using the script:
./run_pdflatex.sh /path/to/test.texThe output file will again be placed in /path/to.
To run a different texlive tool, override the entrypoint. For e.g. to run lualatex:
docker run --rm --entrypoint "lualatex" --name lualatex -v /path/to:/io kimvanwyk/latex test.texThe build.sh file builds the container, naming it kimvanwyk/latex to remain consistent with DockerHub.
The container is published on DockerHub here: https://hub.docker.com/r/kimvanwyk/latex/.
Source files for a Docker container providing pandoc, built on top of my latex container to include several latex packages I find useful for various projects.
The container's entrypoint is set to pandoc and its working directory /io is exposed as a volume. Input files should be placed in /io. Output files will be placed there as well. As an example, to generate a pdf from /path/to/test.md, run
docker run --rm --name pandoc -v -v /path/to:/io kimvanwyk/pandoc:1.0.0 -o test.pdf test.mdThe output file will be placed in /path/to.
For ease of use, the included script run_pandoc.py will execute pandoc for a supplied path and place the produced file into the same path. Python 3 is required to use it. The same example using the script:
./run_pandoc.py /path/to/test.tex test.pdfThe output file will again be placed in /path/to.
The build.sh file builds the container, naming it kimvanwyk/pandoc to remain consistent with DockerHub.
The container is published on DockerHub here: https://hub.docker.com/r/kimvanwyk/pandoc/.