Scripts for preparing papers and slides

This directory contains scripts that I use to generate papers for publications, and "slides" for talks.

You can download all the scripts as paper-utils.tgz.

Creating slides for presentations

The make-slides script (a Bourne shell script) reads an XML file containing a <slide> element for each "page" of a presentation, containing arbitrary HTML markup within each <slide>. The make-slides creates a set of cross-referenced HTML pages that are convenient to navigate during a presentation. It generates both a single large index.html that contains all the slides, as well as individual web pages, one for each slide. The latter is preferable for presentations; the former is more convenient for online reading.

Format of the input XML file

A slides files contains a top-level <slides> element, which contains a <title> element, followed by one or more <slide> elements. Each <slide> has a id attribute, which is a unique name for the slide. (It is used to generate web pages when generating a single web page per slide, and for cross-references when generating a single web page.) Each <slide> should start with a <caption> element which is use as the title/heading of that slide. Following is one or more block-level HTML elements, such as <p> or <ul>.

Running the make-slides script

To create the resulting web pages, invoke make-slides with two arguments:

Using the generated HTML pages

The generated index.html page contains the text of all the <slide> elements. If you click on the right end of the pale yellow slide header, the view will scroll to the next slide, and if you click on the left end it will scroll back to the previous page. If you click the main part of the slide header it will go to the single page-per-slide version of that slide.

For presentations, the single-page-per-slide pages are probably most suitable. If you click on the right end of the pale yellow slide header, you will get the next slide, and if you click on the left end you will get back to the previous page.

Typing n goes to the next slide, while p goes to the previous slide. Typing i goes to the single index.html page.

Converting a Docbook paper to LaTeX


Per Bothner
Last modified: Wed Jul 9 21:48:00 PDT 2003