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/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/1998/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/1998/MyTalk/
• When working in http://www.w3.org/Talks/, from any browser, open http://www.w3.org/Talks/1998/MyTalk/all.htm,slideme
• Check the warning messages and fix your all.htm if necessary
• Your presentation starting point is C:/Talks/1998/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/1998/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/Talks/1998/MyTalk/all.htm,slideme

or

• Copy the template directory /afs/w3.org/pub/WWW/Talks/YYMMsub/ in /afs/w3.org/pub/WWW/Talks/1998/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

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

1999 July 16: version 4.12 by Masayasu Ishikawa

• fixed bug on $logoAlt
• preserved link(s) in the slide title

1999 July 17: version 4.13 by Masayasu Ishikawa

• fixed bug on generating TOCs
• fixed bug on $toclink
• added new style sheets slide-{640,800,1024}.css created by Chris

1999 July 19: version 4.14 by Masayasu Ishikawa

• h1.slide is now outside of table
• added samples for all style sheets in documentation