Greenstone Wiki - en:user

authentication

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Authentication in Greenstone The Greenstone software comes equipped with an authentication system. Users can "Register" in the system, and can then access protected parts of the library, such as remote collection editing, online document editing (greenstone 3) and protected collections.

berry_baskets

Anonymous (anonymous@undisclosed.example.com) — 2023-07-24T01:44:38+00:00

Favourites/Berry Baskets (Greenstone 3) [ This version is for 3.10 and earlier. For 3.11 and later versions, please see our Favourites page. ] A favourites/berry basket functionality has been implemented in Greenstone 3. This allows the user to collect up a set of interesting or useful documents as she is browsing through the library. Once they are finished, they can view the basket of links, and email it to themselves.

browsing

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Browsing classifiers Greenstone allows you to create multiple browsing indexes for users to interact with your collection. Browsing classifiers are used to create a collection's browsing indexes. The come in many different types and can be based on any metadata field(s) you select. By default, a collection's navigation bar will include a button for each classifier that you define.

collection_grouping

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Collection Grouping By default, the Greenstone home page will display a grid of all valid collections. This can get quite crowded if there are a number of collections. "Collection groups" enables collections to be grouped into a subset with only one icon/link on the home page. Clicking the Group icon takes you to a group 'about page', which displays all the collections in that group.

collection_specific_macros

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Collection Specific Macros Collection specific macro files go into collect//macros, and are used instead of the system ones. The Collection Specific Macros section of the Format view allows you to add/modify macros specifically for the current collection. By default, the text on this page looks like this:

collections

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Collections Greenstone3/web/sites/localsite/collect Greenstone/collect * For information on using GLI to create, load, save and delete collections, please see this page. * Information about transferring collections between different Greenstone installations, including from Greenstone 2 to Greenstone 3, can be found

configuration_files

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone Configuration Files There are several important files in your Greenstone installation that you can use to configure certain settings. This page provides an overview of some of the important configuration files, where they are located, and a description of their function. There are also some sample collection configuration files, which can be useful when configuring your own collection.

document_types

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Document Types Greenstone can process a wide array of document types. The table below provides information about document types, their file extensions, the Greenstone plugin(s) that can process these file types, and any additional information about the document type in relation to Greenstone.

download

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Download Greenstone allows you to download files from the internet using a variety of protocols: * Web: downloads web pages and files via HTTP and FTP. * MediaWiki: downloads web pages and files via HTTP from a MediaWiki website. * OAI: downloads metadata records (and optionally documents) from an

example_collections

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Example Collections The New Zealand Digital Library provides many example collections, including historical documents, humanitarian and development information, technical reports and bibliographies, literary works, and magazines. The examples page at greenstone.org lists many Greenstone collections, from all around the world.

expanding_on_gs3_customisation_tutorials

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Expanding on the GS3 Customisation tutorials This wiki explains how to introduce support for other Greenstone 3 features into the custom perrin interface created by following the Greenstone 3 tutorial series on Designing a new interface. Displaying collection groups If you have edited web/sites//groupConfig.xml

exporting_collections

Anonymous (anonymous@undisclosed.example.com) — 2025-08-07T23:59:52+00:00

Exporting collections Greenstone 2 can export collections to CD/DVD-ROMs. NOTE: Collections with Lucene as indexer and/or JDBM as database type won't work with Greenstone 2 collections exported to CD-ROM. Lucene and JDBM work with Java and Java is not part of the export, so searching (lucene) and browsing (jdbm) won't work.

favourites

Anonymous (anonymous@undisclosed.example.com) — 2025-10-03T00:55:56+00:00

Greenstone 3 Favourites [ This page documents favourites for Greenstone 3 version 3.11 and later. For 3.10 and earlier versions, please see our Berry Baskets page. ] The favourites functionality allows the user to collect up a set of interesting or useful documents as she is browsing through the library. Once they are finished, they can view the basket of links, and email it to themselves.

greenstone_server

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

The Greenstone Server The server is what allows your Greenstone library to be viewed in a web browser. As the server included with Greenstone is ready to run out of the box you will likely have little reason to worry about it while you are building and customizing your Greenstone library.

gs2_customization

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 2 Customization Here are some tips for how to do various Greenstone 2 customizations. Changing the library logo Put your new logo image into greenstone2/web/images. Then modify greenstone2/macros/home.dm, replacing all instances of "gsdlhead.gif" with the name of your logo image file.

gs2_format_statements

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 2 Formatting Site-wide formatting options These should be placed in greenstone2/etc/main.cfg. Syntax: SiteFormat

ItemDescriptionHomePageCols intSet the number of columns used to display collections on the home page. Default: 3

gs2_or_gs3

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone2 or Greenstone3 Greenstone3 is a complete redesign and reimplementation of the original Greenstone digital library software (Greenstone2). In general, we recommend using Greenstone3, however, in some circumstances Greenstone2 may be more suitable for your needs. The sections below present the advantages and disadvantages of the current distribution of Greenstone3 compared to Greenstone2.

gs2_sample_format_statements

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Sample Greenstone 2 format statements Here are some ideas on how to do some specific formatting tasks. Hyperlink individual metadata elements [contributed by Axel Schild] When a metadata element has only one value, it is easy to make a hyperlink out of the value. In the format statement, you just put an

gs2_to_gs3

Anonymous (anonymous@undisclosed.example.com) — 2026-04-30T02:33:24+00:00

Converting Greenstone 2 collections to Greenstone 3 While the indexes and databases of a Greenstone 3 collection are the same as for a Greenstone 2 version, the configuration files are very different. A Greenstone 2 collection doesn't need to be rebuilt to work in Greenstone 3, but the two configuration files, etc/collect.cfg and index/build.cfg need to be converted to their Greenstone 3 equivalents etc/collectionConfig.xml and index/buildConfig.xml.

gs2_urls

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone2 URLs Actions and Arguments CGI arguments encode the parameters of each page, for instance, what kind of page to display, what query to carry out etc. This page describes the common actions and arguments used by the Greenstone library server.

gs3_collection_configuration_files

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

GS3 Collection Configuration Files in Detail collectionConfig.xml If you would like to change the defaults for some of the library cgi parameters, you can use . For example, we would like the Maori Newspaper Collection to load in Maori, even though the library home page is set to English. To do this, we need to set the language cgi argument (l) to Maori (mi).

gs3_format_statements

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T20:54:47+00:00

Greenstone 3 Format Statements Greenstone3 uses XSL to dynamically generate all of the pages in your library. This provides a way to present different content in a consistent way. Format statements are a way to customize the look of a collection/library

gs3_list_of_format_options

Anonymous (anonymous@undisclosed.example.com) — 2026-04-29T00:42:44+00:00

List of Greenstone3 Format Items This page describes all the things that can go into the element in the collectionConfig.xml file - or can be added in the Format->FormatFeatures pane in GLI. Format items include options, parameter defaults, and templates. Templates can include standard XSL, but we have defined a set of gsf elements which are shortcuts to XSL.

gs3_sample_format_statements

Anonymous (anonymous@undisclosed.example.com) — 2024-07-05T01:00:52+00:00

Sample Greenstone3 Format Statements This page provides examples of format statements for miscellaneous things. See also * Greenstone 3 Format Statements * List of Greenstone3 Format Options * Some sample interface modifications Document Display Linking to Abstract and Commentaries

index

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

User Guide This section of the wiki is aimed at the collection builder, and goes beyond the basics covered by the Beginner Guide. You may also like to look at the Advanced User Guide which is aimed as system administrators, and covers tasks beyond the normal ones of running GLI and building collections. Other advanced information can be found in the

interfaces

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Customizing the Greenstone 3 interface Format statements in the collection configuration files provide a way to change small parts of the collection display. For large scale customizations to a collection, or ones that apply to a site as a whole, a second mechanism is available. The interface is defined by a set of XSLT files that transform the page data into

language_considerations

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Language Considerations When creating collections of documents in some languages, certain technical issues should be considered to ensure optimal searching and browsing capabilities for users. Searching Arabic OCR text Because Arabic is a cursive script, it requires a different character set when displaying it on the screen; characters look different depending on ehether the character appears at the start, middle or end of the word.

list_of_configuration_file_options

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

List of Greenstone 2 collect.cfg file options This page gives options available to the Greenstone 2 collection configuration file collect.cfg. This file is generated by GLI, however, if you are doing command line building you may want to edit it manually. Also, a few options here are not available through GLI.

macros

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 2 Macros Macros define either strings on the interface or variables utilized in C++ codes. By using macros, users can easily customize the user interface without changing any C++ code. The entire Greenstone user interface is controlled by macros which reside in the

map_view

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Enabling a map view In greenstone 3, if your documents or images have GPS metadata then you can add in a Google maps feature which will plot the documents on the map. Please see the Image Collection with GPS metadata tutorial for details. There are a few configuration settings missing from the tutorial (as at July 2017). Here is a summary of steps to follow:

metadata_sets

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Metadata sets All metadata fields in Greenstone belong to a metadata set, which is simply a pre-defined collection of metadata fields. Because sets will often have metadata fields with the same name (for instance, most sets will have a 'Title' field),

metadata

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Metadata in Greenstone Metadata is data about data. In Greenstone this is information about the documents, that may be separate from the content of the document -- typically title, author, creation date, and so on. Adding metadata to documents is an extremely important part of building digital collections. Metadata can help users navigate collections and find the information/documents they need. Metadata can also provide important contextual and provenance information about documents. This sec…

partition_indexes

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Partition Indexes Indexes are built on particular text or metadata sources. The search space can be further controlled by partitioning the indexes, either by language or by a predetermined filter. Partition indexes can be set in the "Partition Indexes" section under the Design panel.

plugins

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Plugins When building collections, Greenstone processes each different format of source document by seeking a “plugin” that can deal with that particular format. Plugins are specified in the collection configuration file. Greenstone generally uses the filename to determine document formats—for example,

rss

Anonymous (anonymous@undisclosed.example.com) — 2025-08-04T02:06:08+00:00

RSS RSS technology allows you to syndicate your collection's content, so users who subscribe to your site will be informed of new content in their RSS/News Feeds. If you will be frequently adding new content to a collection, consider enabling RSS. This will allow your users to 'subscribe' to the collection, and keep track of updates.

sample_macros

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Sample Macros Adding a new page to a Greenstone library Adding a new static page to Greenstone is relatively simple and involves only customizations to macro files (found in gsdl/macros). (Adding a dynamic page is more difficult and involves adding a new action to the C++ receptionist.)

searching

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Searching In Greenstone, you can dictate how users will be able to search each collection. You can select defferent indexers to determine how documents are indexed, and you can create indexes based on any number of metadata fields and the text of the documents.

sites

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 3 Sites In Greenstone3, sites hold all of the content of your digital library. They are basically collections of collections, and your Greenstone installation can have multiple sites. By default, the site homepage links to all of the collections in the site. So, if you have multiple sites, only the collections within each site will appear on their respective homepages.

the_collector

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

The Greenstone 2 Collector The Collector is a deprecated facility for creating collections. The Collector is a facility that helps you create new collections, modify or add to existing ones, or delete collections. To do this you will be guided through a sequence of web pages which request the information that is needed. The sequence is self-explanatory: this section takes you through it. As an alternative to using the Collector, you can also build collections from the

the_depositor

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

The Depositor * You must have already created the collection via the Librarian's Interface or command line scripts. The depositor is used for adding new material to an existing collection, not creating a new collection or configuring one. The collection should be built at least once before using the Depositor for it, even if it has no content yet.

themes

Anonymous (anonymous@undisclosed.example.com) — 2024-09-16T00:58:32+00:00

Greenstone 3 Themes The default Greenstone3 interface is built on JQuery themes. This makes it very easy to change the colors of your Greenstone libraries and collections, as well as other select parts of the style (like corner roundness). This page discusses how to create your own themes, and how to change the theme for either the whole library or an individual collection.

transferring_collections

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Transferring Collections between Greenstone Installations This page provides information on where collections are stored in your Greenstone installation, as well as information on moving collections from one installation to another (including from Greenstone2 to Greenstone3).

user_comments

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Enabling user comments Greenstone 2 and 3 both support allowing users to add comments to individual documents. A user merely needs to have an account on that Greenstone DL in order to leave comments on any accessible document, and need not have collection editing permissions on that or any collection.