Convert reStructured Text to PDF via ReportLab.
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
- 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 and kerning (using wordaxe).
- Sphinx integration
- Full user’s manual
rst2pdf supports Python 3.6 or greater. Version 0.97 was the last version to support Python 2.7.
Install from PyPI
The latest released version may be installed from PyPI by using pip:
$ pip install --user rst2pdf
Install from Snap
If you are using a system that supports snaps 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 master $ pip install --user .
You may want to install it in a virtualenv, but that is beyond the scope of this readme.
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.
rst2pdf wishes to be a welcoming community. With that in mind, please refer to our Community Code of Conduct.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size rst2pdf-0.98-py3-none-any.whl (170.6 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size rst2pdf-0.98.tar.gz (11.3 MB)||File type Source||Python version None||Upload date||Hashes View|