![[ICO]](/icons/blank.gif){kind=icon}
![[DIR]](/icons/back.gif){kind=icon}
![[TXT]](/icons/text.gif){kind=icon}
| Name | Last modified | Size | Description |
|---|---|---|---|---|
| Parent Directory | - | ||
| rst2pdf.py | 30-Dec-2009 15:46 | 4.8K | |
rst2pdf.py 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.
rst2pdf.py is implemented as a combination of Docutils' rst2latex.py and rubber by Emmanuel Beffara.
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 rst2pdf.py into a directory in the operating system's PATH for executable binaries or create a link.
rst2pdf.py [options] [<source> [<destination>]]
Get a list of supported options with rst2pdf.py --help.
rst2pdf.py 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 rst2pdf.py. Therfore, the configuration of the LaTeX -> PDF conversion requires changing the settings directly in the (well documented) rst2pdf.py file.
In case of errors, reproduce the document-generating steps by hand to localise the problem:
export the document with rst2latex.py INFILE OUTFILE
convert to PDF with rubber --pdf OUTFILE
If this fails, try pdflatex OUTFILE
Send bug reports to the author or the docutils-users list.