Metadata-Version: 2.1
Name: rst2pdf
Version: 0.94
Summary: Convert reStructured Text to PDF via ReportLab.
Home-page: https://rst2pdf.org
Author: rst2pdf maintainers
Author-email: maintainers@rstpdf.org
License: MIT
Download-URL: https://github.com/rst2pdf/rst2pdf/releases
Project-URL: Source, https://github.com/rst2pdf/rst2pdf
Project-URL: Bug Reports, https://github.com/rst2pdf/rst2pdf/issues
Keywords: restructured convert rst pdf docutils pygments reportlab
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Python: ~=2.7
Description-Content-Type: text/x-rst
Requires-Dist: docutils
Requires-Dist: jinja2
Requires-Dist: pdfrw
Requires-Dist: pygments
Requires-Dist: reportlab
Requires-Dist: setuptools
Requires-Dist: six
Requires-Dist: smartypants
Provides-Extra: aafiguresupport
Requires-Dist: aafigure (>=0.4) ; extra == 'aafiguresupport'
Provides-Extra: hyphenation
Requires-Dist: wordaxe (>=1.0) ; extra == 'hyphenation'
Provides-Extra: mathsupport
Requires-Dist: matplotlib ; extra == 'mathsupport'
Provides-Extra: pdfimages
Requires-Dist: pyPdf2 ; extra == 'pdfimages'
Requires-Dist: PythonMagick ; extra == 'pdfimages'
Provides-Extra: pdfimages2
Requires-Dist: pyPdf2 ; extra == 'pdfimages2'
Requires-Dist: SWFTools ; extra == 'pdfimages2'
Provides-Extra: rawhtmlsupport
Requires-Dist: xhtml2pdf ; extra == 'rawhtmlsupport'
Provides-Extra: sphinx
Requires-Dist: sphinx (<1.8.0) ; extra == 'sphinx'
Provides-Extra: svgsupport
Requires-Dist: svg2rlg ; extra == 'svgsupport'
Provides-Extra: tests
Requires-Dist: pyPdf2 ; extra == 'tests'

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 and kerning (using wordaxe).

* `Full user's manual`__

__ https://rst2pdf.org/static/manual.pdf

Installation and use
====================

Install from PyPI
-----------------

The latest released version may be installed from PyPI by using
pip or easy_install. It does not support Python 3::

  sudo pip install rst2pdf

Install from github
--------------------

Work on rst2pdf has restarted on github, with the goals of supporting
Python 3, addressing outstanding issues, and not breaking anything. You
can clone the repository and install this version::

  git clone https://github.com/rst2pdf/rst2pdf my_clone_name
  cd my_clone_name
  git checkout <desired-branch> # if you want something other than master
  sudo python setup.py install

You may want to install it in a virtualenv, but that is beyond the scope
of this readme.

Quick-start
------------

To convert a restructuredText document to a PDF, simply::

  rst2pdf <document name> output.pdf


