Philippe Bruhat (BooK) > spod5 > spod5

Download:
spod5-0.02.tar.gz

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source  

NAME ^

spod5 - Turn pod into S5

SYNOPSIS ^

spod5 [--quiet] [--force] [--exec] [--base dir] [--slides style.css] [--multi] [--help] [--version] file.pod [ ... ]

DESCRIPTION ^

spod5 is a pod-to-S5 tool, that uses Pod::POM::View::HTML::Filter to add syntax coloring to your slides.

Command-line options

spod5 supports the following options:

--quiet

Do not print information messages.

--force

Clobber existing .html files.

--base dir

Directory where the S5 CSS and JavaScript files are to be found. Default is ui/default.

--slides file

Provide a replacement for the standard slides.css file found in ui/default. This allows one to define their own styles. See also the =meta slides directive in the source file.

--multi

Use an alternative template to create an HTML file per slide. (This is still beta.)

--exec

Execute the commands in =exec directives.

--help

Provide the list of available options and exit.

--version

Print version information and exit.

WRITING A SPOD5 DOCUMENT ^

Writing a presentation with spod5 is rather easy: all the =head1 headers mark the beginning of a new slide. The rest of the pod mark-up is converted as usual.

spod5 add several shortcuts and features:

Meta

You can add several meta information to your pod:

    title        (presentation title)
    presdate     (presentation date)
    author
    company
    slides       (alternate slides.css file, to easily change styles)
    view         (slideshow or outline)
    controls     (hidden or visible)

S5 Version

This version of spod5 is meant to be used with S5 1.1, which can be downloaded here: http://www.meyerweb.com/eric/tools/s5/v/1.1/s5-11.zip

The main template is based on the blank.html file provided with S5 1.1.

For all things S5, see http://www.meyerweb.com/eric/tools/s5/.

BUGS ^

Well, this script is just a quick hack for YAPC::Europe 2005. However, if you find bugs or have feature requests, send them to bug-spod5@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT ^

Copyright 2005, Philippe Bruhat.

LICENSE ^

This script is free software; you can redistribute it or modify it under the same terms as Perl itself.

syntax highlighting: