Metadata-Version: 2.2
Name: rst2pdf
Version: 0.102
Summary: Convert reStructured Text to PDF via ReportLab.
Home-page: https://rst2pdf.org
Download-URL: https://github.com/rst2pdf/rst2pdf/releases
Author: rst2pdf maintainers
Author-email: maintainers@rstpdf.org
License: MIT
Project-URL: Bug Reports, https://github.com/rst2pdf/rst2pdf/issues
Project-URL: Source, https://github.com/rst2pdf/rst2pdf
Keywords: restructured convert rst pdf docutils pygments reportlab
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: docutils
Requires-Dist: importlib_metadata
Requires-Dist: jinja2
Requires-Dist: packaging
Requires-Dist: pygments
Requires-Dist: pyyaml
Requires-Dist: reportlab
Requires-Dist: smartypants
Provides-Extra: aafiguresupport
Requires-Dist: aafigure; extra == "aafiguresupport"
Provides-Extra: mathsupport
Requires-Dist: matplotlib; extra == "mathsupport"
Provides-Extra: plantumlsupport
Requires-Dist: plantuml; extra == "plantumlsupport"
Provides-Extra: rawhtmlsupport
Requires-Dist: xhtml2pdf; extra == "rawhtmlsupport"
Provides-Extra: sphinx
Requires-Dist: sphinx; extra == "sphinx"
Provides-Extra: svgsupport
Requires-Dist: svglib; extra == "svgsupport"
Provides-Extra: tests
Requires-Dist: pymupdf; extra == "tests"
Requires-Dist: pytest; extra == "tests"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

.. image:: https://img.shields.io/pypi/v/rst2pdf.svg
    :target: https://pypi.org/project/rst2pdf/

.. image:: https://img.shields.io/pypi/pyversions/rst2pdf.svg
    :target: https://pypi.org/project/rst2pdf/

.. image:: https://img.shields.io/pypi/l/rst2pdf.svg
    :target: https://pypi.org/project/rst2pdf/

=======================================
rst2pdf: Use a text editor. Make a PDF.
=======================================

The usual way of creating PDF from reStructuredText is by going through LaTeX.
This tool provides an alternative by producing PDF directly using the ReportLab
library.

More information is available at the `main website <https://rst2pdf.org>`_.


Features
--------

* User-defined page layout. Multiple frames per page, multiple layouts per
  document.

* Page transitions

* Cascading stylesheet mechanism, define only what you want changed.

* Supports TTF and Type1 font embedding.

* Any number of paragraph styles using the class directive.

* Any number of character styles using text roles.

* Custom page sizes and margins.

* Syntax highlighter for many languages, using Pygments.

* Supports embedding almost any kind of raster or vector images.

* Supports hyphenation.

* `Sphinx <https://www.sphinx-doc.org>`_ integration

* `Full user's manual <https://rst2pdf.org/static/manual.pdf>`_

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

*rst2pdf* supports Python 3.8 or greater. Version 0.99 was the last version to support Python 3.6 & 3.7, with 0.97 the last version to support Python 2.7.

Install from PyPI
~~~~~~~~~~~~~~~~~

The latest released version may be installed from PyPI by using ``pipx``::

    $ pipx install rst2pdf

rst2pdf also has support for a number of features that require additional dependencies. Installation of all the
required dependencies using ``pipx`` may be installed using::

    $ pipx install rst2pdf[aafiguresupport,mathsupport,plantumlsupport,rawhtmlsupport,sphinx,svgsupport]

Install from Snap
~~~~~~~~~~~~~~~~~

If you are using a system that supports `snaps <https://snapcraft.io/>`__
then you can install from there with::

    $ snap install rst2pdf

Install from GitHub
~~~~~~~~~~~~~~~~~~~

Work on rst2pdf has restarted on GitHub, with the goals of adding new
features, addressing outstanding issues, and not breaking anything. You
can clone the repository and install this version::

    $ git clone https://github.com/rst2pdf/rst2pdf
    $ cd rst2pdf
    $ git checkout <desired-branch> # if you want something other than main
    $ pipx install .[aafiguresupport,mathsupport,plantumlsupport,rawhtmlsupport,sphinx,svgsupport]

If you intend to work on rst2pdf's source code, see ``doc/DEVELOPERS.rst``.


Usage
-----

To convert a reStructuredText document to a PDF, simply run::

    $ rst2pdf <document name> output.pdf

For information on available options, use ``-h``::

    $ rst2pdf -h

To enable basic integration with Sphinx, modify your ``conf.py`` file to enable
the ``rst2pdf.pdfbuilder`` extension and configure the ``pdf_documents``
option. For example::

    extensions = [
        # ...
        'rst2pdf.pdfbuilder',
    ]

    # Grouping the document tree into PDF files. List of tuples
    # (source start file, target name, title, author, options).
    pdf_documents = [
        ('index', 'MyProject', 'My Project', 'Author Name'),
    ]

For information on the ``pdf_documents`` option and the many other options
available, refer to the `manual <https://rst2pdf.org/static/manual.pdf>`_.

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

See `CONTRIBUTING <CONTRIBUTING.rst>`_.

Code of conduct
---------------

rst2pdf is an inclusive and welcoming community. To participate in this project, everyone is bound by our
`Community Code of Conduct <CODE_OF_CONDUCT.rst>`_.
