https://github.com/maxkratz/docker_pandoc-builder
Unofficial Docker image for Pandoc, LaTeX, and the Eisvogel template.
https://github.com/maxkratz/docker_pandoc-builder
docker docker-image dockerhub eisvogel latex markdown pandoc texlive tuc
Last synced: 3 months ago
JSON representation
Unofficial Docker image for Pandoc, LaTeX, and the Eisvogel template.
- Host: GitHub
- URL: https://github.com/maxkratz/docker_pandoc-builder
- Owner: maxkratz
- Created: 2023-09-08T13:05:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-19T14:37:48.000Z (over 1 year ago)
- Last Synced: 2023-12-19T16:36:43.297Z (over 1 year ago)
- Topics: docker, docker-image, dockerhub, eisvogel, latex, markdown, pandoc, texlive, tuc
- Language: Dockerfile
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Pandoc Builder
*Unofficial* [Pandoc](https://github.com/jgm/pandoc) Dockerfile.
Prebuild images can be found at this [Dockerhub repository](https://hub.docker.com/r/maxkratz/pandoc-builder).
## Quickstart
After installing [Docker](https://docs.docker.com/get-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.
```sh
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:
```sh
docker run --rm -it -v ${PWD}:/data maxkratz/pandoc-builder:latest make
```
## Dockerfile
The [Dockerfile](https://github.com/maxkratz/docker_pandoc-builder/blob/main/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](https://www.tug.org/texlive/acquire-netinstall.html)
* [Pandoc](https://github.com/jgm/pandoc)
* [Eisvogel template](https://github.com/Wandmalfarbe/pandoc-latex-template)
## Issues & Contribution
If you find any problems, bugs or missing packages, feel free to open an [issue on GitHub](https://github.com/maxkratz/docker_pandoc-builder/issues).
## 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](./LICENSE) file for more details.