jirafs-pandoc 1.2

Installation

1. Install from PIP:

   pip install jirafs-pandoc

2. Enable for a ticket folder:

   jirafs plugins --enable=pandoc

Note that you can globally enable this (or any) plugin by adding the --global flag to the above command:

jirafs plugins --global --enable=pandoc

Requirements

Depending upon which output format you utilize, your requirements may vary:

• PDF Output: Both pandoc and xelatex are required.

• Other output formats: Only pandoc is required.

Supported Input Formats and Extensions

• Text Formats (extra)

  • *.text

  • *.txt

• HTML (html)

  • *.html

  • *.htm

• JSON (pandoc AST) (json)

  • *.json

• Latex (latex)

  • *.latex

  • *.tex

  • *.ltx

• Markdown (markdown)

  • *.markdown

  • *.mkd

  • *.md

  • *.pandoc

  • *.pdk

  • *.pd

  • *.pdc

• Native Pandoc (native)

  • *.hs

• reStructuredText (rst)

  • *.rst

• Textile (textile)

  • *.textile

Supported Output Formats

Common output formats include:

• PDF (pdf)

• HTML (html)

• RTF (rtf)

But, you can use any output format supported by Pandoc. Please check which formats your version of Pandoc supports by running:

pandoc --help

Optional Configuration

• Default Input Formats: markdown, reStructuredText, and textile. See Configuring Input Formats for details on how to limit or expand which files will be transformed.

• Default Output Format: PDF. See Configuring Output Format for details on how to set which output format will be used.

jirafs config --set pandoc.enabled_input_extensions rst,textile

jirafs config --set pandoc.enabled_input_formats markdown,textile

jirafs config --set pandoc.output_format html