spod5 - Turn pod into S5
spod5 [--quiet] [--force] [--exec] [--base dir] [--slides style.css] [--multi] [--help] [--version] file.pod [ ... ]
spod5 is a pod-to-S5 tool, that uses Pod::POM::View::HTML::Filter to add syntax coloring to your slides.
Pod::POM::View::HTML::Filter
spod5 supports the following options:
Do not print information messages.
Clobber existing .html files.
Directory where the S5 CSS and JavaScript files are to be found. Default is ui/default.
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.
=meta slides
Use an alternative template to create an HTML file per slide. (This is still beta.)
Execute the commands in =exec directives.
=exec
Provide the list of available options and exit.
Print version information and exit.
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.
=head1
spod5 add several shortcuts and features:
=begin filter / =end filter sections allow support for syntax highlighting as done by Pod::POM::View::HTML::Filter.
=begin filter
=end filter
Several shortcuts are recognised:
convert into a bulleted list (can be nested):
+ * bam * powie * kapow -
support the incremental and incremental show-first classes, by using an explicit =over style:
incremental
incremental show-first
=over style
=over incremental * zlonk * ouch =back
+>> is an alias for =over incremental and +> for =over incremental show-first.
+>>
=over incremental
+>
=over incremental show-first
put the inner text in the handout only:
{{ ... }}
insert an image:
=img image.png
include another file:
=include file.txt
Note that the file is not parsed for special extensions like +, -, etc. If you want to include slide content, use plain pod.
+
-
insert the output of a command (dangerous):
=exec command
This is disabled by default: you must pass the --exec command-line parameter to enable execution of code.
for inserting more complex HTML, you can still use the classic =for html or =begin html / =end html constructs.
=for html
=begin html
=end html
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)
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/.
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.
bug-spod5@rt.cpan.org
Copyright 2005, Philippe Bruhat.
This script is free software; you can redistribute it or modify it under the same terms as Perl itself.
To install spod5, copy and paste the appropriate command in to your terminal.
cpanm
cpanm spod5
CPAN shell
perl -MCPAN -e shell install spod5
For more information on module installation, please visit the detailed CPAN module installation guide.