Steps to setup Moin for your Apache server
==========================================

These instructions are only an example, please refer to the upstream-supplied
documentation files in this package, http://moinmo.in/ and
http://code.google.com/p/modwsgi/ for more instructions on setting up Moin and
mod_wsgi.

It's very important to read the documentation in /usr/share/doc/moin-*,
especially when upgrading to a newer version of this package! 'rpm -qd moin'
should give a list of the documentation files in this package.

Moin is a pure WSGI application since 1.9.0, this README will guide you
through a basic setup with Apache and mod_wsgi. Make sure you have the
mod_wsgi package installed from the Fedora package repository. Refer to the
Moin website for documentation about setting up Moin with FCGI/SCGI/CGI or
with other web servers such as lighttpd.

Since 1.9.0 Moin runs a server to serve the static files itself from the path
defined in the url_prefix_static variable in wikiconfig.py.

Set up a wiki instance
----------------------

First you need a wiki instance, which can be set up as follows:

#!/bin/sh
DESTDIR=/var/www/mywiki
mkdir -p $DESTDIR
cp -a /usr/share/moin/{data,underlay} $DESTDIR
chown -R apache:apache $DESTDIR/{data,underlay}

Set up Moin
-----------

#!/bin/sh
DESTDIR=/var/www/mywiki
mkdir -p $DESTDIR
cp -a /usr/share/moin/server/moin.wsgi $DESTDIR
cp -a /usr/share/moin/config/wikiconfig.py $DESTDIR
cat > /etc/httpd/conf.d/mywiki.conf <<EOF
# this is the URL http://servername/mywiki/ you will use later to invoke moin:
WSGIScriptAlias /mywiki "$DESTDIR/moin.wsgi"

# The WSGI socket needs to be somewhere Apache has access to
WSGISocketPrefix /var/run/moin-wsgi

# in case you want your wiki under the root url (http://servername/), use this instead:
#Alias /robots.txt $DESTDIR/htdocs/robots.txt
#Alias /favicon.ico $DESTDIR/htdocs/favicon.ico
#WSGIScriptAlias / $DESTDIR/moin.wsgi

# create some wsgi daemons:
WSGIDaemonProcess moin user=apache group=apache processes=5 threads=10 maximum-requests=1000 umask=0007 umask=0007 display-name=wsgi-moin

# use the daemons we defined above to process requests!
WSGIProcessGroup moin

# This is required if you plan to use HTTP authorization. Without it the user name won't
# be passed to MoinMoin. 
#WSGIPassAuthorization On
EOF

The moin.wsgi file adds $DESTDIR to the Python search path, so Python should be
able to find wikiconfig.py automatically.
Finally, restart Apache by doing a "service httpd restart".