Bauble 
============

**********
WARNING:  This file is terribly out of date and most like not very accurate.
**********


At it's heart Bauble is a framework for creating database applications.  In
it's distributed form Bauble is an application to manage plant records and 
specifically living collections.  It is used by Belize Botanic Gardens to 
manage their live collections.  Included by default is RBG Kew's Family and 
Genera list from Vascular Plant Families and Genera compiled by R. K. Brummitt
and published by the Royal Botanic Gardens, Kew in 1992 used by permission 
from RBG Kew.

All code contained as part of the Buable package is licenced under the GNU GPL.



Requirements:
-------------
Bauble requires the following packages to run.  The installer for Windows comes 
with everything already built in except for GTK+ and the optional XSL->PDF 
renderer which is need to use the formatter plugin.

Python 2.4 (not tested with other versions but they may work as well)
SQLAlchemy>=0.5.0
pygtk>=2.12
lxml>=2.0
At least one of the following database connectors:
    pysqlite >= 2.3.2
	psycopg2 >= 2.0.5 
    mysql-python >= 1.2.1 

To use the formatter plugin you will also need to install an XSL->PDF renderer. For
a free renderer check out Apache FOP (>=.92beta) at 
http://xmlgraphics.apache.org/fop/


Installation:
-------------

	Linux
	-----
	1. Download one of the Bauble archives 
	   from http://bauble.belizebotanic.org.
	2. Extract the archive to a directory.
	3. Change to the Bauble directory where you extract the archive.
	4. Type "python setup.py install" on the command line
	5. To run Bauble type bauble on the command line.
	
	Windows
	-------
	1. Download the bauble-<version>-.exe file from 
	   http://bauble.belizebotanic.org
	2. Double click on the file when it finishes downloading.
	3. Run Bauble from the Start menu.
