Example: A single wiki using CGI with Apache2

Most of this comes directly from /usr/share/doc/python-moin/README.Debian.gz. I've modified it slightly to account for a different folder structure and being serverd at the root of the webserver.

I like using the /srv/ folder for content, so in this example I've created two folders: One for Apache to serve and the other is MoinMoin's data folder. It needs to be outside the Apache webroot.

1. Create and populate /srv/wiki/:

   # mkdir /srv/wiki/www
   # mkdir /srv/wiki/lib
   # cp -r /usr/share/moin/data /usr/share/moin/underlay /srv/wiki/lib
   

2. You need to make it so Apache owns the folders:

   # chown -R www-data /srv/wiki/www /srv/wiki/lib
   

3. Configure Apache2:

   In this example we want to host at the root of our server. Watch out for trailing slashes and add the following as /etc/apache2/sites-available/wiki:

   <VirtualHost *:80>
     ServerName wiki.example.org
     DocumentRoot /srv/wiki/www  # no trailing slash or ScriptAlias won't work
     Alias /moin_static193/applets/FCKeditor/ "/usr/share/fckeditor/"
     Alias /moin_static193/ "/usr/share/moin/htdocs/"
     ScriptAlias / "/usr/share/moin/server/moin.cgi"
   </VirtualHost>
   

4. Configure MoinMoin:

   Edit /etc/moin/mywiki.py to include these lines:

   sitename = u'MyWiki' # [Unicode]
   data_dir = '/srv/wiki/lib/data'
   data_underlay_dir = '/srv/wiki/lib/underlay'
   superuser = [u"YourName", ]
   

   Edit /etc/moin/wikilist to include this line:

   www-data wiki.example.org/
   

5. Activate the site and reload Apache:

   # a2ensite mywiki
   # invoke-rc.d apache2 reload
   

6. Visit your new wiki at http://wiki.example.org/LanguageSetup then create you account (name according to the superuser you specified above).

7. Install the language pack you want to use (typically, you want to install the all_pages pack in English, plus the languages use in your wiki).

Example: A single wiki using WSGI with Apache2

TODO

Example: using farmconfig.py

TODO