mods format

The mods format provides the following elements, according to Metadata Object Description Schema (MODS) 3.8.

1. mods:identifier

  • Identifier of the document. Repeatable with distinct types.

1.1. Handle

  • mods:identifier with attribute type="hdl" provides the Handle of the document.

  • Available for all records.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jsak&metadataPrefix=mods

1<mods:identifier type="hdl">20.500.13089/jsak</mods:identifier>

1.2. DOI

  • mods:identifier with attribute type="doi" provides the DOI of the document.

  • Available for all platforms.

  • Some records from OpenEdition Books and OpenEdition Journals may have no DOI.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jsak&metadataPrefix=mods

1<mods:identifier type="doi">10.4000/remi.5530</mods:identifier>

1.3. ISBN

  • mods:identifier with attribute type="eisbn" or type="pisbn" provides respectively the dig ital ISBN and print ISBN of the document.

  • Available for books (OpenEdition Books) and journals issues (OpenEdition Journals).

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/31o4&metadataPrefix=mods

1<mods:identifier type="eisbn" typeURI="http://id.loc.gov/vocabulary/identifiers/isbn">978-2-8218-7547-0</mods:identifier>
2<mods:identifier type="pisbn" typeURI="http://id.loc.gov/vocabulary/identifiers/isbn">978-3-86395-122-1</mods:identifier>

2. mods:location

  • mods:location/mods:url provides the URL of the document.

  • Available for all records.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/jsak&metadataPrefix=mods

1<mods:location>
2  <mods:url>https://journals.openedition.org/remi/5530</mods:url>
3</mods:location>

3. mods:title

  • mods:title without attribute provides the main Title of the document.

  • mods:subTitle without attribute provides the subtitle of the document.

  • mods:titleInfo[@type="translated"]/mods:title provides the translated titles of the document. The xml:lang attribute precise the language.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/gd0i&metadataPrefix=mods

1<mods:titleInfo>
2  <mods:title>Qu’est-ce que le travail quand on n’a pas d’emploi ?</mods:title>
3  <mods:subTitle>Le travail non salarié à l’aune des projections d’avenir des chômeurs</mods:subTitle>
4</mods:titleInfo>
5<mods:titleInfo type="translated">
6  <mods:title xml:lang="en">What’s work when you’re unemployed ? Non-wage work in the light of future projections for the unemployed</mods:title>
7  <mods:title xml:lang="de">Was ist Arbeit, wenn man keinen Arbeitsplatz hat ? Selbständige Arbeit, gemessen an den Zukunftsprojektionen von Arbeitssuchenden</mods:title>
8  <mods:title xml:lang="es">¿Qué es el trabajo cuando no se tiene empleo ? El trabajo no asalariado según las proyecciones de futuro de los desempleados</mods:title>
9</mods:titleInfo>

4. mods:name

  • Author, scientific and academic editor, archaeological project director, translator or other type of contributor. Repeatable.

  • Roles are defined using marcrelator reference: https://www.loc.gov/marc/relators/relaterm.html. Used terms are :

    • aut: Author

    • pbd: Publishing director

    • edt: Editor

    • trl: Translator

    • ctb: Contributor

    • orm: Organizer

  • For OpenEdition Journals, OpenEdition Books and Calenda, given name (mods:namePart[@type="given"]) and family name (mods:namePart[@type="family"]) are distincts.

  • For Hypotheses blog posts, there is no distinction.

Example of a book: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/31o8&metadataPrefix=mods

1<mods:name type="personal">
2  <mods:role>
3    <mods:roleTerm authority="marcrelator">aut</mods:roleTerm>
4  </mods:role>
5  <mods:namePart type="given">Stefan</mods:namePart>
6  <mods:namePart type="family">Groth</mods:namePart>
7</mods:name>

Example of a blog post: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11r1e&metadataPrefix=mods

1<mods:name type="personal">
2  <mods:role>
3    <mods:roleTerm authority="marcrelator">aut</mods:roleTerm>
4  </mods:role>
5  <mods:namePart>Olivier Jacquot</mods:namePart>
6</mods:name>

5. mods:typeOfResource

  • mods:typeOfResource with attribute authority="openedition" provides the document type according to the list of types available in this section: Document types.

  • mods:typeOfResource with attribute authorityURI="http://purl.org/coar/resource_type/" provides the document type according to the list of types available at http://purl.org/coar/resource_type/. ValueURI attribute precise the term URI.

  • Available for all records.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11r0i&metadataPrefix=mods

1<mods:typeOfResource authorityURI="http://purl.org/coar/resource_type/" valueURI="http://purl.org/coar/resource_type/c_18cf">text</mods:typeOfResource>
2<mods:typeOfResource authority="openedition">call for papers</mods:typeOfResource>

6. mods:language

  • Document language. Repeatable

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11r0i&metadataPrefix=mods

1<mods:language>
2  <mods:languageTerm type="code" authority="iso639-1">fr</mods:languageTerm>
3</mods:language>
4<mods:language>
5  <mods:languageTerm type="code" authority="iso639-1">en</mods:languageTerm>
6</mods:language>

7. mods:accessCondition (access rights)

  • Access right of the resource.

  • mods:accessCondition with attribute type="restriction on access" provides the access right of the document according to the list of types available at http://purl.org/coar/access_right/. ValueURI attribute precise the term URI.

  • Available for all records.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1i54&metadataPrefix=mods

1<mods:accessCondition type="restriction on access" auhorityURI="http://purl.org/coar/access_right/" valueURI="http://purl.org/coar/access_right/c_abf2">open access</mods:accessCondition>

8. mods:accessCondition (license)

  • mods:accessCondition with attribute type="license" provides the license of the document. When availabe (i.e. CC License), ValueURI attribute precise the license URI.

  • Available for all records.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/1i54&metadataPrefix=mods

1<mods:accessCondition type="license" valueURI="https://creativecommons.org/licenses/by-sa/4.0/">CC-BY-SA-4.0</mods:accessCondition>

9. mods:abstract

mods:abstract contains abstracts of the document if available, an excerpt (usualy the first lines) otherwise (attribute type="excerpt"). Abstacts may be available in several languages. In this case, and xml:lang attribute specifies the language of the description.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/l8zw&metadataPrefix=mods

1<mods:abstract xml:lang="fr">L’archipel des Marquises (Polynésie française) construit son projet de développement territorial, y figurent deux projets d’excellence : l’inscription de l’archipel sur la liste du patrimoine mondial de l’UNESCO et la création d’une aire marine protégée. Dans ce contexte, un programme de recherche partenarial et participatif portant sur le patrimoine lié à la mer aux Marquises (PALIMMA) a contribué à identifier les connaissances présentes dans la bibliographie et à construire des données avec la population. Il s’agissait de déterminer quels étaient les patrimoines liés à la mer pour les Marquisiens, les éventuelles menaces afférentes et les pistes de gestion. Au-delà de la production de connaissance, ce programme, porté par la société marquisienne, a participé à la construction des territoires, à renforcer la capacité des populations à intervenir dans les débats et à la construction de liens entre individus et institutions.</mods:abstract>
2<mods:abstract xml:lang="en">Marquesas islands archipelago aimes to built its territorial development project in particular thanks to become listed as a world heritage site by UNESCO and the establishment of a marine protected area. In this context, a research programme was carried out. It was a partenarial and partipatory research about maritime heritage in Marquesas (PALIMMA). The objectives were to identify knowledge in the bibliography and to built data with the population (what heritage, what threats and what managerial solutions). Beyond knowledge production, this research programme, with marquisian local community, showed how important it is in ordrer to reach a balanced territorial development, to foster the empowerment of local population and to build relationships between individuals and institutions. A research program like PALIMMA can help to aim those objectives.</mods:abstract>

10. mods:subject

  • mods:subject contains keywords. An xml:lang attribute specifies the language of the keyword.

  • Available for OpenEdition Journals and OpenEdition Books and Calenda.

Example: https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d85h&metadataPrefix=mods

 1<mods:subject xml:lang="en">
 2  <mods:topic>Belgium</mods:topic>
 3  <mods:topic>migration</mods:topic>
 4  <mods:topic>commuting</mods:topic>
 5  <mods:topic>community detection</mods:topic>
 6  <mods:topic>interaction fields</mods:topic>
 7  <mods:topic>provinces</mods:topic>
 8  <mods:topic>Census11</mods:topic>
 9</mods:subject>
10<mods:subject xml:lang="fr">
11  <mods:topic>Belgique</mods:topic>
12  <mods:topic>migration</mods:topic>
13  <mods:topic>détection de communautés</mods:topic>
14  <mods:topic>champs d’interactions</mods:topic>
15  <mods:topic>navettes</mods:topic>
16  <mods:topic>provinces</mods:topic>
17  <mods:topic>Census11</mods:topic>
18</mods:subject>

11. mods.originInfo

11.1 mods:dateIssued

  • mods:dateIssued provides without prefix the year of publication of the document.

11.2 mods:dateOther

  • mods:dateOther with attribute type="published_on_openedition" provides the publishing date of the document on OpenEdition platform.

  • For OpenEdition Journals, if mods:accessCondition[@type="restriction on access"] = embargoed access, an extra mods:dateOther element with attribute type="available" provides the end date of embargo (availability date of the document in open access):

11.3 mods:publisher

  • mods:publisher provides the publisher name. Repeatable.

11.4 mods.place

  • For books, mods.place provides the publication place.

Example (Journal article): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/d85h&metadataPrefix=mods

1<mods:originInfo>
2  <mods:dateIssued encoding="w3cdtf">2017</mods:dateIssued>
3  <mods:dateOther encoding="w3cdtf" type="published_on_openedition">2018-04-11</mods:dateOther>
4  <mods:publisher>Société Royale Belge de Géographie</mods:publisher>
5  <mods:publisher>National Committee of Geography of Belgium</mods:publisher>
6</mods:originInfo>

Example (Journal article with embargo): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/k213&metadataPrefix=mods

1<mods:accessCondition type="restriction on access" auhorityURI="http://purl.org/coar/access_right/" valueURI="http://purl.org/coar/access_right/c_f1cf">embargoed access</mods:accessCondition>
2
3<mods:originInfo>
4  <mods:dateIssued encoding="w3cdtf">2023</mods:dateIssued>
5  <mods:dateOther encoding="w3cdtf" type="published_on_openedition">2023-11-28</mods:dateOther>
6  <mods:dateOther encoding="w3cdtf" type="available">2027-01-01</mods:dateOther>
7  <mods:publisher>ENS Éditions</mods:publisher>
8</mods:originInfo>

Example (Book): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/5div&metadataPrefix=mods

1<mods:originInfo>
2  <mods:dateIssued encoding="w3cdtf">1990</mods:dateIssued>
3  <mods:dateOther encoding="w3cdtf" type="published_on_openedition">2022-08-28</mods:dateOther>
4  <mods:place>
5    <mods:placeTerm>Lyon</mods:placeTerm>
6  </mods:place>
7  <mods:publisher>Presses universitaires de Lyon</mods:publisher>
8</mods:originInfo>

12. mods:relatedItem[@type=”host”]

  • mods:relatedItem[@type="host"] provides information on the publication context:

    • For articles, it describes the journal and issue in which the article was published.

    • For book chapters, it describes the book in which the chapter was published.

    • For blog posts, it describes the blogin which the post was published.

    • For Calenda events, it describes the platform Calenda.

12.1 mods:title

  • mods:titleInfo/mods:title provides the title of the Journal, Blog, Book

12.2 mods:identifier

  • For journal articles, blog posts, Calenda events:

    • mods:identifier[@type="eissn"] provides the digital ISSN of the Journal, Blog or site.

    • mods:identifier[@type="pissn"] provides the print ISSN of the Journal.

  • For book chapters:

    • mods:identifier[@type="eisbn"] provides the digital ISBN of the Book.

    • mods:identifier[@type="pisbn"] provides the print ISSN of the Book.

  • For book chapters and journal articles :

    • mods:identifier[@type="doi"] provides the DOI of the jook or journal issue.

    • mods:identifier[@type="hdl"] provides the Handle of the book or journal issue.

12.3 mods:part

  • For books chapters and journal articles mods:part provides pagination.

  • For journal articles mods:part provides also the volume, issue, as shown in the example below..

Example (Journal article): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/gioa&metadataPrefix=mods

 1<mods:relatedItem type="host">
 2  <mods:titleInfo>
 3    <mods:title>Géomorphologie : relief, processus, environnement</mods:title>
 4  </mods:titleInfo>
 5  <mods:identifier type="eissn" typeURI="http://id.loc.gov/vocabulary/identifiers/issn">1957-777X</mods:identifier>
 6  <mods:identifier type="pissn" typeURI="http://id.loc.gov/vocabulary/identifiers/issn">1266-5304</mods:identifier>
 7  <mods:identifier type="doi">10.4000/geomorphologie.7878</mods:identifier>
 8  <mods:identifier type="hdl">20.500.13089/gizl</mods:identifier>
 9  <mods:part>
10    <mods:detail type="volume">
11      <mods:number>16</mods:number>
12    </mods:detail>
13    <mods:detail type="issue">
14      <mods:number>2</mods:number>
15    </mods:detail>
16    <mods:extent unit="pages">
17      <mods:start>215</mods:start>
18      <mods:end>222</mods:end>
19      <mods:list>215-222</mods:list>
20    </mods:extent>
21  </mods:part>
22</mods:relatedItem>

Example (Book chapter): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11ppk&metadataPrefix=mods

 1<mods:relatedItem type="host">
 2  <mods:titleInfo>
 3    <mods:title>Renouveler les médiations du patrimoine en bibliothèque</mods:title>
 4  </mods:titleInfo>
 5  <mods:identifier type="eisbn" typeURI="http://id.loc.gov/vocabulary/identifiers/isbn">978-2-37546-171-6</mods:identifier>
 6  <mods:identifier type="pisbn" typeURI="http://id.loc.gov/vocabulary/identifiers/isbn">978-2-37546-170-9</mods:identifier>
 7  <mods:identifier type="doi">10.4000/11pqr</mods:identifier>
 8  <mods:identifier type="handle">20.500.13089/11pqr</mods:identifier>
 9  <mods:part>
10    <mods:extent unit="pages">
11      <mods:start>21</mods:start>
12      <mods:end>28</mods:end>
13      <mods:list>21-28</mods:list>
14    </mods:extent>
15  </mods:part>
16</mods:relatedItem>

Example (Blog post): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11sem&metadataPrefix=mods

1<mods:relatedItem type="host">
2  <mods:titleInfo>
3    <mods:title>Mondes sociaux</mods:title>
4  </mods:titleInfo>
5  <mods:identifier type="eissn" typeURI="http://id.loc.gov/vocabulary/identifiers/issn">2428-1387</mods:identifier>
6</mods:relatedItem>

Example (Calenda event): https://metadata.openedition.org/oai?verb=GetRecord&identifier=20.500.13089/11pm5&metadataPrefix=mods

1<mods:relatedItem type="host">
2  <mods:titleInfo>
3    <mods:title>Calenda</mods:title>
4  </mods:titleInfo>
5  <mods:identifier type="eissn" typeURI="http://id.loc.gov/vocabulary/identifiers/issn">2107-5646</mods:identifier>
6</mods:relatedItem>