########################################################################
# PWiki
# Copyright (C) 1999,2000 John L. Jorgensen
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
########################################################################

This is the PHP implementation of WikiWikiWeb. It appears to function fine with
PHP3 and PHP4. Requirements are an apache web server with
PHP installed as a module. I haven't tried it on windows boxes, but it should
work with some (or maybe no) modification. 

There are two ways to setup wiki, the easy way is to run the setup.sh script in
the top if the install directory (probably the directory where this README is.
The setup.sh script has to be run as root. It will ask you for the root
directory of your apache server and the username that it runs as (the default
is nobody in most apache installations). Once it gathers this info, it will
untar pwiki.tgz to the root of your apache server, chown it to the owner of
apache, add an include line to your httpd.conf (at the end), and build the
wikiinclude.conf file which contains the apache directives to make wiki work.

The manual way of installing wiki is detailed below.

Untar the pwiki.tgz ball into the desired document root
dir. There, it will make a pwiki dir and populate it. Next, add something
similar to the following to your httpd.conf; 

Alias /wiki/ "/home/apache/pwiki/areas/"
Alias /wiki-files/ "/home/apache/pwiki/upload/"
<Directory "/home/apache/pwiki/areas/">
    ForceType application/x-httpd-php3
    AllowOverride None
    Options FollowSymLinks
    AuthType Basic
    AuthName "editors"
    AuthUserFile /home/apache/pwiki/editors
    <Limit POST>
      require valid-user
    </Limit>
</Directory>
<Directory "/home/apache/pwiki-files">
    AllowOverride None
    Options FollowSymLinks
    Order allow,deny
    Allow from all
    AuthType Basic
    AuthName "editors"
    AuthUserFile /home/apache/pwiki/editors
    <Limit POST>
      require valid-user
    </Limit>
</Directory>

Restart apache and try your new wiki out.

Once your wiki is up and running, point at http://localhost/wiki/wiki for
info on how to use and administer pwiki.

Please see the file COPYING in the root pwiki dir for license information.