Next Previous Contents

4. Settings and Options for the Presentation

After starting PresTiMeL, all parameters will be initialized with hard-coded default-values. The next sections will describe three ways to override these default-values.

4.1 A configuration file

The default-values may be overridden with the values defined in the configuration file .prestimelrc located in your home directory, or in a configuration file specified with the commandline option -c.

# This is a comment

Empty lines and lines beginning with a # will be ignored.

path-to-themes = themepath

Set the path where PresTiMeL will search for themes.

theme = theme

Set the theme that should be used for the presentations.

disable-xml-settings = yes|no

If yes, the settings stored in the XML-file will be ignored. If this option is omitted or set to no, the settings in the XML-file are enabled. Note, that these XML-settings may override the settings of the configuration-file.

resolution = resolution

Sets the resolution. Possible values are 640x480, 800x600 and 1024x768.

sloppy-buttons = yes|no

If set to yes, the buttons will be placed below the content of the slide rather than at a fixed position. If this option is omitted or set to no, the buttons will be placed at a fixed position at the bottom of your browser-window.

top-navigation = yes|no

If set to yes, the navigation-buttons will be placed on the top of the slides. The default-value is no, which places the navigation-buttons at the bottom.

print-outline = yes|no

If set to yes, the LaTeX-output will use the documentclass "article" rather than "seminar".

4.2 A markup in the XML-file

The XML-file may define the markups <html> and <latex> after the <presentation> markup. These markups are used to define some settings related to the HTML- and LaTeX-output, which will will override the default-values and the values defined in the configuration file.

Properties of the <html> markup

resolution

The HTML-presentation can be optimized for a screen-resolution of "640x480", "800x600" or "1024x768".

theme

Use this property to pre-define a theme that should be used for the HTML-output.

sloppybuttons

Possible values for this property are "yes" and "no".

cellpadding

The padding of the cells in a grid-environment can be adjusted with this property.

top_navigation

Possible values for this property are "yes" and "no".

And the <latex> markup may take the following properties :

outline

Possible values for this property are "yes" and "no".

For example :


<presentation>

<html resolution="1024x768" theme="plasma" sloppybuttons="yes"/>

...

Properties of the <latex> markup

outline

...

4.3 Commandline options

The settings of PresTiMeL, which were initialized by the configuration- and the XML-file, may be overridden again, using the following commandline options :

-v, --version

Print the version of PresTiMeL and exit.

-h, --help

Display a short usage-message and a list of all commandline options.

-l[file.tex], --latex-output[=file.tex]

Create a LaTeX-file file.tex rather than HTML-slides.

-p DIR, --path-to-themes=DIR

Set the path, where PresTiMeL will look for themes.

-t[theme], --theme[=theme]

Set a theme, which will be used for the presentation. If the given theme doesn't exist or no theme is given, a list of all availaible themes in the current themepath will be printed. As the theme is an optional argument, no whitespace is allowed between the option and the theme.

-c FILE, --config-file=FILE

Use the specified configuration-file to initialize PresTiMeL's settings. If omitted, PresTiMeL will search for a config-file .prestimelrc located in your home-directory.

-x, --disable-xml-settings

Disable the settings stored in the XML-file of the presentation.

-R RES, --resolution=RES

Set the resolution, for which the HTML-presentation will be optimized. Currently, 800x600 and 1024x768 are allowed for RES. The default-value for RES is 800x600.

-B, --disable-background

Each HTML-slide will have a tiled background-graphic. If this option is given, this background-graphic will be disabled for all slides.

-H, --disable-header

The headline of each slide has an own background-graphic. If this option is given, this background-graphic will be disabled for all headlines.

-F, --disable-first-last

Each HTML-slide will have navigation-buttons to the first, the previous, the next and the last slide. If this option is given, the navigation-buttons to the first and last slide will be disabled.

-N, --disable-note-button

Each slide may have a note, which is just an own HTML page with some additional information to the slide. Each slide that has some notes defined will show a button to access them. If this option is given, these note-buttons will be disabled for all slides.

-S, --sloppy-buttons

Normally, the navigation-buttons will always be drawn at the bottom of the slide at a fixed position defined in the stylesheet. If this option is given, the buttons will be moved down, when the content of the slide is higher than the provided vertical space.

-T, --top-navigation

If this option is given, the navigation-buttons will be drawn at the top of the slides rather than at the bottom.

-O, --print-outline

This option is related to the LaTeX-output. If given, the LaTeX-output will use the documentclass "article" rather than "seminar".


Next Previous Contents