Docker Pandoc Builder

Unofficial Pandoc Dockerfile. Prebuild images can be found at this Dockerhub repository.

Quickstart

After installing Docker, just run the following command inside your LaTeX workspace. It will mount the current directory to /data inside the container. This path will be used as working directory as defined in the Dockerfile.

docker run --rm -it -v $PWD:/data maxkratz/pandoc-builder:latest pandoc input.md -o output.pdf --from markdown --template eisvogel

If you have a Makefile defined just run the following command from your workspace:

docker run --rm -it -v ${PWD}:/data maxkratz/pandoc-builder:latest make

Dockerfile

The Dockerfile can be found at the GitHub repository.

What gets installed in this image?

The following packages are installed in this Docker image:

• Some utility packages like wget and build essentials etc.
• TeX Live
• Pandoc
• Eisvogel template

Issues & Contribution

If you find any problems, bugs or missing packages, feel free to open an issue on GitHub.

Runner requirements

Currently, all actions must be run by a self-hosted GitHub runner, because GitHub-hosted runners do not have enough storage available.

Self-hosted Linux-based runners

In order to run the "GitHub Actions" pipeline on a self-hosted runner, you must ensure that you have at least one properly configured Linux-based runner added to this GitHub project.

Required packages (at least):

• curl
• wget
• grep
• docker (including buildx plugin)

License

This project is licensed under the Apache License v2.0 - see the LICENSE file for more details.