67. PDFs
Conversion from AsciiDoc to PDF is made possible by a number of tools.
- Asciidoctor PDF
-
A native PDF converter for Asciidoctor (converts directly from AsciiDoc to PDF using Prawn).
Instructions for installing and using Asciidoctor PDF are documented in the project’s README. The tool provides built-in theming via a YAML configuration file, which is documented in the theming guide.
Asciidoctor PDF is the preferred tool for converting to PDF and is fully supported by the Asciidoctor community. - a2x
-
A DocBook toolchain frontend provided by that AsciiDoc Python project.
To use this tool, you should first convert to DocBook using Asciidoctor, then convert the DocBook to PDF using a2x. a2x accepts a DocBook file as input and can convert it to a PDF using either Apache FOP or dblatex. Instructions for using a2x are documented in the project’s man page.
- asciidoctor-fopub
-
A DocBook toolchain frontend similar to a2x, but which only requires Java to be installed on your machine.
Instructions for using asciidoctor-fopub are documented in the project’s README. To alter the look and feel of the PDF, it’s necessary to pass XSL parameters or modify the XSLT. More information about customization can be found in DocBook XSL: The Complete Guide.