NAME Pod::S5 - Generate S5 slideshow from POD source file. SYNOPSIS pod2s5 [-hv] [options] inputfile.pod --theme the theme to use, default is 'default'. Available themes: default, flower, i18n, pixel, yatil. --dest target directory where to install the slideshow. If not specified the target directory name will be generated from the B parameter or from the filename of the source pod file. --author the name of the slideshow author. --creation when the slideshow were generated (default: current date). --company company or organisation (default: none). --where where the slideshow were made (default: hostname). --name the name of the slideshow (title). -v --version print the current version of the program. -h --help print usage information. DESCRIPTION pod2s5 converts POD input to a S5 HTML slideshow. No additional software is required. Just write a POD file, run pod2s5 on it - and you're done. POD Beside the known perlpod markup some additions have been made: Since we are generating a slideshow, the POD must be devided into pieces which can be used as slides. Slides will be separated by the =head1 title tag (which itself becomes the title of the slide. =head1 Intro --+ | [..] +------- Slide 1 [..] | ----+ =head1 Intro --+ | [..] +------- Slide 2 [..] | ----+ =head1 End --+ | [..] +------- Slide 3 [..] | ----+ Each slide may contain any valid POD. * Images can be included using the tag G. You must manually copy images to the target directory. * Plain HTML code can be included using the html formatter, eg: =begin html Blah =end html * You can create incremental slides using bullet lists, that is each list item will appear separately, as if it were on an extra slide. Example: =over =item * 1st item =item * 2nd item =back * You can add special formatters for code, which will be syntax highlighted if the module Syntax::Highlight::Engine::Kate is installed. Use the name of the programming language as the formatter name. Example: =begin perl if ($var) { exit; } =end perl To get a list of the available languages, refer to the Syntax::Highlight::Engine::Kate manpage. DEPENDENCIES unzip(1) Syntax::Highlight::Engine::Kate is optional. S5 is already included in the script and will automatically installed if you generate a new slide. LICENSE AND COPYRIGHT Copyright (c) 2007 Thomas Linden This tool is free software; you can redistribute it and/or modify it under the same terms as Perl itself. BUGS AND LIMITATIONS See rt.cpan.org for current bugs, if any. INCOMPATIBILITIES None known. DIAGNOSTICS To debug pod2s5 use debug() or the perl debugger, see perldebug. AUTHOR Thomas Linden VERSION 0.01