Metadata-Version: 1.0
Name: bruce
Version: 3.1
Summary: Bruce, the Presentation Tool, puts reStructuredText in your projector
Home-page: http://r1chardj0n3s.googlepages.com/bruce
Author: Richard Jones
Author-email: richard@mechanicalcat.net
License: UNKNOWN
Description: Bruce, the Presentation Tool is for people who are tired of
        fighting with presentation tools. Presentations are composed
        (edited) in plain text files. It allows text, code, image,
        interative Python sessions and video. It uses pyglet to render
        in OpenGL.
        
        Please REMOVE any previous installation of Bruce if you're upgrading
        from prior to version 3.0!
        
        Changes in this release:
        
        - add support for arbitrary display elements via ``.. plugin::``
        - fixed display of code blocks in absence of Pygments
        
        
        Bruce, the Presentation Tool Features
        =====================================
        
        - displays reStructuredText content with one page per section or transition
        - has a "bullet mode" which displays one page per *bullet point*
        - handles of *most* of reStructuredText, including:
        
        * inline markup for emphasis, strong and literal
        * literal and line blocks
        * tables (no row or column spanning yet)
        * block quotes
        * definition, bullet and enumerated lists (including nesting)
        * images - inline and stand-alone, including scaling
        * page titles (section headings)
        
        - page layout and decorations
        - scrolling of content larger than a screenful
        - sensible resource location (images, video, sound from the same directory
        as the presentation file)
        - some extensions to reStructuredText:
        
        * embedded Python interative interpreter sessions
        * code blocks with syntax highlighting (requires optional Pygments install)
        * videos (embedded just like images) with optional looping
        * stylesheet and layout changes on the fly (eg. multiple fonts
        per page)
        * transitions between pages
        * plugins to create your own inline elements
        
        - timer and page count display for practicing
        - control which screen to open on in multihead
        - run fullscreen at native resolution
        - may switch to/from fullscreen quickly
        
        
        Installation
        ============
        
        Bruce requires Python 2.5 or later to be installed on your system. Obtain
        it from <http://www.python.org/>.
        
        Please download the Bruce version for your operating system from
        <http://pypi.python.org/pypi/bruce>:
        
        - Linux "bruce-<version>-linux.zip" (eg. "bruce-3.1-linux.zip")
        - Windows "bruce-<version>-windows.zip" (eg. "bruce-3.1-windows.zip")
        - OS X "bruce-<version>-osx.zip" (eg. "bruce-3.1-osx.zip")
        
        Unzip the application and double-click the "bruce" program in the created
        folder. The program may be shown with a ".sh" or ".pyw" extension. Linux
        users may choose to run the program in a terminal.
        
        If the application does not work and you're on Linux you may need to
        install an optional python tkinter package. This is usually achieved
        by invoking something like::
        
        sudo apt-get install python-tk
        
        If you are a *system package maintainer* then please read the INSTALL.txt
        contained in the *source* distribution "bruce-<version>.tar.gz" or the
        Subversion repository at <http://bruce-tpt.googlecode.com/svn/trunk>
        
        
        How to use Bruce, the Presentation Tool
        =======================================
        
        On Windows you may just double-click the "run_bruce.py" file.
        
        On other platforms run::
        
        % bruce [presentation source.txt]
        
        If you've not installed Bruce then you may run from the source::
        
        % python run_bruce.py [presentation source.txt]
        
        There's a number of command-line controls - use ``bruce -h`` to
        learn what they do. With no command-line arguments Bruce will pop
        up a simple GUI.
        
        
        Controls
        ========
        
        When running a presentation the following controls are active:
        
        left, right arrows; left, right mouse button; space bar (forward)
        Move back and forward pages.
        page up, page down
        Move back and forward 5 pages.
        mouse scroll wheel
        Scroll large page content. You may also drag the contents up or down
        by dragging a left mouse button press up and down the screen. If a
        page has an embedded Python Interpreter you may use the scroll-wheel
        to scroll its contents (when the mouse is over the interpreter).
        Clicking and dragging always scrolls the whole page.
        control-F
        Switch between fullscreen and windowed mode
        escape
        Exit presentation
        home, end
        Go to the first or last page
        
        
        How to write presentations using Bruce, the Presentation Tool
        =============================================================
        
        Bruce presentations are written as plain-text files in the
        reStructuredText format with some extensions. See the examples
        folder \*.rst files for some samples, the simplest being
        "simple.rst" which displays plain text sentences centered
        on a white background (using the "big-centered" style)::
        
        .. load-style:: big-centered
        
        Text displayed centered on the default white background.
        
        ----
        
        A new page, separated from the previous using the four
        dashes.
        
        Ut enim ad minim veniam.
        
        A Page Title
        ------------
        
        Pages may optionally have titles which are displayed
        centered at the top by default.
        
        and so on. For more information see the HOWTO__ (also available
        online at the Bruce website) and the optional extra examples
        download from <http://pypi.python.org/pypi/bruce>.
        
        __ http://r1chardj0n3s.googlepages.com/howto
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Multimedia :: Graphics :: Presentation
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
