1 | ----------------
|
---|
2 | GENERAL README
|
---|
3 | ----------------
|
---|
4 | 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.
|
---|
5 |
|
---|
6 | If you prefer, you can ask your department's tech-support to install Greenstone for you. Nevertheless, you'll want to read through these instructions once yourself, as there may be points to bear in mind to notify tech support about.
|
---|
7 |
|
---|
8 | 1. Download Greenstone 3.09 or later from http://www.greenstone.org/download
|
---|
9 | Greenstone is available for Windows, Linux and Mac.
|
---|
10 |
|
---|
11 | 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.
|
---|
12 | 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 in the README-maths-activities.txt. (But first finish reading these instructions here in this file.)
|
---|
13 |
|
---|
14 | 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.
|
---|
15 |
|
---|
16 | 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 "waikato-edu/collect/maths-activities/metadata/educationresources.mds" into your Greenstone 3 installation's gli/metadata folder.
|
---|
17 |
|
---|
18 | 2. Installing Greenstone mostly involves double clicking on the downloaded installer file and then repeatedly clicking Next and then finish in the installer dialog.
|
---|
19 | 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
|
---|
20 |
|
---|
21 | 3. Finally, grab a copy of the waikato-edu.zip file, the "waikato-edu" Greenstone site containing the 2 Greenstone collections "maths-activities" and science-activities" from http://trac.greenstone.org/browser/main/trunk/model-sites-dev/waikato-edu
|
---|
22 | Unzip this zip file into your Greenstone 3 installation's web/sites folder.
|
---|
23 |
|
---|
24 | 4. The zipped file contains a Greenstone 3 "site" we've prepared called "waikato-edu", which is customised for the education department's Maths and Science Activity materials.
|
---|
25 | In order to make this Greenstone site the default site, you need to do 2 things:
|
---|
26 |
|
---|
27 | a. Use a text editor to open the file servlets.xml located in your Greenstone 3 installation's web/WEB-INF/servlets.xml file.
|
---|
28 | In the text editor, locate the following text (which tends to be at the start of the file):
|
---|
29 | <servlet>
|
---|
30 | <servlet-name>library</servlet-name>
|
---|
31 | <description>The standard gsdl3 library program</description>
|
---|
32 | <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
|
---|
33 | <init-param>
|
---|
34 | <param-name>library_name</param-name>
|
---|
35 | <param-value>library</param-value>
|
---|
36 | </init-param>
|
---|
37 | <init-param>
|
---|
38 | <param-name>site_name</param-name>
|
---|
39 | <param-value>localsite</param-value> <-------------- YOU'RE GOING TO BE CHANGING THIS LINE BELOW
|
---|
40 | </init-param>
|
---|
41 |
|
---|
42 | Change the 2nd to last line in the above (the line indicated) to refer to the custom "waikato-edu" site instead of the default "localsite", so it looks like:
|
---|
43 | <servlet>
|
---|
44 | <servlet-name>library</servlet-name>
|
---|
45 | <description>The standard gsdl3 library program</description>
|
---|
46 | <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
|
---|
47 | <init-param>
|
---|
48 | <param-name>library_name</param-name>
|
---|
49 | <param-value>library</param-value>
|
---|
50 | </init-param>
|
---|
51 | <init-param>
|
---|
52 | <param-name>site_name</param-name>
|
---|
53 | <param-value>waikato-edu</param-value>
|
---|
54 | </init-param>
|
---|
55 |
|
---|
56 | Save the file in the text editor and close it.
|
---|
57 |
|
---|
58 | Essentially, this is a quick fix to maming use of the existing default look of Greenstone 3 to present all the collections in the custom "waikato-edu" site. At present the site contains the 2 collections "maths-activities" and "science-activities".
|
---|
59 |
|
---|
60 | The details and reasons for making the change above don't matter at this stage, but if you're interested, the ideas behind it are discussed and explained in the Greenstone 3 tutorial at http://files.greenstone.org/tutorial/gs3-current/en/defining_libraries.htm
|
---|
61 |
|
---|
62 |
|
---|
63 | b. The next change to make is that the first time you run the Greenstone Librarian Interface, GLI, the first thing you need to do is to go into File > Preferences menu and select the "Connection" tab. For the "Site" field, select "waikato-edu" in its drop down.
|
---|
64 | You can then quit GLI by pressing the X button to the top right of GLI's window. (Always close Greenstone applications this way.)
|
---|
65 |
|
---|
66 | Making the above change will allow you to immediately see and open collections available in the "waikato-edu" site.
|
---|
67 |
|
---|
68 | 5. Proceed to reading the README instructions located in the unzipped contents:
|
---|
69 | - waikato-edu/README-maths-activities.txt: if you want to recreate from scratch OR rebuild the maths-activities collection or create your own collection that works similarly.
|
---|
70 | - waikato-edu/README-science-activities.txt: if you specifically want to recreate from scratch OR just rebuild the science-activities collection.
|
---|
71 |
|
---|
72 | 6. For more information on Greenstone 3:
|
---|
73 | - 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)
|
---|
74 | - Peruse the information organised in the Greenstone wiki at http://wiki.greenstone.org/
|
---|
75 | (searching the site using Google is more powerful than the wiki's own search feature)
|
---|
76 | - 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
|
---|
77 |
|
---|