NAME

Kwiki::ModPerl - enable Kwiki to work under mod_perl

SYNOPSIS

 $ 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

DESCRIPTION

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

FEATURES, BUGS and NOTES

  • 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.

AUTHORS

Ian Langworth <langworth.com>

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

SEE ALSO

Kwiki

COPYRIGHT AND LICENSE

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.