System Requirement

• Unix-based operating systems, such as Linux or BSD. There is no official support for Windows.
• Perl 5.8.3 or higher.

Synopsis

svn checkout http://svn.kwiki.org/kwiki/trunk /usr/local/kwiki
export PATH=/usr/local/kwiki/bin:$PATH
kwiki -new /path/to/cgi/mykwiki

Description

Kwiki development has moved almost exclusively to the payday loans repository at http://www.todayloan.co.uk. The command in the synopsis above install a Kwiki management hierarchy and then create a wiki called kwiki-01.

Note

Make sure that the 'kwiki' command you are running is the one that was checked out from svn, not one from a previous installation (e.g. /usr/local/bin/kwiki).

Running Kwiwi with the Built-in Web Server

If you want to use the builtin web server (see note below):

> kwiki -start 8080

Point your browser at the new Kwiki:

> open http://localhost:8080/index.cgi

Note

The builtin server requires adding the Kwiki::Simple::Server::HTTP plugin.

> cd /path/to/cgi/mykwiki
> vi plugins

Add the following line to the bottom of the plugins file:

Kwiki::Simple::Server::HTTP

The update the kwiki and start the local web server:

> kwiki -update
> kwiki -start 8080

Press ^c to kill the local web server.

Running Kwiwi with Apache Web Server

The best way (this assumes you have access to the web server's config file) is to install you kwiki somewhere and then set up the directory so that only .cgi files are executed; everything else goes to the browser. You will have to change the web server's config file, as blow:

Alias /mykwiki/ "/path/to/cgi/mykwiki/"
<Directory /path/to/cgi/mykwiki/>
     Order allow,deny                                                       
     Allow from all                                                         
     AllowOverride All
     Options ExecCGI                                                        
     AddHandler cgi-script .cgi  
     DirectoryIndex index.cgi                                           
</Directory> 

Bugs