source: gsdl/trunk/etc/oai.cfg@ 18863

# OAI Server Configuration

# This is the main configuration file for configuring your Greenstone oai server.
# The server is a cgi program called oaiserver (oaiserver.exe on Windows).
# Some basic commands that you can send it are:
# ....cgi-bin/oaiserver.cgi?verb=Identify
# ....cgi-bin/oaiserver.cgi?verb=ListSets
# ....cgi-bin/oaiserver.cgi?verb=ListMetadataFormats
# ....cgi-bin/oaiserver.cgi?verb=ListIdentifiers&set=xxx (1.1 only)
# ....cgi-bin/oaiserver.cgi?verb=ListIdentifiers&set=xxx&metadataPrefix=oai_dc (2.0 only)
# ....cgi-bin/oaiserver.cgi?verb=ListRecords&set=xxx&metadataPrefix=oai_dc
# ....cgi-bin/oaiserver.cgi?verb=GetRecord&identifier=xxx&metadataPrefix=oai_dc

#The List verbs (ListSets, ListIdentifiers, ListRecords) all return a 
#sequence of items. The 'resumeafter' paramter below indicates how many 
#records to return - if this number is less than the number matching the 
#request, then a resumption token is returned. To use this to get the 
#next set of documents, you need to issue the same request again, with 
#an additional parameter: resumptionToken=xxx
#For example, 
# ....cgi-bin/oaiserver.cgi?verb=ListRecords&set=demo&metadataPrefix=oai_dc&resumptionToken=gsdloai:demo,,11-

# For more information about the OAI-PMH protocol, see 
# http://www.openarchives.org/

# Strings containing spaces should be enclosed in double quotes ""

#the baseURL used by the oaiserver
#Example: baseURL "http://your-domain-name/cgi-bin/oaiserver.cgi"
baseURL "your-own-baseURL-goes-here"

# the base address of gsdl directory
#Example: baseDocRoot "http://your-domain-name/gsdl"
baseDocRoot "your-own-base-document-root-goes-here"

# The OAI repository name - human readable
repositoryName ""

# The central administrative email address for the repository.
maintainer  ""

# Which version of OAI the repository supports, 1.1 or 2.0
# (The server supports both)
oaiversion "2.0"

# How many records to output before needing a resumption token
# A value of -1 will return all records for a request
resumeafter  -1

# Other free text items describing the repository. There is no restriction 
# on the number of items, or item names
# The format is like the following:
# oaiinfo "item name" "item value"
# Examples may include sponsor, purpose, size...

# A list of collections that should be made available to OAI clients. By
# default, collections are not available.
# There can be more than one line: each line must start with oaicollection, 
# and this is followed by one or more collection names. The collection name 
# is the name of the collection's folder in the collect directory.
oaicollection demo oai-e 

# Metadata mapping information. At present, Greenstone's OAI server only
# supports the Dublin Core metadata format. Metadata in other formats must 
# be mapped to Dublin Core. This can be done in this file, or for a 
# particular collection, in its collect.cfg file.

# The format is like
# oaimapping <greenstone fieldname> <oaifieldname>

# As Greenstone's OAI server only supports Dublin Core, the oai fieldnames 
# should be like dc.Title, dc.Subject etc.
# The Greenstone field names can be unqualified (Title, Subject) or 
# qualified by a namespace (dc.Title, dls.Subject). These mapping rules 
# will apply to the entire repository. Collection specific rules can also 
# be specified in this file using a collection name qualifier. This is 
# the collection name followed by a colon (demo:Title, demo:dls.Title). 
# Mappings specified in a collect.cfg file do not need the collection 
# qualifier.

# Details about the Dublin Core metadata format can be found at
# http://dublincore.org/
# Elements include Title, Creator, Subject, Description, Publisher, 
# Contributor, Date, Type, Format, Identifier, Source, Language, 
# Relation, Coverage, Rights

# mappings for the demo collection
oaimapping demo:dls.Title dc.title
oaimapping demo:dls.Subject dc.subject
oaimapping demo:dls.Language dc.language
oaimapping demo:dls.Organization dc.publisher