Readme.rst 1.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. -------------
  2. PDF Generator
  3. -------------
  4. The PDF Generator plugin automatically exports articles and pages as PDF files
  5. as part of the site generation process. PDFs are saved to:
  6. ``output/pdf/``
  7. Requirements
  8. ------------
  9. You should ensure you have the ``rst2pdf`` module installed, which can be
  10. accomplished via::
  11. pip install rst2pdf
  12. If you are converting Markdown sources to PDF, you also need the ``xhtml2pdf``
  13. module, which can be installed with::
  14. pip install xhtml2pdf
  15. Usage
  16. -----
  17. To customize the PDF output, you can use the following settings in your
  18. Pelican configuration file::
  19. PDF_STYLE = ''
  20. PDF_STYLE_PATH = ''
  21. ``PDF_STYLE_PATH`` defines a new path where ``rst2pdf`` will look for style
  22. sheets, while ``PDF_STYLE`` specifies the style you want to use. For a
  23. description of the available styles, please read the `rst2pdf documentation`_.
  24. .. _rst2pdf documentation: http://rst2pdf.ralsina.me/handbook.html#styles
  25. Known Issues
  26. ------------
  27. Relative links in the form of ``|filename|images/test.png`` are not yet handled
  28. by the PDF generator.