Kwiki::ModPerl - enable Kwiki to work under mod_perl

 $ kwiki -new /path/to/webroot/kwiki

In your Apache configuration:

 <Location /kwiki>
   SetHandler  perl-script
   PerlSetVar  KwikiBaseDir /path/to/webroot/kwiki
   PerlHandler +Kwiki::ModPerl
 </Location>

If you have a custom lib directory for your Kwiki:

 <Perl>
   use lib '/path/to/webroot/kwiki/lib';
 </Perl>

Also if you're using mod_perl2, please add the following line into your httpd.conf:

  PerlModule Apache2

This module allows you to use Kwiki as a mod_perl content handler.

* Sub-view are supported automatically

No extra apache configuration is required.

* Multiple Kwikis are supported.

As long as each Kwiki has its own KwikiBaseDir, you're golden.

* You might need a redirect for the Kwiki base directory.

For example, if your Kwiki is at the location /kwiki/ and you browse to /kwiki (without the trailing slash), you'll definitely experience some weirdness. I highly suggest adding a redirect:

    RedirectMatch ^/kwiki$ http://example.com/kwiki/

* Why index.cgi still shows up in the URL ?

Don't worry, it's ignored internally, so that it is still handled under mod_perl, not as a cgi script. Also, It can make all browser happy with relative URI redirection. (Although it shouldn't be a relative redirection, should be fixed in Kwiki base in the future).

* You might need to restart Apache.

Otherwise module additions and removal might not be working.

Ian Langworth <langworth.com>

Now Maintained by Kang-min Liu <gugod@gugod.org>

Kwiki

Copyright (C) 2004 by Ian Langworth Copyright (C) 2005 by Kang-min Liu

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