README for PodWiki 0.3
===============================================


How to install
===============================================

There are two ways to install PodWiki. The preferred
way is to use the supplied configure script which
generates a Makefile for the installation. It is
also possible to install the files manually.

Installation via autoconf:
-----------------------------------------------
Enter the following command to create the Makefile:

 ./configure

You can change some variables before installing,
issue ./configure --help to find out what can
be tweaked. Usually you would want to change
the installation destination (--prefix) and the
user/group podwiki will run as (--with-user
and --with-group).

PodWiki must be installed somewhere into your apache's
document root. Make sure you have write permissions on
the target directory.

Now exeute the command:

 make install

This should install all the files into a new directory
and set some permissions. Important: The data/ and images/
directories must be writable by the apache. The Makefile
makes those directories writable for the user/group you
specified in the Makefile. This is neccessary because
PodWiki runs under the Userid of your apache and must
be able to write pages. 

Basic installation is now complete.


Manual Installation:
-----------------------------------------------
Copy the whole directory to your webservers document
root, probably into a newly created directory.
Make sure, the apache user is able to read the
files and to enter the directories. Apply write
permissions to data/ and images/ to the apache user.

Move podwiki.pl.in to podwiki.pl and edit the
shebang line (replace @PERL@ with the current perl
interpreter). Move podwiki.conf.in to podwiki.conf
(replace @PASSWD@ with a default passwd).

Basic installation is now complete.






How to configure
===============================================

During the installation process a .htaccess file
has been installed to the podwiki root directory.
You may edit this file to enable some features:

1. To run PodWiki under mod_perl, uncomment the
   mod_perl block (everything within the
   <IfModule mod_perl.c> block). mod_perl required!

2. To enable URi rewriting, uncomment the block
   <IfModule mod_rewrite.c>. mod_rewrite required!
   Note: normally a page view request would look like:
 	http://podwiki.org/podwiki.pl?page=UserHelp
   with reqriting it looks like:
   	http://podwiki.org/UserHelp
   You may change the regular exprssion to match it
   your installation. E.g. if you installed PodWiki
   to /var/www/htdocs/intranet/podwiki while 
   /var/www/htdocs/ is you document root, then the
   expression must be changed to:
   RewriteRule ^/intranet/podwiki/([A-Z][a-zA-Z\-\_\.]+)/?$   /podwiki.pl?page=$1  [PT]

Now open the file podwiki.conf with an editor.
You can change some vars. By default nothing have
to be changed beside the 'direct' variable which
must be turned on (set to '1') if you previously
enabled rewriting.






Changing the default root password
===============================================

PodWiki includes an authentication system. By default
a user 'root' will be created who is able to create
more users.

When PodWiki starts the first time, it presents you a
"Change Password" dialog which makes it possible to set
a new password for the root user of your PodWiki (the
root user is the default administrator account). This
dialog requires the default password which is defined in
the config file in the variable "default_admin_passwd"
and is only required the first time you start PodWiki.






Usage
===============================================

The user guide can be viewed online:

  http://$yourserver/podwiki.pl?page=PodWikiHelp

or read the text versions in the docs/ directory
within the source tarball.





Copyright
===============================================

PodWiki (c) 2003 by Thomas Linden <tom@daemon.de>.





License
===============================================

PodWiki is distributed under the terms of the
GPL. The dsitribution contains a copy of the GPL
in the file 'COPYING'.





Author
===============================================

Thomas Linden <tom@daemon.de>
