Kwiki::ModPerl.3pm

Langue: en

Version: 2005-09-21 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

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