Voodoo is not for newbies!
This page gives some nice but advanced tricks for a moin apache setup. The directives on this page assume that you have knowledge about apache configuration, newbies should stick to the basic setup.
Apache Root Wiki
This requires an apache including mod_rewrite (which should be standard)
An apache root wiki is a easy thing, but it has its 'edges': cause moin needs to access certain static files (images, css, etc.) its steals a part of the possible WikiName namespace.
Install moin as normal.
Set url_prefix in your wikiconfig.py:
url_prefix = '/_static'
Add the following lines to your apache (vhost?) config:
RewriteEngine On RewriteLogLevel 0 # Point to moin shared static files RewriteRule ^/_static/(.*)$ /prefix/share/moin/htdocs/$1 [last] # Map everything else to moin cgi script RewriteRule ^(.*)$ /path/to/moin.cgi$1 [type=application/x-httpd-cgi] # Setting for FastCGI ##RewriteRule ^(.*)$ /path/to/moin.fcg$1 [type=application/x-httpd-fcgi]
The RewriteRule for FastCGI here does not work for me:
[Wed Jan 05 01:43:41 2005] [error] [client 10.0.0.1] File does not exist: /home/apache/moin/wiki/share/moin/pw/moin.fcg/RecentChanges, referer: http://moin.dahoam/StartSeite duplo:/home/danielt# ls /home/apache/moin/wiki/share/moin/pw/moin.fcg -rwxr-xr-x 1 root www 1088 Jan 4 23:35 /home/apache/moin/wiki/share/moin/pw/moin.fcg*
As a workaround I use this:
RewriteRule ^/?(.*) /_Wikiscript_/moin.fcg/$1 RewriteRule ^/_Wikiscript_/(.*) /home/apache/moin/wiki/share/moin/pw/$1 [last]
Root wiki with mod python recipe
Using the previous example, I got this working like this:
Install moin as usual and create instance
Use this config in httpd.conf
NameVirtualHost 192.115.134.51:80 <VirtualHost 192.115.134.51:80> ServerName wiki.nirs.dyndns.org ServerAlias wiki # Rewrite urls RewriteEngine On RewriteLogLevel 0 # map static files to htdocs RewriteRule ^/wiki/(.*)$ /usr/share/moin/htdocs/$1 [last] # map everything else to server script RewriteRule ^(.*)$ /usr/share/moin/mywiki/moinmodpy.py$1 <Directory "/usr/share/moin/mywiki"> # These are copied from the default cgi-bin directory AllowOverride None Options None Order allow,deny Allow from all # Modpy stuff AddHandler python-program .py # Add the path to the wiki directory, where moinmodpy.py and # wikiconfig.py are located. PythonPath "['/usr/share/moin/mywiki'] + sys.path" PythonHandler moinmodpy PythonDebug On </Directory> </VirtualHost>
It seems to be impossible to get a root modpy wiki without using the moinmodpy wrapper script.