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 No extra apache configuration is required.
36
37 * Multiple Kwikis are supported.
38 As long as each Kwiki has its own KwikiBaseDir, you're golden.
39
40 * You might need a redirect for the Kwiki base directory.
41 For example, if your Kwiki is at the location "/kwiki/" and you
42 browse to "/kwiki" (without the trailing slash), you'll definitely
43 experience some weirdness. I highly suggest adding a redirect:
44
45 RedirectMatch ^/kwiki$ http://example.com/kwiki/
46
47 * Why index.cgi still shows up in the URL ?
48 Don't worry, it's ignored internally, so that it is still handled
49 under mod_perl, not as a cgi script. Also, It can make all browser
50 happy with relative URI redirection. (Although it shouldn't be a
51 relative redirection, should be fixed in Kwiki base in the future).
52
53 * You might need to restart Apache.
54 Otherwise module additions and removal might not be working.
55
57 Ian Langworth <langworth.com>
58
59 Now Maintained by Kang-min Liu <gugod@gugod.org>
60
62 Kwiki
63
65 Copyright (C) 2004 by Ian Langworth Copyright (C) 2005 by Kang-min Liu
66
67 This library is free software; you can redistribute it and/or modify it
68 under the same terms as Perl itself.
69
70
71
72perl v5.8.8 2005-09-21 Kwiki::ModPerl(3)