Introduction

This slidemaker tool generates HTML slides with the regular W3C presentations style
It is a small PERL script that runs on Windows or UNIX
It uses standard styles sheets that you can override with your own
It adds all navigation buttons to your presentation and also a button to cycle through different CSS files

Installation

Download the software in your prefered format (slidemaker.zip, slidemaker.tgz)
Unzip the archive to your local disk in C:\ for example
C:\Talks\Tools contains the script and the CSS files
C:\Talks\Icons contains the navigation buttons
C:\Talks\YYYY\ contains a presentation example

Note: if you are working online in http://www.w3.org/YYYY/Talks/ you don't need to install the tool

How to use the tool

Copy the template directory C:/Talks/YYYY/, for example C:/Talks/2000/MyTalk/
Edit the file all.htm that will contain the text of your presentation. Each <h1>..</h1> delimits a slide
Edit the parameter file infos.txt
Type make in your C:/Talks/2000/MyTalk/
When working on http://www.w3.org/, from any browser, open http://www.w3.org/2000/Talks/MyTalk/all.htm,slideme
Check the warning messages and fix your all.htm if necessary
Your presentation starting point is C:/Talks/2000/MyTalk/Overview.htm

The parameter file infos.txt

talkTitle: title of the talk
author (, author2): name of the author (and co-author)
authorUrl (, author2Url): link on the author's (and co-author's) name, can be left blank
logoFile (, logoFile2): the name of the logo (and second logo) at the bottom of the slides
logoLink (, logoLink2): link on the logo (and second logo) at the bottom of the slides
logoAlt (, logoAlt2): alt text for the logo (and second logo) at the bottom of the slides
cssStandardFiles: list of standard CSS files used for the presentation
cssUserFiles: list of your own CSS files to overload the standard files
baselang: primary language of the slides, e.g., en-US, fr-CA, ja, ...
charset: character encoding of the slides, e.g., ISO-8859-1, UTF-8, EUC-JP, ...
prevKey, nextKey, tocKey, styleKey: accesskey for navigation buttons

Notes:

all paths in these parameters should be relative, all parameters have default values
when using Slideme, infos.txt will be built for you

Hints for using the tool

To see what the standard style looks like, check this test document test.htm
If you need to overload the standard style, use cssUserFiles to point to your own CSS files in C:/Talks/2000/MyTalk/
You could also add a CSS file to cssStandardFiles that would be used for printing
You can use <div class="comment">my_comment</div> to put speaker comments in your all.htm. Theses comments will not appear in the slides. Example, you don't see the next line but check the source all.htm

Example: THIS IS A COMMENT THAT DOES NOT APPEAR IN THE SLIDES

Hints for giving your presentation

Use a CSS capable browser
Don't use the scrollbar, leave your mouse pointer around the navigation buttons and use page-up, page-down if you need to scroll through the slide
Use the "Change style button". It cycles through the different standard styles sheets, so you can zoom/unzoom
If your browser supports accesskey, navigation buttons can be directly accessed via P (Previous), N (Next), C (Contents) and S (change Style) keys. These keys can be overridden by specifying prevKey, nextKey, tocKey and styleKey valiables in infos.txt
From the table of contents, fist 9 slides can be directly accessed via 1 through 9 keys using accesskey feature
You can print your all.htm to read all your presentation on one page and also the comments that does not appear in the slides

How to put your slides on the Web

To put your slides under http://www.w3.org/Talks/

Append ,slideme to your talk in a browser http://www.w3.org/2000/Talks/MyTalk/all.htm,slideme

Copy the template directory /afs/w3.org/pub/WWW/Talks/YYMMsub/ in /afs/w3.org/pub/WWW/2000/Talks/MyTalk/ for example
Put your own all.htm and infos.txt (and also your additional CSS files and image files)
Build your slides and update the Talks/Overview.html page
http://www.w3.org/YYYY/ is under ACL. Set the ACLs using http://www.w3.org/2000/Talks/MyTalk*,access*

To put your slides elsewhere

Remember to copy C:/Talks/Tools/, C:/Talks/Icons/ along with your C:/Talks/1998/MyTalk/

Changes Log

To upgrade your tool, just unzip the new archive in the same directory, it will overwrite the relevant files. Please send comments, requests to change the standard style sheets file to w3t-dev@w3.org

9612: version 1.0

9704: version 1.1

fixed a bug in <h1>foo</h1> detection
added variable LOGO in the makefile. Use this to change the logo in your slides, for instance for WWW6 use ../Icons/www6.gif. By default it is the regular W3C logo, ../Icons/w3c_home.gif
added variable STYLE_SHEET in the makefile. Use this if you need a customized style sheet. Copy the default ../Tools/w3ctalk.css in your new talk directory and customize that one only. Then link it to your talk using that variable.
wrote a test document test.htm

9706: version 2.0

The script has been rewritten in PERL, there are no more bugs in the <h1>*</h1> detection
Added checking for ALT in <IMG> tags
Added 3 CSS files for 640, 800, 1024 pixels width displays
moved parameters from make.bat and Makefile to the common file infos.txt

9711: version 2.1

Added the "Change size" button
Added the cssUserFiles parameter
Added the <div class="comment">blabla</div> functionality
Rewrote the documentation

9804: version 2.2

Anchors removed from slide links

9805: version 3.0

Add support for navigation icons being in a single directory C:/Talks/Icons/ whereas talks are in directories such as C:/Talks/1998/MyTalk/ (uses relative links starting by /Talks/Icons/ instead of ../Icons/ when applicable)
Same fix for C:/Talks/Tools/
2 fixes above are especially useful for W3C AFS space
added Slideme information for easy slides creation

1998 June 1: version 3.1

doctype HTML 4.0 transitional added on the slides (validation needed)
previous and next slide buttons bear a title
slides are numbered

1998 June 12: version 4.0 by Pierre Fillault

main program w3cburst.pl is commented
generate multiple table of contents (TOC) corresponding to the different style sheets
keep the main TOC without number so the server can pick it up with a request to http://www.w3.org/Talks/1998/MyTalk/
all the links contain extension (.html or .gif) so the presentation can be given from anywhere (web server is not needed - but this defeats content negotiation)
white background style sheets have been added and fixed (better for projection)

1999 June 4: version 4.01 by Masayasu Ishikawa

fixed w3cburst.pl to generate valid HTML 4.0 Transitional slides

1999 June 22: version 4.02 by Masayasu Ishikawa

refined w3cburst.pl to generate cleaner code (e.g. quoted all attribute values)
updated documentation

1999 June 23: version 4.1 by Masayasu Ishikawa

added support for accesskey; navigation icons can be directly accessed via P (Previous), N (Next), C (Contents) and S (change Style) keys
changed order for link relationship for easier navigation
added title for icons in addition to alt

1999 June 29: version 4.11 by Masayasu Ishikawa

added new variables prevKey, nextKey, tocKey and styleKey so that access keys can be changed when those shortcuts conflict with other shortcuts
added accesskey for first 9 slides (1-9) and tabindex for all slides from table of contents.
updated documentation; added description for all parameters in infos.txt
refined Makefile and make.bat
comments should be sent to w3t-dev@w3.org instead of webreq@w3.org