Skip to content

2. MODS documentation for OpenEdition Books

Jump to bottom
CarolineTerrier edited this page Jul 4, 2019 · 11 revisions

MODS documentation specific to OpenEdition Books

See the METS documentation for OpenEdition for MODS elements that are common to OpenEdition Books and OpenEdition Journals.

This page details the elements specific to OpenEdition Books.

Errata :

Revision 01/11/2019: two licences added (CC BY-NC 4.0 and CC BY-ND 4.0)

Author

  • Surname:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="author"]/mods:namePart[@type="family"]
  • First name:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="author"]/mods:namePart[@type="given"]
  • Description:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="author"]/mods:description
    This field can contain plain text or simple HTML elements (<p>, <em>, <strong>, <br/>, <i>, <sub>, <sup>, <span style="font-variant:small-caps;">). To allow XML validation of the METS file, the HTML code must be placed in a CDATA.
    Example: <![CDATA[ <p>Lorem <em>Ipsum</em></p> ]]>

Scientific publisher

  • Surname:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="editor"]/mods:namePart[@type="family"]
  • First name:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="editor"]/mods:namePart[@type="given"]
  • Description:
    xpath : ./mods:name[mods:role/mods:roleTerm/text()="editor"]/mods:description

Translator

  • Surname:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="translator"]/mods:namePart[@type="family"]
  • First name:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="translator"]/mods:namePart[@type="given"]
  • Description:
    xpath: ./mods:name[mods:role/mods:roleTerm/text()="translator"]/mods:description

HTML ISBN

Provided only by OpenEdition.
xpath: ./mods:identifier[@type="htmlisbn"]

Co-publisher

The main publisher of the book is not indicated in the METS file because it is defined at a more general level in the information system.
However, any co-publishers are indicated in the following form:

xpath: ./mods:originInfo/mods:publisher

Year of publication

In the format: YYYY
xpath: ./mods:originInfo/mods:dateIssued[@encoding="w3cdtf"]

Place of publication

xpath: ./mods:originInfo/mods:place/mods:placeTerm

Note: The place of publication is not obligatory. If it is absent, the city where the publisher is based (indicated in the record) is retrieved and displayed by default.

Book number in the series

xpath: ./mods:part/mods:detail/mods:number

Pagination

xpath: ./mods:physicalDescription/mods:extent

Main language of the book

xpath: ./mods:language[@usage="primary"]/mods:languageTerm[@type="code"]
The language must be expressed according to the ISO639-1 standard (fr, en, de, etc.)

Second language of the book

xpath: ./mods:language[not(@usage)]/mods:languageTerm[@type="code"]
The language must be expressed according to ISO639-1 (fr, en, de, etc.)

Note: The secondary language is not an occasionally used language (citations, excerpts, etc.) within a document (chapter, preface, etc.). It is a language used in the body of one or more documents, but which is not the main language used in the book.

Licence

xpath: ./mods:accessCondition

This element can contain only the licences selected by OpenEdition:

  • CC BY 3.0
  • CC BY 4.0
  • CC BY-NC 2.0 UK
  • CC BY-NC 3.0
  • CC BY-NC 4.0
  • CC BY-NC-ND 2.0 DE
  • CC BY-NC-ND 2.0 UK
  • CC BY-NC-ND 2.5
  • CC BY-NC-ND 3.0
  • CC BY-NC-ND 3.0 DE
  • CC BY-NC-ND 3.0 FR
  • CC BY-NC-ND 4.0
  • CC BY-NC-SA 2.5 IT
  • CC BY-NC-SA 3.0
  • CC BY-NC-SA 4.0
  • CC BY-ND 3.0
  • CC BY-ND 4.0
  • CC BY-SA 2.5 IT
  • CC BY-SA 3.0
  • CC BY-SA 3.0 DE
  • CC BY-SA 3.0 IT
  • CC BY-SA 4.0
  • OpenEdition Licence for Books

Note: If no licence is entered in MODS, Lodel’s default behaviour is to assign an OpenEdition Licence for Books to the publication.

Book abstract

xpath: ./mods:abstract[@xml:lang="LANG-ISO639-1"][not(@type="excerpt")]
Where LANG-ISO639-1 is the language of the abstract according to ISO639-1 (fr, en, de, etc.).

The field is repeatable with different “xml: lang” values if the text is translated into multiple languages. This field can contain plain text or simple HTML elements (<p>, <em>, <strong>, <br/>, <i>, <sub>, <sup>, <span style="font-variant:small-caps;">). To allow XML validation of the METS file, the HTML code must be placed in a CDATA.
Example: <![CDATA[ <p>Lorem <em>Ipsum</em></p> ]]>

Book extract

xpath: ./mods:abstract[@type="excerpt"]

The excerpt from the book is used in the absence of an abstract. This field can contain plain text or simple HTML elements (<p>, <em>, <strong>, <br/>, <i>, <sub>, <sup>, <span style="font-variant:small-caps;">). To allow XML validation of the METS file, the HTML code must be placed in a CDATA.
Example: <![CDATA[ <p>Lorem <em>Ipsum</em></p> ]]>

Publisher’s note

xpath: ./mods:note[@type="publisher"]

This field can contain simple text or simple HTML elements (<p>, <em>, <strong>, <br/>, <i>, <sub>, <sup>, <span style="font-variant:small-caps;">). To allow XML validation of the METS file, the HTML code must be placed in a CDATA.
Example: <![CDATA[ <p>Lorem <em>Ipsum</em></p> ]]>

Introduction to the publication

xpath: ./mods:note[@xml:lang="LANG-ISO639-1"][not(@type="publisher")]
Where LANG-ISO639-1 is the language of the note according to ISO639-1 (fr, en, de, etc.).

Warning: this field is not displayed in the layout and the content of this field is never visible to the public: it does not appear in any format.

The field is repeatable with different “xml: lang” values if the text is translated into multiple languages. This field can contain plain text or simple HTML elements (<p>, <em>, <strong>, <br/>, <i>, <sub>, <sup>, <span style="font-variant:small-caps;">). To allow XML validation of the METS file, the HTML code must be placed in a CDATA.
Example: <![CDATA[ <p>Lorem <em>Ipsum</em></p> ]]>

Indexing

Indexing elements must be placed in <mods: subjects> tags, distinguished by an “authority” attribute: The different indexes are:

Index of people cited:

  • Surname:
    xpath: ./mods:subject[@authority="personnescitees"]/mods:name/mods:namePart[@type="family"]
  • First name:
    xpath: ./mods:subject[@authority="personnescitees"]/mods:name/mods:namePart[@type="given"]

Bisac:

xpath: ./mods:subject[@authority="bisac"]/mods:topic

Comments:

ISI

xpath: ./mods:subject[@authority="isi"]/mods:topic

Warning: only the OpenEdition team can enter entries into this index.
(This index can contain only the ISI elements selected by OpenEdition)

OpenEdition index:

xpath: ./mods:subject[@authority="openedition"]/mods:topic

Warning: only the OpenEdition team can enter entries into this index.
(This index can contain only the OpenEdition codes defined by OpenEdition)

Clone this wiki locally