.github/workflows | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
runner-setup.sh |
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.