Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython

rst2beamer is unavailable in PyPM, because there aren't any builds for it in the package repositories. Click the linked icons to find out why.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.6.6 Failed View build log
Windows (64-bit)
0.6.6 Failed View build log
Mac OS X (10.5+)
0.6.6 Failed View build log
Linux (32-bit)
0.6.6 Failed View build log
Linux (64-bit)
0.6.6 Failed View build log
 
Links
License
GPL
Dependencies
Lastest release
version 0.6.6 on Jan 5th, 2011

Introduction

A docutils script converting restructured text into Beamer-flavoured LaTeX.

Beamer is a LaTeX document class for presentations. rst2beamer [1] provides a Docutils [2] writer that transforms restructured text [3] into Beamer-flavoured LaTeX. and provides a commandline script for the same. Via this script, ReST can therefore be used to prepare slides and presentations.

Installation

rst2beamer can be installed via setuptools / easy_install or manually. Consult the enclosed manual for further details.

Usage

rst2beamer should interpret a reasonable subset of restructured text and produce reasonable LaTeX. Not all features of beamer have been implemented, just a (large) subset that allows the quick production of good looking slides. These include:

  • Overlay lists (i.e. list items that appear point-by-point)
  • Beamer themes
  • Automatic centering and resizing of figures
  • Embedded notes and the output of note slides.
  • Arranging slide contents into columns.

Some examples can be found in the docs/examples directory of the distribution. In practice, rst2beamer can be used with pdflatex to get PDF versions of a presentation.

System Message: ERROR/3 (<string>, line 38)

Content block expected for the "note" directive; none found.

.. note::

Depending on your platform, the script may be installed as rst2beamer, or rst2beamer.py.

rst2beamer is called:

System Message: WARNING/2 (<string>, line 45)

Literal block expected; none found.

rst2beamer [options] [<source> [<destination>]]

For example:

System Message: WARNING/2 (<string>, line 49)

Literal block expected; none found.

rst2beamer infile.txt outfile.tex

where infile.txt contains the ReST and outfile.tex contains the produced Beamer LaTeX.

It supports the usual docutils and LaTeX writer (rst2latex) options, save the documentclass option (which is fixed to beamer) and hyperref options (which are already set in beamer). It also supports:

--theme=THEME Specify Beamer theme.

System Message: WARNING/2 (<string>, line 59)

Option list ends without a blank line; unexpected unindent.

--overlaybullets=OVERLAYBULLETS Overlay bulleted items. Put [<+-| alert@+>] at the end of begin{itemize} so that Beamer creats an overlay for each bulleted item and the presentation reveals one bullet at a time --centerfigs=CENTERFIGS Center figures. All includegraphics statements will be put inside center environments. --documentoptions=DOCUMENTOPTIONS Specify document options. Multiple options can be given, separated by commas. Default is "10pt,a4paper". --shownotes=SHOWNOTES Print embedded notes along with the slides. Possible arguments include 'false' (don't show), 'only' (show only notes), 'left', 'right', 'top', 'bottom' (show in relation to the annotated slide).

Limitations

Earlier versions of rst2beamer did not work with docutils 0.4, seemingly due to changes in the LaTeX writer. While this has been fixed, most work has been done with docutils snapshots from version 0.5 and up. In balance, users are recommended to update docutils.

More recently, changes in the LaTeX writer in docutils 0.6 broke rst2beamer again. We think all those bugs have been caught.

Not all features of beamer are supported, and some - that deal with with page layout or presentation - may never be. Introducing complex syntax to achieve complex and specific page effects defeats the point of ReST's simple and easy-to-write format. If you need a complex presentation, use Powerpoint or Keynote.

If the content for an individual slide is too large, it will simply overflow the edges of the slide and disappear. Arguably, this is a sign you should put less on each slide.

Credits

rst2beamer is developed by Ryan Krauss and Paul-Michael Agapow. Thanks to those who reported and helped us track down bugs: Perttu Laurinen, Mike Pennington, James Haggerty and Dale Hathaway.

References

[1]

rst2beamer homepages at `agapow.net

System Message: WARNING/2 (<string>, line 111); backlink

Inline interpreted text or phrase reference start-string without end-string.

System Message: WARNING/2 (<string>, line 112)

Explicit markup ends without a blank line; unexpected unindent.

<http://www.agapow/net/software/rst2beamer>`__ and cs.siue.edu

[2]Docutils homepage
[3]Restructured text
[4]Beamer homepage

History

v0.6.6, 2009-11-06
  • Added experimental support for codeblocks, which may be syntax-colored with

System Message: WARNING/2 (<string>, line 129)

Bullet list ends without a blank line; unexpected unindent.

Pygments.

  • Normalised all directive names to r2b- (as opposed to r2b_) in

System Message: WARNING/2 (<string>, line 132)

Bullet list ends without a blank line; unexpected unindent.

line with general docutils style, although the old names are still silently supported.

v0.6.4, 2009-10-22
  • The parsed-literal environment was losing indentation, and perhaps has been

System Message: WARNING/2 (<string>, line 140)

Bullet list ends without a blank line; unexpected unindent.

since docutils 0.4. It now works correctly.

  • Added "calling" information to examples. Also added bullet example.
v0.6.2, 2009-10-20
  • It seems there have been some changes in the docutils LaTeX2e writer, which

System Message: WARNING/2 (<string>, line 149)

Bullet list ends without a blank line; unexpected unindent.

the Beamer writer is based upon. Hopefully they've all been caught.

  • Corrected url in header of source, as well as some misspellings.
v0.6.1, 2009-09-14
  • Added note environment
  • Added manual
v0.6, 2009-09-03
  • Introduced column environment
v0.5.3, 2009-07-16
  • Fixed manifest so source included (facepalm)
  • Changed setup.py to get single-file module to install
v0.5.1, 2009-05-08
  • Expanded documentation.
v0.5, 2009-05-07
  • Shift to setuptools distribution with script installation.
v0.3, 2009-03-25
  • RK takes over. Sections and subsections are supported. Images default to being centered and having a height of 0.7textheight.
v0.2.1, 2008-08-30
  • Date approximate. Earlier versions of rst2beamer did not work with docutils 0.4, seemingly due to changes in the LaTeX writer.
v0.2.0, 2007-08-30
  • Date approximate. Initial release.

Subscribe to package updates

Last updated Jan 5th, 2011

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.