forked from varia/varia.website
42 lines
1.0 KiB
ReStructuredText
42 lines
1.0 KiB
ReStructuredText
-------------
|
|
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.
|