CGI::pWiki 0.15

CGI::pWiki is a Perl wiki environment.

SYNOPSIS

#!/usr/bin/perl
use CGI::pWiki;
use strict;
my $pWiki = new CGI::pWiki()->server();
0;

DESCRIPTION ^

The CGI::pWiki class, is providing an environment for serving a WikiWikiWeb for virtual hosts and multiple databases.

USAGE:

Installation

At first install the CGI::pWiki module either on the CPAN, or the Debian or by hand as usual with :

perl Makefile.PL &&
make &&
make test &&
su -c "make install"

First check your /etc/apache/httpd.conf for the system wide ScriptAlias path and directory path.

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/

The pWiki distibution includes a pWiki.cgi to be symlinked from your install point to your system wide cgi-bin directory.

ln -s /usr/local/bin/pWiki.cgi /usr/lib/cgi-bin/

Next check your /etc/apache/httpd.conf to contain at least those modules :

LoadModule mime_module /usr/lib/apache/1.3/mod_mime.so
LoadModule dir_module /usr/lib/apache/1.3/mod_dir.so
LoadModule cgi_module /usr/lib/apache/1.3/mod_cgi.so
LoadModule alias_module /usr/lib/apache/1.3/mod_alias.so
LoadModule access_module /usr/lib/apache/1.3/mod_access.so
LoadModule auth_module /usr/lib/apache/1.3/mod_auth.so
LoadModule setenvif_module /usr/lib/apache/1.3/mod_setenvif.so
LoadModule action_module /usr/lib/apache/1.3/mod_actions.so

Add a virtual host directive :

NameVirtualHost *
< VirtualHost * >
ServerName test.copyleft.de
DocumentRoot /var/www/test.copyleft.de
DirectoryIndex index.wiki index.xml index.html index.htm index.text
Action wiki-script /cgi-bin/pWiki.cgi
# Some Apaches need the next line, also.
# ErrorDocument 404 /cgi-bin/pWiki.cgi

AddHandler wiki-script .wiki
AddHandler wiki-script .text
AddHandler wiki-script .html
AddHandler wiki-script .htm
AddHandler wiki-script .pod
AddHandler wiki-script .xml
# The next line should be in 127.0.0.1 virtual hosts, only !
# AddHandler wiki-script .xsl
< /VirtualHost >

There is no need to add any handler besides .wiki and .text, if you dont want to manage the other files with pWiki. Handling .xsl files in fact opens a wide security hole, and should NOT be done outside a VirtualHost 127.0.0.1 environment.

Product's homepage

Requirements:

· Perl