Note: This site moved to Please update your links. Thanks.

Settings, Tips, Tricks and More


How To Create Slides Without Titles?

You can use the !SLIDE directive to create slides without headings. Example:


A slide with no title


Another slide with no heading


And another

!SLIDE commandline

    $ ruby print.rb

!SLIDE image 


Note, you can pass along CSS style classes to your generated div or section that wraps your slide. Example:

!SLIDE smaller commandline

Will become:

<div class='slide smaller commandline'>

How To Use Gradient Themes for the Built-In S6 Template Pack?

You can define your gradient theme in plain text in the slide show source in the header using a simple CSS-style name value pair. More »

How To Use Your Own Slide Show Template Packages?

Use the -g/--generate switch to generate a sample template package with manifest using the built-in S6 machinery.

Example: Generate a template pack w/ manifest in your working folder

$ slideshow -g

Or fetch a sample template pack from the internet or fork it using git or create it from scratch. See the Template Gallery for more info and examples to get started.

To use your own template pack use the -t/--template MANIFEST option passing along the manifest. Example:

$ slideshow -t s6.txt  microformats
$ slideshow -t s5blank.txt   microformats

Got templates? Send a link and announcement to the Forum/Mailing List and get your link added to the Template Gallery.

How To Fetch New Template Packages?

Using the -f/--fetch URI option lets you fetch (install) new templates. Example:

$ slideshow -f 

Resulting in:

Fetching template package 's5blank' 
  : from ' 
  : saving to '/home/gerald/.slideshow/templates/s5blank' 
  Downloading manifest 's5blank.txt'... 
  Downloading template 'header.html.erb'... 
  Downloading template 'ui/default/slides.js'... 

Note, if you want to store the template pack somewhere else use the -c/--config option (defaults to ~/.slideshow).

To find more templates browse the Template Gallery.


Trouble downloading? Do you have a direct internet connection? If not, configure your proxy using the HTTP_PROXY environment variable. Sample:


Or with user credentials (that is, login and password):


If all fails, you can always download the template pack on your own (using lets say git itself) and than move the souces into your templates folder (that is, ~/.slideshow/templates).

How To Fetch New Template Packs Using git?

If you prefer you can fetch template packs using git itself in two steps

Step 1: Change to your templates folder

Issue the command:

cd ~/.slideshow/templates

Step 2: Clone (Fetch) the template pack using git

Let’s clone the slideshow-google-html5-slides template pack. Issue the command:

git clone

That’s it. Use the -l/--list option to list all you installed template packs.

How To List All Installed Template Packages?

Using the -l/--list option lets you list all installed templates. Example:

$ slideshow -l

Resulting in:

Installed templates include: 
  s5blank.txt       (/home/gerald/.slideshow/templates/s5blank/s5blank.txt) 
  s5.txt            (/usr/lib/ruby/gems/1.8/gems/slideshow-0.8/templates/s5.txt) 
  s6.txt            (/usr/lib/ruby/gems/1.8/gems/slideshow-0.8/templates/s6.txt) 
  fullerscreen.txt  (/usr/lib/ruby/gems/1.8/gems/slideshow-0.8/templates/fullerscreen.txt) 

How To Generate PDF Documents from Your Slide Shows?

When you generate your slide show as usual with the built-in S6 template pack you will get an extra <your_name_here>.pdf.html document generated that you can use to generate a PDF-version of your slide show using lets say the free, open source wkhtmltopdf tool.


$ slideshow tutorial

$ wkhtmltopdf --outline --orientation Landscape tutorial.pdf.html tutorial.pdf 

How To Set Default Command Line Options?

The SLIDESHOWOPT environment variable lets you set default command line options.

Example: Make slides your default output folder

$ SLIDESHOWOPT=-o slides

Example: Make S5-compatible slide show

$ SLIDESHOWOPT=-o slides -t s5blank.txt

Example: Make your own template package the default

$ SLIDESHOWOPT=-t <your_template_manifest_here>   

And than use the gem executable as usual (will use/add your command line options stored in SLIDESHOWOPT):

$ slideshow microformats

How To Comment Out Content?

Use % for comments anywhere (including headers) and %begin/%end for multi-line comments and %end to skip everything until the end.

%  Start off with some headers

title: 10 Things Every Java Programmer Should Know About Ruby
author: Jim Weirich

%  Let's go. The presentation starts here

# 10 Things Every Java Programmer Should Know About Ruby

Jim Weirich

See 10 Things Every Java Programmer Should Know About Ruby sample.

Note, as an alternative syntax to skip (comment out) content in your source enclose it with __SKIP__/__END__. Example:

  not yet ready or private notes/comments 

As a shortcut if you just use __END__ (without __SKIP__) (Ruby-like) it will skip everything from __END__ until the end of the file.

Questions? Comments?

Questions? Comments? Send them along to the Free Web Slide Show Alternatives (S5, S6, S9, Slidy And Friends) Forum/Mailing List. Thanks!

Note: This site moved to Please update your links. Thanks.