This document provides the details of the S5 markup structure. This will first present the minimum required structure, and then discuss optional bits of markup. Note that S5 1.0 is intentionally compatible with OSF 1.0, which will be referred to at times in this document.
What follows is an example of the absolute minimum markup required to be considered a valid S5 file. The italicized text indicates technically optional but strongly recommended content.
The first lines of an S5 presentation file must contain an XHTML 1.0 Strict DOCTYPE declaration and a properly namespaced
Because of the compatibility problems present in IE6/Win, the XML prolog should not be placed at the top of the document.
In addition to the title of the slide show, the
head element must contain a
meta element that describes the file format. This is OSF 1.0 compatible.
head element also must contain the
link elements and
At the very beginning of the
body is the "layout"
div. This is the same structure found in OSF 1.0, and can accept the same elements. S5 adds the markup shown above, which must be included in the document. The "controls"
div is where the slide show navigation controls appear, and "currentSlide" is the spot where the "slide X of Y" information appears. The "header" and "footer"
divs must be included as well. Authors are free to add markup and content to the "header" and "footer"
divs, but not to remove them entirely.
As in OSF 1.0, all of the slides are contained within a "presentation"
div. It begins immediately after the close of the "layout"
div and contains one or more slides.
Every slide in the presentation file must be enclosed in a
div with a
class containing the word
slide in its value. While a slide
div can be given an
id attributes on slide
divs are discouraged.
The title of a slide should be contained by an
h1 element, as in OSF 1.0. In S5, authors are strongly encouraged to have a slide title element, even if its content is empty. This will help keep the navigation menu working as expected. The markup of content for each slide is up to the individual author. Blank slides are certainly permitted, although would seem to be sort of useless.