Editing Config Options by File (section)

== O ==

=== [[oai.pl]] ===
* '''oai''' - Configuration for OAI-PMH.
** '''v2'''
** '''archive_id''' - The ID to use for this repository archive for OAI-PMH.  (By default commented out, so will use primary hostname of the repository archive, i.e. <code>$c->{host}</code> otherwise <code>$c->{securehost}</code>).
*** '''base_url''' - The base URL for accessing OAI-PMH version 2.  (By default <code>/cgi/oai2</code>).
** '''sets''' - Sets to organise (live archive) items accessible over OAI-PMH.  (Default varies depending on flavour.  Zero only have sets for <code>subjects</code> and <code>type</code>.  pub_lib also has a <code>status</code> set based on value of <code>ispublished</code>.  Other possible sets commented out by default).
** '''custom_sets''' - More complex sets based on specific search expression.  (Default varies depending on flavour.  Zero has no custom sets enabled by default.  pub_lib has <code>Open Access DRIVERset</code> includes all (live archive) items that have <code>full_text_status</code> set to <code>public</code>.
** '''filters''' - Search expression to further filter results available through OAI-PMH, beyond being in the live archive.  E.g. only since 2003.  (By default no additional filters are applied).
** '''mime_types''' -  Maps eprints' document types to mime types if they are not the same.  (By default there are no mappings).
** '''content''' - Describes content of repository available through OAI-PMH. 
*** '''text''' - A text description of the content of repository. (Undefined by default).
*** '''url''' - A URL that points to a page describing the content of repository. (link to <code>/policies.html</code> by default).
** '''metadata_policy''' - Describes the metadata policy of the repository.
*** '''text''' - A text description of the metadata policy of the repository. (By default text explaining the metadata policy has not been defined).
*** '''url''' - A URL that points at a page describing the metadata policy of the repository. (Undefined by default).
** '''data_policy''' -  Describes the data policy of the repository.
*** '''text''' - A text description of the data policy of the repository. (By default text explaining the data policy has not been defined).
*** '''url''' - A URL that points at a page describing the data policy of the repository. (Undefined by default).
** '''submission_policy''' -  Describes the submission policy of the repository.
*** '''text''' - A text description of the submission policy of the repository.  (By default text explaining the submission policy has not been defined).
*** '''url''' - A URL that points at a page describing the submission policy of the repository. (Undefined by default).
** '''comments''' - Any additional comments to add at the end of the OAI-PMH identify page.  (By default some text describing the version and origin of the EPrints software).

=== [[optional_filename_sanitise.pl]] ===
* '''optional_filename_sanitise''' - Defines a function that can further sanitise a filename (beyond <code>EPrints::System->sanitise</code>) of an uploaded file before is written to the filesystem / added to the database.  (By default commented out but has example for replacing one or more of spaces, parentheses and <code>@</code>s with underscores).