2006-10-14 Oddmuse Documentation

I spent some time reorganizing the Oddmuse:Getting Started section. I also spent some time in improving Oddmuse:Setup on a Mac OSX System eventhough I assume very few OSX users will actuall use Oddmuse. People will probably prefer an ordinary wiki widget. And the next OSX Server will include a wiki, I have heard. Oh well. I just couldn’t resist. ;)

Oddmuse:Getting Started

Oddmuse:Setup on a Mac OSX System

How strange to think that I always wanted Oddmuse installation to be easy, and I really think it is. And when I try to document it for OSX, it turns out to be totally complicated? And even though I tried to avoid it, there is at least on step that involves the command-line. That’s horrible! I need to write an extra installer? Maybe I should try and figure out how hard it is to use a “standard” installer for OSX.

All this time I spent on improving the documentation – what a waste!

I wish similar installers would exist for other systems.

Here’s what another installer would have to do:

1. It would have to build from my Makefile, so that the knowhow remains in the project even if the contributor moves on.

2. It needs to create a data directory with the correct owner and group and permissions. Something like _Library_WebServer/Oddmuse or _var_www/oddmuse. A directory that will not be served by the webserver.

3. It needs to create a config file the correct owner and group and permissions in this directory. The content should be just a single line: `$AdminPass = '';`

4. It needs to create a modules directory with the correct owner and group and permissions.

5. It needs to place the Oddmuse:Creole Markup Extension with the correct owner and group and permissions in this directory.

6. It needs to install the core script and a simple wrapper script pointing at the data directory in the default location for CGI scripts. Something like _Library_Webserver/CGI-Executables or _usr_lib/cgi-bin.

7. It needs to pick the correct owner and group and permissions for these two files.

Oddmuse:Creole Markup Extension

Does anybody feel like using WiX to build an MSI file for Windows users?

WiX

​#Oddmuse