Metadata-Version: 2.1
Name: pelican-pdf
Version: 1.0.2
Summary: PDF Generator is a Pelican plugin that exports articles and pages as PDF files during site generation
Home-page: https://github.com/pelican-plugins/pdf
License: AGPL-3.0
Keywords: pelican,plugin,pdf,generator
Author: Pelican Dev Team
Author-email: authors@getpelican.com
Requires-Python: >=3.7,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: Pelican
Classifier: Framework :: Pelican :: Plugins
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: markdown
Requires-Dist: markdown (>=3.2.2) ; extra == "markdown"
Requires-Dist: pelican (>=4.5)
Requires-Dist: rst2pdf (>=0.98)
Requires-Dist: xhtml2pdf (>=0.2.5)
Project-URL: Documentation, https://docs.getpelican.com
Project-URL: Funding, https://donate.getpelican.com/
Project-URL: Issue Tracker, https://github.com/pelican-plugins/pdf/issues
Project-URL: Repository, https://github.com/pelican-plugins/pdf
Description-Content-Type: text/markdown

PDF Generator: A Plugin for Pelican
===================================

[![Build Status](https://img.shields.io/github/actions/workflow/status/pelican-plugins/pdf/main.yml?branch=main)](https://github.com/pelican-plugins/pdf/actions)
[![PyPI Version](https://img.shields.io/pypi/v/pelican-pdf)](https://pypi.org/project/pelican-pdf/)
![License](https://img.shields.io/pypi/l/pelican-pdf?color=blue)

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/`

Installation
------------

This plugin can be installed via:

    python -m pip install pelican-pdf

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](https://rst2pdf.org/static/manual.html#styles).

Contributors
------------

Contributors include: Dominik Wombacher, Justin Mayer, Kyle Mahan, Renato Cunha, dpetzel, and Lucas Cimon

Contributing
------------

Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].

To start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.

[existing issues]: https://github.com/pelican-plugins/pdf/issues
[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html

License
-------

This project is licensed under the AGPL 3.0 license.

