forked from varia/varia.website
many many many Varia's websites, work in progress: https://many.vvvvvvaria.org
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.
mb@mb
04c2824180
|
7 years ago | |
|---|---|---|
| .. | ||
| Readme.rst | 7 years ago | |
| __init__.py | 7 years ago | |
| pdf.py | 7 years ago | |
| test_pdf.py | 7 years ago | |
Readme.rst
-------------
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.