How to install MoinMoin
Wiki on a sourceforge project web
I spend much time find out how to install MoinMoin wiki for the cppunit
project. The main obstacle is that sourceforge web servers only have
python 1.5.2, while MoinMoin wiki requires python 2.x.
I found a working MoinMoin wiki on omniorb web (http://omniorb.sourceforge.net).
This is basically the release 1.0 ported to python 1.5.2. I fixed some
of the remaining portability issues (use of cgi.FieldStorage.getvalue()
which does not exist in python 1.5.2), and made a ready to install
tarball.
Here is the link to the tarball.
Here are the step to deploy MoinMoin
on your project
- log into sourceforge shell and go to your project home
- download and unpack the moinmoin tarball in the top directory.
- edit cgi-bin/moin.cgi
and change the path to your project
- follow MoinMoin wiki instruction to setup your own wiki. Here is
a quick summary:
- make a wiki directory
- copy the moin_config.py
and data directory from the share directory to your wiki directory.
- copy the htdocs
directory content from the share directory to your htdocs/wiki (you need to create that
one)
- make sure that your wiki/data
directory is world writable (chmod -R o+w)
- edit your wiki/moin_config.py
and setup your wiki name, logo and the path to your wiki/data directory.
- bin/autobackup.py
is a python script that can be used to handle daily/weekly and monthly
backup. Be sure to change your project root if you use it. You need to
setup a cron task to make the nightly backup (as wiki data are world
writable, they can be erased by anyone. This has already happen twice on
sourceforge in one year). Here are the quick step to do that
- edit your crontab using the command 'crontab -e'
- in the file, enter the following line, replacing the cppunit
group path with your project group:
30
14 *
*
*
/home/groups/c/cp/cppunit/bin/autobackup.py
- save your file, and check that it has been correctly inputed
with 'crontab -l'
You also need to edit moin_config.py
to add the sourceforge logo as it is required. Add the following code
after html_head declaration:
page_footer1 = """<hr><a
href="http://sourceforge.net/projects/cppunit">
<img align="right" vspace="10"
src="http://sourceforge.net/sflogo.php?group_id=11795"
width="88"
height="31" border="0" alt="SourceForge Logo"></a>"""
You must replace the link to the project, as well as the project
group_id (11795). You can find that one in the web tab of your project
admin page.
Check omniorb project or cppunit project for an example of deployment
(/home/groups/o/om/omniorb/ and /home/groups/c/cp/cppunit/ respectively).
You can test your wiki installation with:
http://cppunit.sf.net/cgi-bin/moin.cgi?test
(replacing cppunit by your project name).
Baptiste Lepilleur, September 2003