Unit test: presentation.001

Norm Tovey-Walsh


Presentation mode implements paged navigation through a document. As the name implies, it’s designed for use in presentations:

  • It uses generally larger fonts by default and works best for many small pages

  • Each unit of a document (part, chapter, article, section, etc.) becomes a page.

  • Presentation mode replaces earlier “slides” and “speaker notes” implementations.

  • Use keyboard shortcuts or click the icons in the lower-right corner to navigate (Press F1 for navigation help).


When served with https (or from localhost with http), presentation mode can use local storage to synchronize display in different browser windows.

  • Add

      |<meta xmlns="http://www.w3.org/1999/xhtml"
      |      name="localStorage.key" content="keyName"/>
    to the info of your document.

  • The key name is irrelevant, but is used to coordinate between windows. All documents with the same key name will be synchronized together. 1

  • Synchronized displays are useful for reading speaker notes in one view while presenting the “normal” view to your audience.

Speaker notes

  • Speaker notes can be placed on any page.

  • They are not displayed as part of the normal presentation.

  • They can be revealed by selecting notes view.

Use the speaker-notes role to add speaker notes:

  |<para role="speaker-notes">When you present this page
  |observe that the speaker notes are normally hidden, but
  |can be revealed by pressing <keycap>S</keycap>.</para>

When you present this page observe that the speaker notes are normally hidden, but can be revealed by pressing S.

(If you’re reading this in presentation mode, press S to select notes view.)

Press S again to return to the normal view.

Part IProgressive reveal

Reveal elements

Any elements marked with the role reveal will be hidden initially. Navigating forward or pressing Space will reveal them.

This paragraph is revealed!

List reveals

If a list is marked with reveal, the behavior applies to all of the items except the first.

  1. This is the first item in the list, it’s always shown.

  2. This is the second item.

  3. This is the third and last item.

Transitory reveals

If an item is marked both reveal and transitory, it will be revealed in turn and then concealed again when the next item is revealed:

  1. This is the first item in the list, it’s always shown.

  2. This is the second item. It is marked transitory, so it will be replaced.

  3. This is a replacement second item.

  4. This is the third and last item.


You can override the reveal behavior with noreveal. For example:

  • This is the first item in the list, it’s always shown.

  • This is the second item. In a “reveal” list, it would usually be hidden at first, but this one is marked “noreveal”.

  • This is the third item.

  • This is the fourth and last item.


  • Quick and easy presentations from DocBook documents.

  • No special markup required.

  • Easy navigation.

  • Clean look and feel.

  • Advanced features:

    • Synchronized display

    • Speaker notes

    • Progressive and transitory reveals