1Kwiki::ModPerl(3) User Contributed Perl Documentation Kwiki::ModPerl(3)
2
3
4
6 Kwiki::ModPerl - enable Kwiki to work under mod_perl
7
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
31 This module allows you to use Kwiki as a mod_perl content handler.
32
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
62 Ian Langworth <langworth.com>
63
64 Now Maintained by Kang-min Liu <gugod@gugod.org>
65
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.32.0 2020-07-28 Kwiki::ModPerl(3)