The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
mediawiki-slides-0.04
River stage zero No dependents
++
/ README

To better view this file, use:

        perldoc README

slide

Takes a list of articles for a presentation as well as the presentation name and generates a navigation box for these slides, which also hightlights the current slide.

This package is intended to integrate into Wikimedia, the software behind popular wikis like http://en.wikipedia.org/.

Example input:

        <slides>
        name=My Presentation
        Start
        How to?
        Finish
        </slides>

would result in something like this:

        [[My Presentation - Start|Start]] - [[My Presentation - How to?|How to?]] - [[My Presentation - Finish|Finish]]

Check the Signature

First you need to check the signature on the package to verify that it is untampered and intact. To do this you have to:

  • Install the Perl module Module::Signature from http://search.cpan.org

  • Get my key from http://bloodgate.com/tels.asc, import it into GnuPG with:

            gpg --import tels.asc

    You may also let the cpansign utility fetch it automatically from a keyserver, if that works for you.

  • Extract the package to a directory, change there and then:

  • Type on a console:

            cpansign --verify

    inside the unpacked directory.

If the last step says "good signature" or "SIGNATURE VERIFIED OK", everything is all right.

Note that if you cpansign let GnuPG download my key from a keyserver, it might put a tels.asc file in the package directory, and then afterward complain that "tels.asc" is not in the MANIFEST:

 Not in MANIFEST: tels.asc
 ==> MISMATCHED content between MANIFEST and distribution files! <==

You can safely ignore this warning.

NOTE: Please notify me immidiately if the signature does not verify. In that case do NOT install this software, your system might get compromised!

Installation

This extension was developed and tested with Mediawiki 1.6.3. It seems to work on 1.5.x, too, but you are encouraged to update the Mediawiki software.

Run the testsuite

Run in the directory of this package:

        perl Makefile.PL
        make test

All tests should pass. If not, please notify me.

Make a backup of your wiki directory! I repeat, MAKE A BACKUP! You have been warned!

Now copy all the files from the extensions/ subdirectory inside this extension to the extension dir of your wiki, like so:

        http_docroot
                \ - cgi-bin                     etc
                \ - wiki
                        \ - extensions          <-- to here

At present this is only one file, Slides.php.

Then include the following line at the bottom of your LocalSettings.php, but before the "?>" line:

        require_once('extensions/Slides.php');

Usage

A complete presentation, created with this very module itself, can be found at:

        http://bloodgate.com/wiki/

AUTHOR

Copyright (C) 2006 by Tels http://bloodgate.com/

Contact: <nospam-abuse@bloodgate.com> (literally :)

This library is free software; you can redistribute it and/or modify it under the same terms of the GPL version 2.