Kwiki::ModPerl.3pm

Langue: en

Autres versions - même langue

Version: 2005-09-21 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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.