Slides Parameter Reference

Norman Walsh

$Id: param.xweb,v 1.6 2004/03/04 14:49:51 kosek Exp $


Table of Contents

Introduction
I. General Parameters
keyboard.nav - Enable keyboard navigation?
css.stylesheet - CSS stylesheet for slides
css.stylesheet.dir - Default directory for CSS stylesheets
titlefoil.html - Name of title foil HTML file
toc.html - Name of ToC HTML file
foilgroup.toc - Put ToC on foilgroup pages?
output.indent - Indent output?
overlay - Overlay footer navigation?
show.foil.number - Show foil number on each foil?
II. Frame Parameters
nav.separator - Output separator between navigation and body?
toc.row.height - Height of ToC rows in dynamic ToCs
toc.bg.color - Background color for ToC frame
body.bg.color - Background color for body frame
toc.width - Width of ToC frame
toc.hide.show - Enable hide/show button for ToC frame
dynamic.toc - Dynamic ToCs?
active.toc - Active ToCs?
overlay.logo - Logo to overlay on ToC frame
multiframe - Use multiple frames for slide bodies?
multiframe.top.bgcolor - Background color for top navigation frame
multiframe.bottom.bgcolor - Background color for bottom navigation frame
multiframe.navigation.height - Height of navigation frames
III. Graphics Parameters
graphics.dir - Graphics directory
bullet.image - Bullet image
next.image - Right-arrow image
prev.image - Left-arrow image
up.image - Up-arrow image
home.image - Home image
toc.image - ToC image
no.next.image - Inactive right-arrow image
no.prev.image - Inactive left-arrow image
no.up.image - Inactive up-arrow image
no.home.image - Inactive home image
no.toc.image - Inactive ToC image
plus.image - Plus image
minus.image - Minus image
hidetoc.image - Hide ToC image
showtoc.image - Show ToC image
IV. JavaScript Parameters
script.dir - Script directory
ua.js - UA JavaScript file
xbDOM.js - xbDOM JavaScript file
xbStyle.js - xbStyle JavaScript file
xbLibrary.js - xbLibrary JavaScript file
xbCollapsibleLists.js - xbCollapsibleLists JavaScript file
overlay.js - Overlay JavaScript file
slides.js - Slides overlay file
V. Localization Parameters
text.home - Home
text.toc - FIXME:
text.prev - FIXME:
text.up - FIXME:
text.next - FIXME:
A. The Stylesheet

Introduction

This is reference documentation for the Slides stylesheet parameters.

This reference describes each of the parameters. These are the “easily customizable” parts of the stylesheet. If you want to specify an alternate value for one or more of these parameters, you can do so in a “driver” stylesheet.

For example, if you want to change the keyboard.nav parameter to 0, you might create a driver stylesheet like this:

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                version='1.0'>

  <xsl:import href="http://docbook.sourceforge.net/release/slides/current/xsl/slides.xsl"/>

  <xsl:param name="keyboard.nav" select="0"/>

</xsl:stylesheet>

Naturally, you have to change the href attribute on <xsl:import> to point to the stylesheet on your system.

This is not intended to be “user” documentation. It is provided for developers writing customization layers for the stylesheets, and for anyone who's interested in “how it works”.

Although I am trying to be thorough, this documentation is known to be incomplete. Don't forget to read the source, too :-)

General Parameters


Table of Contents

keyboard.nav - Enable keyboard navigation?
css.stylesheet - CSS stylesheet for slides
css.stylesheet.dir - Default directory for CSS stylesheets
titlefoil.html - Name of title foil HTML file
toc.html - Name of ToC HTML file
foilgroup.toc - Put ToC on foilgroup pages?
output.indent - Indent output?
overlay - Overlay footer navigation?
show.foil.number - Show foil number on each foil?

Name

keyboard.nav — Enable keyboard navigation?

Synopsis

<xsl:param name="keyboard.nav" select="1"></xsl:param>

Description

If non-zero, JavaScript is added to the slides to enable keyboard navigation. Pressing 'n', space, or return moves forward; pressing 'p' moves backward.


Name

css.stylesheet — CSS stylesheet for slides

Synopsis

<xsl:param name="css.stylesheet" select="'slides.css'"></xsl:param>

Description

Identifies the CSS stylesheet used by all the slides. This parameter can be set in the source document with the <?dbhtml?> pseudo-attribute css-stylesheet.


Name

css.stylesheet.dir — Default directory for CSS stylesheets

Synopsis

<xsl:param name="css.stylesheet.dir" select="''"></xsl:param>

Description

Identifies the default directory for the CSS stylesheet generated on all the slides. This parameter can be set in the source document with the <?dbhtml?> pseudo-attribute css-stylesheet-dir.

If non-empty, this value is prepended to each of the stylesheets.


Name

titlefoil.html — Name of title foil HTML file

Synopsis

<xsl:param name="titlefoil.html" select="concat('index', $html.ext)"></xsl:param>

Description

Sets the filename used for the slides titlepage.


Name

toc.html — Name of ToC HTML file

Synopsis

<xsl:param name="toc.html" select="concat('toc', $html.ext)"></xsl:param>

Description

Sets the filename used for the table of contents page.


Name

foilgroup.toc — Put ToC on foilgroup pages?

Synopsis

<xsl:param name="foilgroup.toc" select="1"></xsl:param>

Description

If non-zero, a ToC will be placed on foilgroup pages (after any other content).


Name

output.indent — Indent output?

Synopsis

<xsl:param name="output.indent" select="'no'"></xsl:param>

Description

Specifies the setting of the indent parameter on the HTML slides. For more information, see the discussion of the xsl:output element in the XSLT specification.


Name

overlay — Overlay footer navigation?

Synopsis

<xsl:param name="overlay" select="0"></xsl:param>

Description

If non-zero, JavaScript is added to the slides to make the bottom navigation appear at the bottom of each page. This option and multiframe are mutually exclusive.

If this parameter is zero, the bottom navigation simply appears below the content of each slide.


Name

show.foil.number — Show foil number on each foil?

Synopsis

<xsl:param name="show.foil.number" select="0"></xsl:param>

Description

If non-zero, on each slide there will be its number. Currently not supported in all output formats.

Frame Parameters


Table of Contents

nav.separator - Output separator between navigation and body?
toc.row.height - Height of ToC rows in dynamic ToCs
toc.bg.color - Background color for ToC frame
body.bg.color - Background color for body frame
toc.width - Width of ToC frame
toc.hide.show - Enable hide/show button for ToC frame
dynamic.toc - Dynamic ToCs?
active.toc - Active ToCs?
overlay.logo - Logo to overlay on ToC frame
multiframe - Use multiple frames for slide bodies?
multiframe.top.bgcolor - Background color for top navigation frame
multiframe.bottom.bgcolor - Background color for bottom navigation frame
multiframe.navigation.height - Height of navigation frames

Name

nav.separator — Output separator between navigation and body?

Synopsis

<xsl:param name="nav.separator" select="1"></xsl:param>

Description

If non-zero, a separator (<HR>) is added between the navigation links and the content of each slide.


Name

toc.row.height — Height of ToC rows in dynamic ToCs

Synopsis

<xsl:param name="toc.row.height" select="22"></xsl:param>

Description

This parameter specifies the height of each row in the table of contents. This is only applicable if a dynamic ToC is used. You may want to adjust this parameter for optimal appearance with the font and image sizes selected by your CSS stylesheet.


Name

toc.bg.color — Background color for ToC frame

Synopsis

<xsl:param name="toc.bg.color" select="'#FFFFFF'"></xsl:param>

Description

Specifies the background color used in the ToC frame.


Name

body.bg.color — Background color for body frame

Synopsis

<xsl:param name="body.bg.color" select="'#FFFFFF'"></xsl:param>

Description

Specifies the background color used in the body column of tabular slides.


Name

toc.width — Width of ToC frame

Synopsis

<xsl:param name="toc.width" select="250"></xsl:param>

Description

Specifies the width of the ToC frame.


Name

toc.hide.show — Enable hide/show button for ToC frame

Synopsis

<xsl:param name="toc.hide.show" select="0"></xsl:param>

Description

If non-zero, JavaScript (and an additional icon, see hidetoc.image and showtoc.image) is added to each slide to allow the ToC panel to be “toggled” on each panel.

Note

There is a bug in Mozilla 1.0 (at least as of CR3) that causes the browser to reload the titlepage when this feature is used.


Name

dynamic.toc — Dynamic ToCs?

Synopsis

<xsl:param name="dynamic.toc" select="0"></xsl:param>

Description

If non-zero, JavaScript is used to make the ToC panel “dynamic”. In a dynamic ToC, each section in the ToC can be expanded and collapsed by clicking on the appropriate image.


Name

active.toc — Active ToCs?

Synopsis

<xsl:param name="active.toc" select="0"></xsl:param>

Description

If non-zero, JavaScript is used to keep the ToC and the current slide “in sync”. That is, each time the slide changes, the corresponding ToC entry will be underlined.


Name

overlay.logo — Logo to overlay on ToC frame

Synopsis

<xsl:param name="overlay.logo" select="'http://docbook.sourceforge.net/release/buttons/slides-1.png'"></xsl:param>

Description

If this URI is non-empty, JavaScript is used to overlay the specified image on the ToC frame.


Name

multiframe — Use multiple frames for slide bodies?

Synopsis

<xsl:param name="multiframe" select="0"></xsl:param>

Description

If non-zero, multiple frames are used for the body of each slide. This is one way of forcing the slide navigation elements to appear in constant locations. The other way is with overlays. The overlay and multiframe parameters are mutually exclusive.


Name

multiframe.top.bgcolor — Background color for top navigation frame

Synopsis

<xsl:param name="multiframe.top.bgcolor" select="'white'"></xsl:param>

Description

Specifies the background color of the top navigation frame when multiframe is enabled.


Name

multiframe.bottom.bgcolor — Background color for bottom navigation frame

Synopsis

<xsl:param name="multiframe.bottom.bgcolor" select="'white'"></xsl:param>

Description

Specifies the background color of the bottom navigation frame when multiframe is enabled.


Name

multiframe.navigation.height — Height of navigation frames

Synopsis

<xsl:param name="multiframe.navigation.height" select="40"></xsl:param>

Description

Specifies the height of the navigation frames when multiframe is enabled.

Graphics Parameters


Table of Contents

graphics.dir - Graphics directory
bullet.image - Bullet image
next.image - Right-arrow image
prev.image - Left-arrow image
up.image - Up-arrow image
home.image - Home image
toc.image - ToC image
no.next.image - Inactive right-arrow image
no.prev.image - Inactive left-arrow image
no.up.image - Inactive up-arrow image
no.home.image - Inactive home image
no.toc.image - Inactive ToC image
plus.image - Plus image
minus.image - Minus image
hidetoc.image - Hide ToC image
showtoc.image - Show ToC image

Name

graphics.dir — Graphics directory

Synopsis

<xsl:param name="graphics.dir" select="''"></xsl:param>

Description

Identifies the graphics directory for the navigation components generated on all the slides. This parameter can be set in the source document with the <?dbhtml?> pseudo-attribute graphics-dir.

If non-empty, this value is prepended to each of the graphic image paths.


Name

bullet.image — Bullet image

Synopsis

<xsl:param name="bullet.image" select="'toc/bullet.png'"></xsl:param>

Description

Specifies the filename of the bullet image used for foils in the framed ToC.


Name

next.image — Right-arrow image

Synopsis

<xsl:param name="next.image" select="'active/nav-next.png'"></xsl:param>

Description

Specifies the filename of the right-pointing navigation arrow.


Name

prev.image — Left-arrow image

Synopsis

<xsl:param name="prev.image" select="'active/nav-prev.png'"></xsl:param>

Description

Specifies the filename of the left-pointing navigation arrow.


Name

up.image — Up-arrow image

Synopsis

<xsl:param name="up.image" select="'active/nav-up.png'"></xsl:param>

Description

Specifies the filename of the upward-pointing navigation arrow.


Name

home.image — Home image

Synopsis

<xsl:param name="home.image" select="'active/nav-home.png'"></xsl:param>

Description

Specifies the filename of the home navigation icon.


Name

toc.image — ToC image

Synopsis

<xsl:param name="toc.image" select="'active/nav-toc.png'"></xsl:param>

Description

Specifies the filename of the ToC navigation icon.


Name

no.next.image — Inactive right-arrow image

Synopsis

<xsl:param name="no.next.image" select="'inactive/nav-next.png'"></xsl:param>

Description

Specifies the filename of the inactive right-pointing navigation arrow.


Name

no.prev.image — Inactive left-arrow image

Synopsis

<xsl:param name="no.prev.image" select="'inactive/nav-prev.png'"></xsl:param>

Description

Specifies the filename of the inactive left-pointing navigation arrow.


Name

no.up.image — Inactive up-arrow image

Synopsis

<xsl:param name="no.up.image" select="'inactive/nav-up.png'"></xsl:param>

Description

Specifies the filename of the inactive upward-pointing navigation arrow.


Name

no.home.image — Inactive home image

Synopsis

<xsl:param name="no.home.image" select="'inactive/nav-home.png'"></xsl:param>

Description

Specifies the filename of the inactive home navigation icon.


Name

no.toc.image — Inactive ToC image

Synopsis

<xsl:param name="no.toc.image" select="'inactive/nav-toc.png'"></xsl:param>

Description

Specifies the filename of the inactive ToC navigation icon.


Name

plus.image — Plus image

Synopsis

<xsl:param name="plus.image" select="'toc/closed.png'"></xsl:param>

Description

Specifies the filename of the “plus” image; the image used in a dynamic ToC to indicate that a section can be expanded.


Name

minus.image — Minus image

Synopsis

<xsl:param name="minus.image" select="'toc/open.png'"></xsl:param>

Description

Specifies the filename of the “minus” image; the image used in a dynamic ToC to indicate that a section can be collapsed.


Name

hidetoc.image — Hide ToC image

Synopsis

<xsl:param name="hidetoc.image" select="'hidetoc.gif'"></xsl:param>

Description

Specifies the filename of the “hide ToC” image. This is used when the ToC hide/show parameter is enabled.


Name

showtoc.image — Show ToC image

Synopsis

<xsl:param name="showtoc.image" select="'showtoc.gif'"></xsl:param>

Description

Specifies the filename of the “show ToC” image. This is used when the ToC hide/show parameter is enabled.

JavaScript Parameters


Table of Contents

script.dir - Script directory
ua.js - UA JavaScript file
xbDOM.js - xbDOM JavaScript file
xbStyle.js - xbStyle JavaScript file
xbLibrary.js - xbLibrary JavaScript file
xbCollapsibleLists.js - xbCollapsibleLists JavaScript file
overlay.js - Overlay JavaScript file
slides.js - Slides overlay file

Name

script.dir — Script directory

Synopsis

<xsl:param name="script.dir" select="''"></xsl:param>

Description

Identifies the JavaScript source directory for the slides. This parameter can be set in the source document with the <?dbhtml?> pseudo-attribute script-dir.

If non-empty, this value is prepended to each of the JavaScript files.


Name

ua.js — UA JavaScript file

Synopsis

<xsl:param name="ua.js" select="'ua.js'"></xsl:param>

Description

Specifies the filename of the UA JavaScript file. It's unlikely that you will ever need to change this parameter.


Name

xbDOM.js — xbDOM JavaScript file

Synopsis

<xsl:param name="xbDOM.js" select="'xbDOM.js'"></xsl:param>

Description

Specifies the filename of the xbDOM JavaScript file. It's unlikely that you will ever need to change this parameter.


Name

xbStyle.js — xbStyle JavaScript file

Synopsis

<xsl:param name="xbStyle.js" select="'xbStyle.js'"></xsl:param>

Description

Specifies the filename of the xbStyle JavaScript file. It's unlikely that you will ever need to change this parameter.


Name

xbLibrary.js — xbLibrary JavaScript file

Synopsis

<xsl:param name="xbLibrary.js" select="'xbLibrary.js'"></xsl:param>

Description

Specifies the filename of the xbLibrary JavaScript file. It's unlikely that you will ever need to change this parameter.


Name

xbCollapsibleLists.js — xbCollapsibleLists JavaScript file

Synopsis

<xsl:param name="xbCollapsibleLists.js" select="'xbCollapsibleLists.js'"></xsl:param>

Description

Specifies the filename of the xbCollapsibleLists JavaScript file. It's unlikely that you will ever need to change this parameter.


Name

overlay.js — Overlay JavaScript file

Synopsis

<xsl:param name="overlay.js" select="'overlay.js'"></xsl:param>

Description

Specifies the filename of the overlay JavaScript file. It's unlikely that you will ever need to change this parameter.


Name

slides.js — Slides overlay file

Synopsis

<xsl:param name="slides.js" select="'slides.js'"></xsl:param>

Description

Specifies the filename of the slides JavaScript file. It's unlikely that you will ever need to change this parameter.

Localization Parameters


Table of Contents

text.home - Home
text.toc - FIXME:
text.prev - FIXME:
text.up - FIXME:
text.next - FIXME:

Name

text.home — Home

Synopsis

<xsl:param name="text.home" select="'Home'"></xsl:param>

Description

FIXME:


Name

text.toc — FIXME:

Synopsis

<xsl:param name="text.toc" select="'ToC'"></xsl:param>

Description

FIXME:


Name

text.prev — FIXME:

Synopsis

<xsl:param name="text.prev" select="'Prev'"></xsl:param>

Description

FIXME:


Name

text.up — FIXME:

Synopsis

<xsl:param name="text.up" select="'Up'"></xsl:param>

Description

FIXME:


Name

text.next — FIXME:

Synopsis

<xsl:param name="text.next" select="'Next'"></xsl:param>

Description

FIXME:

Appendix A. The Stylesheet

The param.xsl stylesheet is just a wrapper around all these parameters.


<!-- This file is generated from param.xweb; do not edit this file! -->

<xsl:stylesheet exclude-result-prefixes="src" version="1.0">

<!-- ********************************************************************
     $Id: param.xweb,v 1.6 2004/03/04 14:49:51 kosek Exp $
     ********************************************************************

     This file is part of the DocBook Slides Stylesheet distribution.
     See ../README or http://nwalsh.com/docbook/xsl/ for copyright
     and other information.

     ******************************************************************** -->

<src:fragref linkend="active.toc.frag"></src:fragref>
<src:fragref linkend="body.bg.color.frag"></src:fragref>
<src:fragref linkend="bullet.image.frag"></src:fragref>
<src:fragref linkend="css.stylesheet.frag"></src:fragref>
<src:fragref linkend="css.stylesheet.dir.frag"></src:fragref>
<src:fragref linkend="dynamic.toc.frag"></src:fragref>
<src:fragref linkend="foilgroup.toc.frag"></src:fragref>
<src:fragref linkend="graphics.dir.frag"></src:fragref>
<src:fragref linkend="hidetoc.image.frag"></src:fragref>
<src:fragref linkend="home.image.frag"></src:fragref>
<src:fragref linkend="keyboard.nav.frag"></src:fragref>
<src:fragref linkend="minus.image.frag"></src:fragref>
<src:fragref linkend="multiframe.bottom.bgcolor.frag"></src:fragref>
<src:fragref linkend="multiframe.frag"></src:fragref>
<src:fragref linkend="multiframe.navigation.height.frag"></src:fragref>
<src:fragref linkend="multiframe.top.bgcolor.frag"></src:fragref>
<src:fragref linkend="nav.separator.frag"></src:fragref>
<src:fragref linkend="next.image.frag"></src:fragref>
<src:fragref linkend="no.home.image.frag"></src:fragref>
<src:fragref linkend="no.next.image.frag"></src:fragref>
<src:fragref linkend="no.prev.image.frag"></src:fragref>
<src:fragref linkend="no.toc.image.frag"></src:fragref>
<src:fragref linkend="no.up.image.frag"></src:fragref>
<src:fragref linkend="output.indent.frag"></src:fragref>
<src:fragref linkend="overlay.frag"></src:fragref>
<src:fragref linkend="overlay.js.frag"></src:fragref>
<src:fragref linkend="overlay.logo.frag"></src:fragref>
<src:fragref linkend="plus.image.frag"></src:fragref>
<src:fragref linkend="prev.image.frag"></src:fragref>
<src:fragref linkend="script.dir.frag"></src:fragref>
<src:fragref linkend="show.foil.number.frag"></src:fragref>
<src:fragref linkend="showtoc.image.frag"></src:fragref>
<src:fragref linkend="slides.js.frag"></src:fragref>
<src:fragref linkend="text.home.frag"></src:fragref>
<src:fragref linkend="text.next.frag"></src:fragref>
<src:fragref linkend="text.prev.frag"></src:fragref>
<src:fragref linkend="text.toc.frag"></src:fragref>
<src:fragref linkend="text.up.frag"></src:fragref>
<src:fragref linkend="titlefoil.html.frag"></src:fragref>
<src:fragref linkend="toc.bg.color.frag"></src:fragref>
<src:fragref linkend="toc.hide.show.frag"></src:fragref>
<src:fragref linkend="toc.html.frag"></src:fragref>
<src:fragref linkend="toc.image.frag"></src:fragref>
<src:fragref linkend="toc.row.height.frag"></src:fragref>
<src:fragref linkend="toc.width.frag"></src:fragref>
<src:fragref linkend="ua.js.frag"></src:fragref>
<src:fragref linkend="up.image.frag"></src:fragref>
<src:fragref linkend="xbCollapsibleLists.js.frag"></src:fragref>
<src:fragref linkend="xbDOM.js.frag"></src:fragref>
<src:fragref linkend="xbStyle.js.frag"></src:fragref>
<src:fragref linkend="xbLibrary.js.frag"></src:fragref>

</xsl:stylesheet>