----------------
GENERAL README
----------------
The content here is meant to work on Greenstone 3 (not Greenstone 2), and has been tested with version Greenstone 3.09, but is likely to work with later versions of Greenstone 3.

1. Download Greenstone 3.09 or later from http://www.greenstone.org/download
Greenstone is available for Windows, Linux and Mac.

IMPORTANT NOTE 1: 2 custom scripts have been written to "pre-prepare" the content to go into the Education Department's "Science Activities" and "Maths Activities" Greenstone collections. These scripts are WINDOWS-SPECIFIC. Although they're not a part of Greenstone and not necessary, they were created to automatically assign useful hierarchical metadata to your documents for readily browsing by such a hierarchical structure in Greenstone.
NOTE 2: Moreover, the custom script for the "Maths Activities" can be easily reused to create further collections that are similar. The instructions for doing so are within the README file of the "TC4.12_Math Resources_Activities" folder. (But first finish reading these instructions here in this file.)

You can always use a Windows machine to make use of the custom scripts, and then transfer the content produced into a Greenstone 3 installation on Mac and Linux machines. So other than using the custom scripts to prepare content for your Greenstone collections, you are not in any way bound to Windows machines. 

 If you don't want to use the custom Windows script for the Math collection to pre-prepare your content for Greenstone (which means you want to assign metadata to your documents manually through the Greenstone Librarian Interface/GLI) but if you still do want to use the custom "educationresources.mds" Greenstone Metadata Set that we've created, copy the file "WaikatoEducationDept/TC4.12_Math Resources_Activities/math.gs3coll/metadata/educationresources.mds" into your Greenstone 3 installation's gli/metadata folder.

2. Installing Greenstone mostly involves double clicking on the downloaded installer file and then repeatedly clicking Next and then finish in the installer dialog.
For more detailed instructions on installation, see http://wiki.greenstone.org/doku.php?id=en:release:3.09_release_notes#installing_and_running_the_binary_release

3. Finally,
- copy the siteConfig.xml file that exists at this level into your Greenstone 3 installation's web/sites/localsite folder.
- also copy the ijpg.gif file into your Greenstone 3 installation's web/interfaces/default/images folder

4. Proceed to reading the README instructions in 
- WaikatoEducationDept/TC4.12_Math Resources_Activities/README.txt: if you want to recreate from scratch OR rebuild the Maths Activities collection or create your own collection that works similarly.
- WaikatoEducationDept/TT4.02_Science Resources_Crates/README.txt: if you specifically want to recreate from scratch OR just rebuild the Science Activities collection.

5. For more information on Greenstone 3:
- Go through the very helpful Greenstone 3 tutorials at http://wiki.greenstone.org/doku.php?id=en:tutorials (Make sure to select the Greenstone 3 tab near the top of that page)
- Peruse the information organised in the Greenstone wiki at http://wiki.greenstone.org/
(searching the site using Google is more powerful than the wiki's own search feature)
- You can also join the greenstone-users mailing list to ask Greenstone questions, see http://wiki.greenstone.org/doku.php?id=en:support#central_english_mailing_lists
The Waikato University Education department staff are also welcome to write to us directly, if that's preferred, at greenstone_team@cs.waikato.ac.nz