/dita-ot-pdf-css-page

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

Primary LanguageXSLTApache License 2.0Apache-2.0

dita-ot-pdf-css-page

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

Installation

  1. Download and install one of the PDF formatters:
  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 (PDFreactor\lib\pdfreactor.jar or vivliostyle\vivliostyle_formatter_core.exe).

Optional parameters:

  • html.pdf.formatter (pdfreactor|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, PDFReactor 8 and Vivlistyle Formatter 2016.1.