source: main/trunk/model-sites-dev/WaikatoEducationDept/TT4.02_Science Resources_Crates/README.txt@ 33673

--------------------
  README
--------------------

Obtain the TT4.02 Science Resources Crates content from the Uni of Waikato Education Department. We do not have the permission to distribute it or make it public.
But assuming the Education Dept. has given this content you in a zip format, follow the instructions below.

1. Extract the TT4.02_Science Resources_Crates.zip, which will create a folder called TT4.02_Science Resources_Crates.zip
For example, extract it on the Desktop and your Windows desktop will now have a new folder TT4.02_Science Resources_Crates.

2. Next, move the files procCrates.bat and all 14 of the .csv files (A-1 to F-2) into the new TT4.02_Science Resources_Crates folder

3. Move the "sciencea.gs3coll" folder into your Greenstone 3.09rc1 installation's "web\sites\localsite\collect" folder.

4. Move the siteConfig.xml file  into your Greenstone 3.09rc1 installation's "web\sites\localsite" folder, thereby replacing the existing file there.

5. Start your Greenstone's installation's "Greenstone Server" application. Pressing this application's "Enter Library" button should open your default browser on your Greenstone DL home page. Visit your new Science Activities collection, as it's prebuilt.

--------------------
TO REGENERATE THE MATERIALS FOR YOUR COLLECTION AND TO REBUILD THAT COLLECTION:
4. ONLY if you ever want to REGENERATE the folders for ingesting into GS3 your crate folders, PDF/Word files and metadata, then:

In our example, your extracted TT4.02_Science Resources_Crates was on the Desktop, e.g. C:\Liang\Desktop\TT4.02_Science Resources_Crates
Whatever the actual location, remember it and use it in the following. I will stick with the example of C:\Liang\Desktop\TT4.02_Science Resources_Crates

a. Open a DOS prompt:
    first hold down the Windows key on the keyboard (located between Alt and Ctrl keys) and press the R key (R for run);
    then a little dialog will pop up. Type "cmd" into its edit field and press enter and a DOS prompt will appear.

In the DOS prompt, type:
    cd C:\Liang\Desktop\TT4.02_Science Resources_Crates
(i.e. "cd" followed by the full path to the actual location of your extracted folder)

b. type:
    procCrates.bat
    
c. Wait until it finishes. It should have created a folder called "import" in C:\Liang\Desktop\TT4.02_Science Resources_Crates.

d. ONLY if you now want to reingest and rebuild your collection with these new folders, use a file browser to do the following:
- Delete all but the top-level metadata.xml file in your Greenstone 3.09 (rc1) installation's "web\sites\localsite\collect\sciencea\import" folder.
- Go into the "C:\Liang\Desktop\TT4.02_Science Resources_Crates\import" folder. You should see subfolders A-1 to F-2.
- MOVE all these into your Greenstone 3.09 (rc1) installation's "web\sites\localsite\collect\sciencea\import" folder, where you should already have the old solitary metadata.xml file at this level.

e. Run the GLI/Greenstone Librarian Interface application of your installed Greenstone.
In GLI, select File > Open. Choose your "Science Activities (sciencea)" collection.
When this finishes opening, click on the Create tab in GLI.
Find the Build Collection button at the bottom and press it. This can take a long time, maybe 15 mins or more. Eventually it will finish building and you can press the Preview button also at the bottom of the Create pane to have it open a browser for you and show you the finished collection.

--------------------
INFORMATION:
- I exported each crate's .csv file individually from Excel (by default it exports in ASCII encoding format, so I left it as such and let procCrates.bat below deal with this).
I did this by opening the "Crates (TT4.02).xlsx" file that was in the TT4.02_Science Resources_Crates.zip downloaded from your Google drive. Then I clicked on each sheet and did Save As > *.csv (the most basic CSV option).

- the procCrates.bat now processes each crate's csv file and outputs additional metadata from before.
In processing each csv file, it simplifies the Activity Name (handles &, ", ', etc) to make it more compatible as metadata for Greenstone.
NOTE: I have had to change / (forward slash) to ; (semi-colon) as the / is used as a hierarchy separator by the browsing classifier code.

- I've modified the Education Resources metadata set to have an extra field called CrateHierarchy, which makes it easier to produce the book nodes.
The educationresources.mds (metadata set file) lives inside your web\sites\localsite\collect\sciencea\metadata folder. You can copy it into gli\metadata to re-use it for other collections.
- I've modified web\sites\localsite\siteConfig.xml with a single additional line to have a word icon for docx files too (not just for the old .doc files). The additional line is:
    <replace macro="_icondocx_" scope="metadata" text="&lt;img src='interfaces/default/images/imsword.gif' border='0'/&gt;" resolve="false"/>

- In GLI's Design tab, I configured the plugins used to build your collection, and set up the search indexes and browsing classifiers that should be available:
    only one search Index on ActivityName, as you requested
    and one browsing classifier that works with the newly introduced er.CrateHierarchy metadata
- I used GLI's Format tab to set up the display of the search results and browsing classifier content.
Basically, when you BROWSE to an activity, under the activity name you will see its document(s). For each document: you get an icon linked to the HTML version of each document (produced by Greenstone), an appropriate icon linking to the original document format (PDF or docx) and the FILENAME of the document, since the activity name of the browser is what the filename is found under.
When you SEARCH for an activity name or part of an activity name, you once more get the HTML doc icon and source doc icon but this is then further followed by the ACTIVITY NAME and then the filename in brackets.

Based on the changes made to GLI's Design and Format panels, a customised collectionConfig.xml is generated for this collection. When you create future collections through GLI, you can use "Base collection on" option in GLI's New Collection dialog to base those future collections on the design and formatting of this collection (make sure you assign the same metadata). Making this choice in GLI will automatically reuse the same collectionConfig.xml, inheriting all its configurations. The new collection thus created will also get to use the same metadata sets, including the custom one we prepared, "educationresources.mds".

So all the hard work here went into procCrates.bat and into setting up the collection's configuration, which produced collectionConfig.xml.

--------------------
BEWARE:
Beware not to change the encoding of procCrates.bat from ASCII to UTF-8 or other encodings. If you wish to edit this file, open it in Notepad++ and leave it's encoding in ASCII.

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------