paperdigits / dita-ot-pdf-css-page

DITA Open Toolkit plugin to generate PDF output using CSS Paged Media.

dita-ot-pdf-css-page

DITA Open Toolkit plugin to generate PDF output using CSS Paged Media.

Branch	Build status
master
develop

Installation

1. Download and install one of the PDF formatters:
   • PDFReactor
   • Vivliostyle
   • AH Formatter
   • Prince
2. Download the plugin from GitHub.
3. Unzip and copy rocks.xml.pdf.css.page folder to the DITA-OT plugins directory.
4. Follow instructions at Installing plug-ins DITA-OT documentation page.

Running the plugin

Run DITA-OT with pdf-css-page transformation type.

Plugin parameters:

• html.pdf.formatter.path – PDF formatter installation path (Antenna House\AHFormatterV63\AHFCmd.exe, PDFreactor\lib\pdfreactor.jar or vivliostyle\vivliostyle_formatter_core.exe).

Optional parameters:

• html.pdf.formatter (antennahouse|pdfreactor|prince|vivliostyle) – HTML PDF formatter. Defaults to pdfreactor.
• css.file – location of the CSS file. If the property is not set, the basic stylesheet delivered with the plugin is used.
• toc (true|false) – generate Table of Contents. Defaults to true.
• index (true|false) – generate Index. Defaults to true.

dita -f pdf-css-page -i input-file -o output-dir \ 
    -Dhtml.pdf.formatter=vivliostyle \ 
    -Dhtml.pdf.formatter.path=path/to/formatter \
    -Dcss.file=css-file

The plugin was tested with DITA-OT 2.1, 2.2, AH Formatter V6, Prince 10, PDFReactor 8 and Vivlistyle Formatter 2016.1.