article2s5-starter

Aaron Straup Cope

This work is licensed under the Creative Commons Attribution-ShareAlike License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/1.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

Revision History
Revision 1.02004-11-22

Initial release.

Abstract

article2s5-starter is an XSLT stylesheet for converting a DocBook article into a draft-quality Simple Standards-Based Slide Show System (S5) XHTML presentation.

This is a tool for automating some tedious work required to create a presentation. Its functionality is, while useful, limited. Presentations are created as follows :

  • A title slide, containing author and date information.

  • An introductory slide, containing the article's abstract.

  • One slide for every section block in the article, including nested sections. Each slide will contain the section's title and, if defined, its abstract.

  • A final slide containing copyright information.

Because an essay and a presentation are sufficiently different the stylesheet does not try to divine anymore than some basic structure. It is expected that an author will continue to make edits to the presentation in a manner that will best convey their message.

It is also not a replacement for the more robust DocBook XSLT stylesheets meaning anything but the most basic markup is ignored.


Table of Contents

-

Usage

Example 1. 

 $> xsltproc --stringparam s5data '/my/css/s5' \
             -o example.html \
             article2s5-starter.xsl \
             example.xml

Consult the documentation for your favourite XSLT processor.

Options

article2s5-starter accepts the following parameters:

  • s5data. The URI for the S5 CSS and JavaScript files. Default is “ui”.

Requirements

Nothing special.

CSS

The S5 slide presentation tool defines a number of CSS styles that may be used to alter the layout of your presentation. The article2s5-starter tool also assigns the following classes :

  • dbk-affiliation. This class is assigned to a block level element containing information about an author's, affiliations.

  • dbk-author. This class is assigned to a block level element containing an author's name and their affiliations.

  • dbk-authorgroup. This class is assigned to a block level element (an unorderlist) containing a list of authors and editors.

  • dbk-copyright. This class is assigned to a block level element containing copyright information.

  • dbk-editor. This class is assigned to a block level element containing an editor's name and their affiliations.

  • dbk-fptitle. This class is assigned to an inline element containing the title of a DocBook <formalpara> block.

  • dbk-legalnotice. This class is assigned to a block level element containing copyright licensing information or other legal notices.

Appendix