groovytron/pandoc repository overview

⁠Pandoc container

Container embedding pandoc and some pandoc filter to convert files from a format to another.

⁠Supported tags and respective Dockerfile links

• 2.7.3, latest (2.7.3/Dockerfile⁠)
• 2.7.2 (2.7.2/Dockerfile⁠)

⁠Softwares embedded in the container

• curl⁠ to generate diagrams using a tool like kroki⁠
• inotify-tools⁠ if you want to rebuild your documentation on every file change with inotifywait⁠
• make
• pandoc⁠
• pandoc-crossref⁠ filter
• pandoc-include-code⁠ filter

⁠Use the container

We recommend you to use the dev user instead of root when running that container.

The container's working directory is /home/dev/doc so we advise you to mount your project's documentation directory onto this place.

⁠Building the project interactively in the container

To run the container and open a bash in your documentation project run the following command:

docker run -it --entrypoint /bin/bash --user=dev --volume=<path-to-your-documentation-directory>:/home/dev/doc groovytron/pandoc:latest