-------------
PDF Generator
-------------
The PDF Generator plugin automatically exports articles and pages as PDF files
as part of the site generation process. PDFs are saved to:
``output/pdf/``
Requirements
------------
You should ensure you have the ``rst2pdf`` module installed, which can be
accomplished via::
pip install rst2pdf
If you are converting Markdown sources to PDF, you also need the ``xhtml2pdf``
module, which can be installed with::
pip install xhtml2pdf
Usage
-----
To customize the PDF output, you can use the following settings in your
Pelican configuration file::
PDF_STYLE = ''
PDF_STYLE_PATH = ''
``PDF_STYLE_PATH`` defines a new path where ``rst2pdf`` will look for style
sheets, while ``PDF_STYLE`` specifies the style you want to use. For a
description of the available styles, please read the `rst2pdf documentation`_.
.. _rst2pdf documentation: http://rst2pdf.ralsina.me/handbook.html#styles
Known Issues
------------
Relative links in the form of ``|filename|images/test.png`` are not yet handled
by the PDF generator.
