So you'd like to use ikiwiki on Alioth. This is supported by the kind alioth admins, who installed ikiwiki there; here are a few things to know:
- alioth is now using ikiwiki 2.x.
If you set up ikiwiki there before January 3rd, 2008, you will need to make some changes for 2.0. The main change in 2.0 is that it uses userdirs by default. Instead of switching to userdirs, you can set "userdirs => 0" in your setup file.
Another recent change in ikiwiki is that for security reasons it refuses to follow symlinks on the path to the wiki source files. So if you've been telling ikiwiki to use paths in /var/lib/gforge/, you'll need to dereference the link and use /srv/alioth.debian.org/ instead.
- Once you're ready to upgrade to the new version, re-run ikiwiki -setup on your setup file.
- It's a good idea to let ikiwiki-mass-rebuild(8) know where your setup file is so your wiki can be upgraded correctly. To do this you need to create a ~/.ikiwiki/wikilist file, that lists all of your setup file(s):
userid /home/userid/.ikiwiki/ikiwiki.setup
- After creating a wikilist file, your user id needs to be added to /etc/ikiwiki/wikilist so ikiwiki-mass-rebuild will find it. The ikiwiki-update-wikilist command will add your user id to the file. (XXX assuming it's available on alioth.)
Be sure to list your wiki on http://ikiwiki.info/ikiwikiusers