rst2pdf README is a PDF front-end for Docutils that is compatible with the rst2*.py front ends of the Docutils suite. It enables the generation of PDF documents from a reStructuredText source in one step cleaning up intermediate files. is implemented as a combination of Docutils' and rubber by Emmanuel Beffara.

Copyright: © 2008 Günter Milde
Licensed under the Apache License, Version 2.0 Provided WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND


for the reStructuredText -> LaTeX conversion
pdflatex and friends
A recent LaTeX installation including pdflatex.

Rubber is a program whose purpose is to handle all tasks related to the compilation of LaTeX documents. This includes compiling the document itself, of course, enough times so that all references are defined, and running BibTeX to manage bibliographic references. Automatic execution of dvips to produce PostScript documents is also included, as well as usage of pdfLaTeX to produce PDF documents.

Rubber packages exist for Debian, Gentoo, FreeBSD, NetBSD, Fink and Darwin.

The current development version contains many bug fixes: rubber snapshot


Copy the file into a directory in the operating system's PATH for executable binaries or create a link.

Usage [options] [<source> [<destination>]]

Get a list of supported options with --help.

Configuration uses the "latex" writer for conversion from reStructuredText which is configured in the [latex2e writer] section of the configuration files. (See Docutils Configuration)

Currently, the options for rubber are "hardcoded" in Therfore, the configuration of the LaTeX -> PDF conversion requires changing the settings directly in the (well documented) file.


In case of errors, reproduce the document-generating steps by hand to localise the problem:

Send bug reports to the author or the docutils-users list.