1Kwiki::ModPerl(3)     User Contributed Perl Documentation    Kwiki::ModPerl(3)
2
3
4

NAME

6       Kwiki::ModPerl - enable Kwiki to work under mod_perl
7

SYNOPSIS

9        $ kwiki -new /path/to/webroot/kwiki
10
11       In your Apache configuration:
12
13        <Location /kwiki>
14          SetHandler  perl-script
15          PerlSetVar  KwikiBaseDir /path/to/webroot/kwiki
16          PerlHandler +Kwiki::ModPerl
17        </Location>
18
19       If you have a custom lib directory for your Kwiki:
20
21        <Perl>
22          use lib '/path/to/webroot/kwiki/lib';
23        </Perl>
24
25       Also if you're using mod_perl2, please add the following line into your
26       httpd.conf:
27
28         PerlModule Apache2
29

DESCRIPTION

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

FEATURES, BUGS and NOTES

34       •   Sub-view are supported automatically
35
36           No extra apache configuration is required.
37
38       •   Multiple Kwikis are supported.
39
40           As long as each Kwiki has its own KwikiBaseDir, you're golden.
41
42       •   You might need a redirect for the Kwiki base directory.
43
44           For example, if your Kwiki is at the location "/kwiki/" and you
45           browse to "/kwiki" (without the trailing slash), you'll definitely
46           experience some weirdness.  I highly suggest adding a redirect:
47
48               RedirectMatch ^/kwiki$ http://example.com/kwiki/
49
50       •   Why index.cgi still shows up in the URL ?
51
52           Don't worry, it's ignored internally, so that it is still handled
53           under mod_perl, not as a cgi script. Also, It can make all browser
54           happy with relative URI redirection. (Although it shouldn't be a
55           relative redirection, should be fixed in Kwiki base in the future).
56
57       •   You might need to restart Apache.
58
59           Otherwise module additions and removal might not be working.
60

AUTHORS

62       Ian Langworth <langworth.com>
63
64       Now Maintained by Kang-min Liu <gugod@gugod.org>
65

SEE ALSO

67       Kwiki
68

70       Copyright (C) 2004 by Ian Langworth Copyright (C) 2005 by Kang-min Liu
71
72       This library is free software; you can redistribute it and/or modify it
73       under the same terms as Perl itself.
74
75
76
77perl v5.34.0                      2022-01-21                 Kwiki::ModPerl(3)
Impressum