You can group collections in Grenstone 3. This can clean up the home page if you have a lot of collections, as a group will have a single icon on the home page. CLicking it takes you to a home page for the group: only those collection in the group will be displayed here.
Grouping is controlled by the groupConfig.xml file, found in a site folder alongside the siteConfig.xml file. For example, in /home/user/greenstone3/web/sites/localsite/groupConfig.xml.
By default, there are no groups.
Add hierarchy and groupDescriptions elements to add groups to your library.
Describe your structure inside a hierarchy tag as shown in the examples below.
Hierarchys can contain groups and/or collections. Groups can contain other groups and/or collections. The order they are listed is the order they will appear on the home page.
Describe your groups in groupDescriptions element as shown in the example below. Without a matching group element in groupDescriptions, a group will display its name.
If a collection is not mentioned in the hierarchy or as part of a group it will be listed on the main home page after the specified groups and collections.
Example 1: this example puts a few Greenstone demo collections into some groups. The home page will display the demo group plus any unlisted collections. The demo group home page will display its two subgroups; their home pages will display their list of collections.
<groupConfig>
<hierarchy>
<group name="demo">
<group name="standard">
<collection name="solr-jdbm-demo" />
<collection name="lucene-jdbm-demo" />
</group>
<group name="dec">
<collection name="bibtex-e"/>
<collection name="dls-e"/>
<collection name="garish-e"/>
<collection name="isis-e"/>
</group>
</group>
</hierarchy>
<groupDescriptions>
<group name="demo">
<title>Demo Collections</title>
<description>Collections for demonstration purposes, provided by the Greenstone project.</description>
<shortDescription>Greenstone demonstration collections</shortDescription>
<backgroundImage>/images/Group3.jpg</backgroundImage>
</group>
<group name="standard">
<title>Standard Demos</title>
<description>These collections are the standard demonstration collections that come with a Greenstone binary release.</description>
<shortDescription>Demonstration collections that come with the Greenstone binary.</shortDescription>
</group>
<group name="dec">
<title>Documented Example Collections</title>
<description>These documented example collections describe how they are constructed on their about page. Useful for learning about different Greenstone features.</description>
<shortDescription>Collections that describe how they were built.</shortDescription>
</group>
</groupDescriptions>
</groupConfig>
Example 2: If you want to put your collections into a specific order, you can list them in the hierarchy. Any unmentioned collections will be listed at the end. This example has no groups, but is a way of specifying which order you want the collections to appear on the home page.
<groupConfig>
<hierarchy>
<collection name="solr-jdbm-demo"/>
<collection name="lucene-jdbm-demo"/>
<collection name="paradise-gardens"/>
</hierarchy>
</groupConfig>