Presentations in DokuWiki

S5 DokuWiki theme I just added a new feature to DokuWiki called “pluggable renderers”. In case you don't know: DokuWiki parses Wiki syntax into an instruction array which then is “rendered” to the desired output format. This output format is usually the XHTML to display a nicely formatted Wiki page. Pluggable renderers allow plugin authors to write their own renderer to output any format they want. This adds another bit of flexibility to DokuWiki.

So what has this to do with presentations? I will answer that in a minute. Just one more excursion.

Eric Meyer created a completely web based presentation system named S5 1) a while ago. It uses some CSS and JavaScript magic and a single specially formatted XHTML page to create a Power Point like slide show. This is great because you don't need to rely on any presentation binaries (Power Point viewer, Open Office Impress…) - just open a web browser and you're ready to present.

There was just one thing that annoyed me: creating a presentation manually was a tedious task. See where we get here?

That's right. I have a perfect tool to generate XHTML already. It's called DokuWiki. So why not combine both tools? With pluggable renderers I just needed to inherit from the default XHTML renderer and override a few methods to output the XHTML needed by S5. The result is the S5 DokuWiki Plugin.

I recommend to have a look at the example presentation. It's just a standard DokuWiki page, but the ~~SLIDESHOW~~ macro in it's source adds the icon in the upper right corner – click it and you're looking at the same page as presentation.

Tags:
dokuwiki,
plugin,
presentation,
s5,
slideshow
Similar posts:
1) Simple Standards-Based Slide Show System

 
Posted on Monday December the 4th, 2006 (20 months ago).

Comments

1
Nice one!

The only minor gripe I have is re: S5, that it doesn't update the URL as you browse the presentation  - that should be do-able using a URI fragement identifier - something like;

window.location.replace( window.location.search + '#' + slideNumber);
2006-12-05 09:44:15
Harry Fuecks
2
Thanks, for the hint Harry. I changed the S5 script code accordingly. Seems to work fine :-)
2006-12-05 23:12:51
3
Great!! This is indeed useful - how does one get back to the wiki page from a presentation? (other using the back button)
2006-12-06 06:43:39
Tarique Sani
4
"Thanks, for the hint Harry. I changed the S5 script code accordingly. Seems to work fine :-)"

Great - had thought this was something S5 needed to add.
2006-12-06 09:47:52
Harry Fuecks
5
Looks like there's a small bug - everything works fine if I use the S5 UI but if I manually change the fragment identifer while I'm in the middle of the presentation (e.g. I'm viewing slide 3 and, via altering the URL, I change to slide 1) it seems to lose track of which slide it's on (looks like the global snum variable resets to 0).

This may be an "interesting" problem. Changing the fragment identifier manually doesn't fire window.onload - in fact the standard way to handle this seems to be by polling - http://ajaxpatterns.org/Unique … L_Sum_Demo

With S5 there's a further factor though that hitting return (as you do on modifying the URL in the address bar) may be kicking an event to change the slide.
2006-12-06 11:14:02
Harry Fuecks
6
Sorry - filling your blog comments today - another issue is the browser history - back button from, say slide 5 (after paging through to it), takes by back to slide 3. Further clicks on back get stranger...
2006-12-06 12:08:46
Harry Fuecks
7
S5 looks really great.  However, I think it would be important to be able to save the presentation ("Save Complete HTML" in the browser).  Right now, the presentations still depend on some network resources, but I don't see any intrinsic reason why that needs to be so.
2007-02-13 05:26:38
Tom
CAPTCHA

No HTML allowed. URLs will be linked with nofollow attribute. Whitespace is preserved.

 
 

Blog

Older Weblog articles are available in the Archive, subscribe to the
Full Content RSS Feed
to stay tuned. (learn more)

Subscribe to the Feed

Recent Blog Entries

 

This is the personal web site of Andreas Gohr - human being, blogger and web geek from Berlin, Germany.

This page was last updated at 2006/12/04 23:13.
Imprint/Impressum

Tagged at del.icio.us:

Bookmarks: 7

View blog reactions

Recent readers: