Skip to content

ralsina/rst2pdf

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code
This branch is 4 commits ahead, 990 commits behind rst2pdf:main.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
doc
 
 
gui
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Intro

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

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

Installation and use

Install from PyPI

The latest released version, 0.93, 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

About

Use a text editor. Make a PDF.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 89.4%
  • Makefile 7.6%
  • Batchfile 2.8%
  • Shell 0.2%