SlideShow |
SlideShow is a Perl script for creating HTML slides from plain text.
SlideShow is implemented as a perl script and uses only core modules. This makes it easy to install or modify.
The input can be a single file, or it can include external components from external files by using '#include' statements. The appearance of the slides is defined by an HTML template. This makes it easy to edit the template with an HTML editor or by hand.
The output is a single HTML file containing all of the slides, or optionally multiple files containing one slide each.
Navigation to the next or previous slide is done with left and right mouse clicks anywhere on the slide. It is not necessary to clutter the slide with 'next' and 'previous' links.
To install unpack the tarball with the command 'gzip -dc slideshow-x.xx.tar.gz | tar xf -'
See one of the slideshow/example* directories for examples of how to create slides.
makeslides.pl input_file [output_file] Read slide definitions from input_file and write slides to output_file or standard output
Options:
-v Verbose output
-i file Include 'file'. The specified file is prepended to input_file.
Multiple -i options are allows.
-D name Define 'name'. This is used for conditional builds.
Multiple -D options are allows.
-dir directory Create one html file per slide in specified directory.
-f Force overwriting even if the output directory already exists
|
JavaScript is used to process shortcut keys and clicks to navigate between slides. The following shortcuts are used:
| Enter | Next slide |
| p | Previous slide |
| 1 | First slide |
| i | Go to the table of contents |
| f | Display slides is a full screen window |
| q | Close browser window |
| Click-anywhere | Next slide |
| Right-click | Previous slide |
TBD
TBD
#include filename |
#ifdef FOO Stuff here will only used if FOO is defined #endif #ifndef BAR Stuff here will only used if BAR is not defined #endif |
#begin slide_template <HTML CODE HERE> #end slide_template or #begin slide_template #include html_temlate_filename #end slide_template |
#begin toc_template <HTML CODE HERE> #end toc_template or #begin toc_template #include html_temlate_filename #end toc_template |
The following code will set the specified variable to the specified value
#set $macro_name = value |
The '$' character in the macro name is arbitrary and is not required. A macro can be used to change any arbitrary text on the slide. For example to change the color ""#400080" to "#ff0000" use the following:
#set "#400080"="#ff0000" |
Comment
Comments start with a ' ;' character in column 1
; this is a comment |
A new title with the same value as the preceding title will create a 'continued' slide. Using a row of '====='s is an alternative way to create a continued slide. The second slide will have all the content on the first slide, plus some extra. The first slide will have 'continued...' in small letters at the bottom. The second slide will not appear in the table of contents.
The title also sets the $slide_title macro. The macro value can be
overridden with a line of the form:
#slide_title This is the Real Slide Title
This changes the title without displaying a heading. It's useful is
useful for when you want different text in the TOC than you want on screen.
A title can be specified in several ways:
1) Text starting in column 1.
2) Text starting in column 1 and underlined with a row of '*'s
3) Text starting in column 16. This will produce a centered heading.
4) Text starting in column 16 and underlined with a row of '*'s.
This will produce a centered heading.
This is a Title <blank_line> This is also a title ******************** This is a centered title <blank_line> This is a centered title
************************
|
The first subtitle underlined with ++++ that appears on a slide is special. Using the text:
Advanced Topics *************** Extending Your Class::DBI Classes +++++++++++++++++++++++++++++++++
Has the effect of setting the $slide_subtitle macro to "- Extending Your
Class::DBI Classes" (including the leading dash). The subtitle is
appended to this slide's TOC entry: "36. Advanced Topics - Extending Your
Class::DBI Classes".
A subtitle can be specified in several ways:
1) Text starting in column 1 and underlined with a row or '+'s or '-'s
2) Text starting in column 16 and underlined with a row or '+'s or
'-'s. This will produce a centered heading.
This is a subtitle ++++++++++++++++++ This is a smaller subtitle
--------------------------
This is a centered subtitle
+++++++++++++++++++++++++++
This is a smaller centered subtitle
-----------------------------------
|
* level one bullet
* level 2 bullet
|
Formatted text can be specified in several ways:
1)
Lines starting with white space will be displayed as fixed width text
2) A block of lines starting with '#begin code#' and ending with '#end code#'
This construct escapes html entities: &, < and '>'.
This is text
This is text
#begin code#
This is text
This is text
#end code#
|
------------------------------------------- <p><font color="#0000FF">This text will be displayed before the following title</font></p> This is the title of the new slide |
====================================================== |
#html# This is html text <This is HTML text> #begin html# This is HTML More HTML #end html# |
; Example 1 <p><font color="#0000FF">Some blue text</font></p> ; Example 2 <p align=center><font size="+2" color=red>LARGE CENTERED TEXT</font></p> ; Example 3 ; insert an image into the slide <img align=right src="f:\images\wolf.gif"> ; Example 4 ; insert an image aligned to the right #begin html# <img align=right src="f:\images\wolf.gif"> This text will be to the left of the image <br> This text will be to the left of the image <br> <br clear=right> This text starts below the image<br> #end html# ; Example 5 ; insert an image aligned to the left #begin html# <img align=left src="f:\images\wolf.gif"> This text will be to the right of the image <br> This text will be to the right of the image <br> <br clear=left> This text starts below the image<br> #end html# |