forked from varia/varia.website
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.0 KiB
1.0 KiB
-------------
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.