fortinetsolutioncse/pandoc-wk repository overview

⁠pandoc-wk

This image can be used for document conversion with pandoc. It includes wkhtmltopdf, which makes it suitable for conversion to PDF with --pdf-engine wkhtmltopdf (via HTML as an interim format).

It is based on the following two sources:

• Official pandoc core image: https://hub.docker.com/r/pandoc/core⁠
• wkhtmltopdf with patched qt library, built following these instructions: https://github.com/RoseRocket/docker-alpine-wkhtmltopdf-patched-qt⁠

The entry point of the official pandoc core image is preserved, hence the usage instructions are the same, e.g.:

docker run \
   --rm \
   --volume "$your_work_dir:/data" \
   --user $(id -u):$(id -g) \
   fortinetsolutioncse/pandoc-wk $input $any-pandoc-arguments"

In addition, the following fix has been applied to the latest version of this image, to workaround Alpine shell behavior when having document files in subdirectories: https://github.com/pandoc/dockerfiles/pull/79⁠

⁠filters

The latest version of the image includes also python3, together with the two common frameworks used for pandoc filter development: panflute and pandocfilters. This means that you can dynamically mount pandoc filters written in python.

To apply a filter, simply put it in your work directory and then pass an argument --filter myfilter.py to the end of the above command (together with any other pandoc arguments that you may want to pass).

The following filters are already pre-packaged with the latest version of the image (so that you can include them simply with --filter <filtername>, without the need to provide their source files):

• pandoc-include⁠ - to include external files and headers
• pandoc-codeblock-include⁠ - to include code snippets from external files
• pandoc-xnos⁠ - set of filters for numbering and cross-referencing of tables, figures, equations and sections