Container embedding pandoc and some pandoc filter to convert files from a format to another.
- 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
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.
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