From WorldForgeWiki

Contents 1 Installing WOMBAT 1.1 Common Issues 2 Using WOMBAT 2.1 Browse For Artwork

Installing WOMBAT

This instruction assumes you already have Pylons set up. A good way to do it is to follow the Pylons install instructions. I use a setup like that for the demo site.

After you installed Pylons, get the release as descibed above and do the following:

$ easy_install SQLALchemy
$ easy_install wombat-0.4.3-py2.5.egg            # or whatever version of wombat you want to use
$ paster make-config wombat wombat.ini

This will create a configuration file called ***wombat.ini*** in the current directory. Edit that to make sure all the settings you want are active. Now, create the initial database.

$ paster setup-app wombat.ini

Then, get a checkout of the media repo.

$ svn co https://svn.worldforge.org:886/svn/media/trunk media

Now, let's give WOMBAT a try while still noticing errors early

$ paster serve wombat.ini

This will run WOMBAT while logging to stdout. Now you can point your browser at whichever port you configured in wombat.ini and use the site. If you're happy and want to run it without having to keep the console attached, Ctrl-C out of the current server and run paster with the --daemon option.

$ paster serve --daemon wombat.ini

Now direct your browser to the WOMBAT page and trigger a scan. Depending on the speed of your internet connetion, this can take quite some time, as getting the revision information requires contacting the SVN server.

Common Issues

Some distributions (like Ubuntu 9.04 and newer) seem to install python add-ons in /usr/lib/python2.6/dist-packages instead of .../site-packages, which the current go_pylons.py script doesn't seem to get. You will have to go into your pylons lib/python2.6/site-packages directory and manually create links to PIL and pysvn.

$ ln -s /usr/lib/python2.6/dist-packages/PIL
$ ln -s /usr/lib/python2.6/dist-packages/PIL.pth
$ ln -s /usr/lib/python2.6/dist-packages/pysvn

I hope this gets fixed in the pylons installer in the near future.

Using WOMBAT

WOMBAT is designed to be easy to use without having to read a lot of documentation, so we'll just cover some example use cases here. If you run into anything that is unclear, feel free to file a bug.

Browse For Artwork

Depending on your browsing habits, you can pick your favorite approach when browsing. I personally prefer the directory view, so let's cover that first.

As shown on the left, the WOMBAT menu bar has a button labelled "Directories". Click that and you'll get the directory view of the media repository. From there you can browse the directory structure of the media repository same as if it was on your local disk.

If you prefer a more Web 2.0 method of browsing, click the "tag cloud" button as shown on the right. That will get you to the tag-based browsing. (As of version 0.4.4, this is not fully implemented yet.)