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:
/kwiki/
/kwiki
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.
To install Kwiki::ModPerl, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Kwiki::ModPerl
CPAN shell
perl -MCPAN -e shell install Kwiki::ModPerl
For more information on module installation, please visit the detailed CPAN module installation guide.