HOW TO SETUP PIMKI 2.alpha (aka the zombie release)
===================================================

1. Make sure you have Ruby installed

Preferably Ruby 1.8.4. There are possible issues with the 1.8.2 builtin version on Macs.


2. Get the source

Checkout the sources directly from Subversion via:
  svn checkout svn://rubyforge.org//var/svn/pimki/branches/pimki_2_zombie

Or get an occasionally updated snapshot from:
  http://pimki.rubyforge.org/pimki-2.0.zip


3. Install the dependencies

gem install rails --version 1.0.0
gem install RedCloth --version 3.0.3
gem install BlueCloth rubyzip madeleine

Please note that case sensitivity matters in the gem commands above.


4. Start the service

Go to the Pimki source directory and run pimki.rb. Alternatively, look at the home page
(http://pimki.rubyforge.org) on how to set it up as a service.


IMPORTANT NOTES
===============

* This version still uses Madeleine, not SQLite. It is an interim version with some
of the features from Pimki2 that is stable enough to be used until the trunk (based
on SQLite) will be released.

* The binary format for snapshots is not compatible between 1.x and this version. If you
want to upgrade an existing instance, first export the web as markup, then run
Pimki2 with a _different_ storage directory. Create the system and the first web,
go to the "Web Setup" page and towards the bottom is the option to import a previously
exported web. Just point it at the export zip and you should be good to go.

* This version also has a known issue where it will render all pages on startup (needed
to calculate the todo items). This means that the _first_ page you load after starting
the service will take a few _minutes_ to load. Further pages should be OK.

* There's a new help section (named "Don't panic" on the navbar :). It covers some
of the new features. Give it a whirl.

* Hyperbolic maps are cool - you should really try installing GraphViz.

* Email me (direct or on the pimki-users mailing list) for more help.