The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Kwiki::Edit::SubEtha - SubEthaEdit Plugin for Kwiki

VERSION

This document describes version 0.02 of Kwiki::Edit::SubEtha, released July 27, 2004.

SYNOPSIS

A live SubEthaKwiki is available at http://wiki.oreillynet.com/oscon/ for the duration of O'Reilly Open Source Convention 2004.

DESCRIPTION

SubEtha Machine

You need OS X 10.3 or above, with UI Scripting enabled; see http://www.apple.com/applescript/uiscripting/01.html for instructions on how to enable it.

Tweak the configuration constants in script/subethakwiki.pl and run it. It will do several things every 15 seconds:

 * force an autosave
 * svn up
 * check for each "A edits/*", set TTL
 * open the documents in SubEthaEdit and share them
 * svn ci
 * check for each "M pages/*" and refresh their TTL
 * for pages that has TTL expired, close the document, record it.
 * svn rm edits/* those pages.
 * svn ci
 * loop

Note that the SubEthaEdit window will pop out constantly; currently, you really need a dedicated machine to do this.

Kwiki Machine

First, install the Kwiki::Archive::SVK plugin, run index.cgi once, then share the repository located at kwiki_path/plugin/archive using svnserve or WebDAV, and make it accessible form the SubEtha machine.

Now install the Kwiki::Edit::SubEtha plugin. For nonshared (normal) pages, the user will see:

 * provides an "Edit" item as normal.
 * for OSX people, an additional "SubEthaEdit" button:
 ** shows a page explaining what's it about
 ** explain the rules
 ** offer a link that, when clicked, does "svk mkdir edits/Pagename"
 ** and redirects to see://hostname/PageName/

For shared (subetha-editable) pages, the user will see:

 * a "Lock" item explaining it's being locked by SubEthaEdit
 * for OSX people, a "SubEthaEdit" button that just links to see://see_url.

AUTHORS

Autrijus Tang <autrijus@autrijus.org>, Brian Ingerson <INGY@cpan.org>.

COPYRIGHT

Copyright 2004 by Autrijus Tang <autrijus@autrijus.org>, Brian Ingerson <INGY@cpan.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html