.. _home:

OpenEdition OAI-PMH repository Documentation 
============================================

.. image:: _static/openedition.png

The OpenEdition OAI-PMH repository provides metadata of the documents published on `OpenEdition Books <https://books.openedition.org>`_, `OpenEdition Journals <https://journals.openedition.org>`_, `Hypotheses <https://hypotheses.org>`_, and `Calenda <http://calenda.org>`_.


.. note::

    The current version of the OAI-PMH repository is available at 

    https://metadata.openedition.org/oai

    A brief description of the repository is available at :ref:`OAI v2 / Main principles <main_principles_v2>`.

    **Current Release: 2.1.3** (see :ref:`changelog`)


.. warning::

    From november 2024, the previous version (1) of OpenEdition OAI-PMH repository, available at https://oai.openedition.org is deprecated.

    **It will be removed in june 2025.**

    Harvesters who still need to use the openedition depots should upgrade to the current version. Need help? referencement@openedition.org

The OpenEdition OAI-PMH repository uses the version 2.0 of the OAI-PMH protocol. 

This documentation describes the specific elements related to OpenEdition but does not include the usual recommendations of the OAI-PMH protocol (available on the Open Archives Initiative website: http://www.openarchives.org/OAI/openarchivesprotocol.html).


.. toctree::
   :maxdepth: 2
   :caption: OAI-PMH v2

   main_principles_v2
   harvesters_update
   available_formats_v2
   sets_v2
   types_v2
   oai_dc_v2
   oai_openaire_v2
   mods_v2
   mets_v2
 

.. toctree::
   :maxdepth: 2
   :caption: OAI-PMH v1 | DEPRECATED

   harvesting
   faq
   availableFormats
   sets
   types
   oai_dc
   qdc
   mets
   validation

.. toctree::
   :maxdepth: 2
   :caption: About 

   openedition
   license
   help
   changelog