pandoc-gpp

pandoc-gpp is a wrapper aroung pandoc and gpp allowing pandoc users who want to go from markdown to pdf/html to :

• include files
• add missing features : underline, color
• include code directly
• include images with specific ratio
• include graphs
• include tables based on csv files

The code is still evolving to cope with different type of limitations of the markdown specifications.

Installation

Python dependencies

pandoc-gpp depends on three external python packages :

• pygal (version >= 1.0.0) for the generation of graphs in svg
• CairoSVG (version >= 0.5) for the conversion of png from svg
• cssselect (version >= 0.8) extra dependency for CairoSVG

These dependencies will be installed (if not present) during the installation of pandoc-gpp.

Prerequisites

To use pandoc-gpp some packages are required : python (version 2.6 is ok). It's needed to run pandoc-gpp (which is written in python), python-dev, python-cairo, gpp, build-essential (you need a gcc compiler), libxslt1-dev (cairosvg needs lxml which needs xslt and libxml2)

Installation

To install pandoc-gpp, simply do :

$ sudo python setup.py install

Limitations

pandoc-gpp does provide several macros that are available for some input formats and some output formats. It is mainly dedicated to markdown as input format and HTML/EPUB/LATEX/PDF for output formats. However, some macros only include code (so it's up to you to make included code match the current code) and others translate to markdown before being processed by pandoc.

License

This software is licensed under the AGPL v3.0 License. See the COPYING file in the top distribution directory for the full license text.