rst2pdf 0.8.1

Convert restructured text to PDF via reportlab.

Copyright (c) 2007,2008 Roberto Alsina <[e-mail]>, Nicolas Laurance, Christoph Zwerschke.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Detailed Documentation

To use hyphenation you need wordaxe from http://deco-cow.sf.net (ignore the page, it’s outdated, just get the wordaxe file) and optionally pyHnj, from http://hkn.eecs.berkeley.edu/~dyoo/pyHnj/

Contributors

• Roberto Alsina <ralsina at netmanagers dot com dot ar>

• Nicolas Laurance <nlaurance at zindep dot com>

• Christoph Zwerschke

Change history

New in 0.8.1

• Support for more complex headers and footers (including image directives and tables)

• Optional inline links

• Wordaxe 0.2.6 support

• Several bugs fixed (issues 48,68,41,60,58,64,67)

• Support for system-wide config file

• Better author metadata

New in 0.8

• Support for vector graphics: SVG, EPS, PS, CDR and others (requires uniconvertor)

• Support for stdin and stdout, so you can use rst2pdf in pipes.

• Works with reportlab 2.1 and 2.2

• Simpler stylesheets (guess bulletFontName, leading, bulletFontSize from other parameters)

• Some support for sphinx

• Fixed the docutils Writer interface

• Continue processing when an image is missing

• Support for user config file

• Font sizes can be expressed in units or % of parent style’s size

• Larger font size in the default stylesheet

New in 0.7

• Automatic Type1 and True Type font embedding. Just use the font or family name, and (with a little luck), it will be embedded for you.

• width attribute in styles, to create narrow paragraphs/tables

• Styles for table headers and table cells

• “Zebra tables”

• Improvements in the handling of overflowing literal blocks (code, for instance)

• Different modes to handle too-large literal blocks: overflow/truncate/shrink.

• Real sidebars and “floating” elements.

• Fixed link style (no ugly black underlining!)

New in 0.6

• Stylesheet-defined page layout (For example, multicolumn) and layout switching

• Cascading Stylesheets (change exactly what you need changed)

• PDF table of contents

• Current section names and numbers in headers/footers

• Support for compressed PDF files

• Link color is configurable

• Fixed bugs in color handling

• Multilingual hyphenation

• Auto-guessing image size, support for sizes in %

• Gutter margins

• Big refactoring

• More tolerant of minor problems

• Limited _raw_ directive (you can insert pagebreaks and vertical space)

• Implemented a “traditional” docutils writer

• Offer a reasonable API for use as a library

• Fixed copyright/licensing

• code-block now supports including files (whole or in part) so you can highlight external code.

New in 0.5

• Support for :widths: in tables

• Support for captions in tables

• Support for multi-row headers in tables

• Improved definition lists

• Fixed bug in image directive

• Whitespace conforming to PEP8

• Fixed bug in text size on code-block

• Package is more setuptools compliant

• Fix for option groups in option lists

• Citations support

• Title reference role fix

New in 0.4

• Fixed bullet and item lists indentation/nesting.

• Implemented citations

• Working links between footnotes and its references

• Justification enabled by default

• Fixed table bug (demo.txt works now)

• Title and author support in PDF properties

• Support for document title in header/footer

• Custom page sizes and margins

New in 0.3

• Font embedding (use any True Type font in your PDFs)

• Syntax highlighter using Pygments

• User’s manual

• External/custom stylesheets

• Support for page numbers in header/footer

Download