1 teiHeader¶
Table of content
1.1 fileDesc¶
The “fileDesc” element contains the descriptive metadata of the TEI document arranged in the following elements:
titleStmt
: titles and contributorspublicationStmt
: information about electronic publishingsourceDesc
: information about the source of the document. They will take on a different meaning depending on the use of the TEI document
1.1.1 titleStmt¶
1.1.1.1 titles, subtitles, overtitles, translated titles¶
XPath
/TEI/teiHeader/fileDesc/titleStmt/title[@type='main']
/TEI/teiHeader/fileDesc/titleStmt/title[@type='sub']
/TEI/teiHeader/fileDesc/titleStmt/title[@type='sup']
/TEI/teiHeader/fileDesc/titleStmt/title[@type='alt' and @xml:lang]
Usage
- no line break (
<lb />
), only one elementtitle
per type ; - lower case except initial, not ending with a dot;
- for translated titles the attribute
xml:lang
is mandatory with a value in ISO 639-1 format.
Example
[...]
<teiHeader>
<fileDesc>
<titleStmt>
<title type="sup">Dolor sit amet</title>
<title type="main">Lorem ipsum pour Opentext</title>
<title type="sub">Basé sur le modèle éditorial pour Lodel de OpenEdition</title>
<title type="alt" xml:lang="en">Other travelling salesmen live a life of luxury</title>
<title type="alt" xml:lang="es">Las preocupaciones son mucho mayores</title>
[...]
1.1.1.2 Authors, editors, translators¶
XPath
/TEI/teiHeader/fileDesc/titleStmt/author/
/TEI/teiHeader/fileDesc/titleStmt/editor[@role='translator']
/TEI/teiHeader/fileDesc/titleStmt/editor[not(@role)]
/TEI/teiHeader/fileDesc/titleStmt/editor[@role='excavationsdirector']
/TEI/teiHeader/fileDesc/titleStmt/editor[@role='collaborator']
- Contributors’ names
/TEI/teiHeader/fileDesc/titleStmt/author/persName/forename
/TEI/teiHeader/fileDesc/titleStmt/author/persName/surname
- Names of Translators, Scientific Editor, Excavation Director, Collaborator
/TEI/teiHeader/fileDesc/titleStmt/editor/persName/forename
/TEI/teiHeader/fileDesc/titleStmt/editor/persName/surname
- Authors’ description
/TEI/teiHeader/fileDesc/titleStmt/author/orgName
/TEI/teiHeader/fileDesc/titleStmt/author/roleName[@type='function']
/TEI/teiHeader/fileDesc/titleStmt/author/roleName[@type='honorific']
/TEI/teiHeader/fileDesc/titleStmt/author/email
/TEI/teiHeader/fileDesc/titleStmt/author/ref[@type='website']
- Description of the Translator, Scientific Editor, Excavation Director, Collaborator
/TEI/teiHeader/fileDesc/titleStmt/editor/affiliation
/TEI/teiHeader/fileDesc/titleStmt/editor/orgName
/TEI/teiHeader/fileDesc/titleStmt/editor/roleName[@type='function']
/TEI/teiHeader/fileDesc/titleStmt/editor/roleName[@type='honorific']
/TEI/teiHeader/fileDesc/titleStmt/editor/email
/TEI/teiHeader/fileDesc/titleStmt/editor/ref[@type='website']
Usage
- it is possible to add several authors, translators, etc. for the document;
- possibility to add descriptions for each contributor, the general description is indicated in the tag
<affiliation>
; - pay attention to the case and spelling to avoid duplicates in indexes.
Example
[...]
<titleStmt>
[...]
<author>
<name>Marin Dacos</name>
<affiliation>
Directeur du Cléo (Centre pour l'édition électronique ouverte)
</affiliation>
<roleName type="function">
Directeur
</roleName>
<orgName>
Cléo
</orgName>
<email>
contact@openedition.org
</email>
<ref target="http://www.openedition.org" type="website">http://www.openedition.org</ref>
<roleName type="honorific">
M.
</roleName>
</author>
<editor role="translator">
<persName>
<forename>Jean-François</forename>
<surname>Rivière</surname>
</persName>
<affiliation>Chargé d'édition au Cléo</affiliation>
</editor>
<editor>
<persName>
<forename>Nahuel</forename>
<surname>Angelinetti</surname>
</persName>
<affiliation>Développeur au Cléo</affiliation>
</editor>
[...]
1.1.2 publicationStmt¶
1.1.2.1 Date of electronic publication¶
XPath
/TEI/teiHeader/fileDesc/publicationStmt/date
Usage
- date in format DD/MM/YYYYY;
- do not use for OpenEdition Books (the date is defined at book level);
- for OpenEdition Journals it is important to provide an electronic publication date: if not, it will be automatically filled in by Lodel and updated if the document is reloaded.
Electronic publication date for journals with embargo period on OpenEdition Journals
- must match the date of the embargo end, calculated by adding the embargo duration to the print publication date;
- used by Lodel to manage document availability: display metadata and summary during the embargo period then provide access to full text;
1.1.2.2 Publisher, Distributor¶
XPath
/TEI/teiHeader/fileDesc/publicationStmt/publisher
/TEI/teiHeader/fileDesc/publicationStmt/distributor
Usage
- Only used in the platform’s output TEI.
Example
<publicationStmt>
[...]
<publisher>Université de Poitiers</publisher>
<distributor>OpenEdition</distributor>
[...]
</publicationStmt>
1.1.2.3 Identifier¶
XPath
/TEI/teiHeader/fileDesc/publicationStmt/idno[@type='documentnumber']
/TEI/teiHeader/fileDesc/publicationStmt/idno[@type='url']
/TEI/teiHeader/fileDesc/publicationStmt/idno[@type='doi']
Usage
- Document number: editorial information displayed in the electronic reference of the document, used to simplify the citation of electronic documents;
- URL and DOI: only used in the platform’s output TEI.
Example
<publicationStmt>
[...]
<idno type="documentnumber">24</idno>
<idno type="url">http://journals.openedition.org/remi/7777</idno>
<idno type="doi">10.4000/remi.7777</idno>
[...]
</publicationStmt>
1.1.2.4 License¶
XPath
/TEI/teiHeader/fileDesc/publicationStmt/availability
Usage
- Used to fill in the license that applies to the document, add an entry to the site’s license index.
Example
<publicationStmt>
[...]
<availability>La revue In Situ. Au regard des sciences sociales
est mise à disposition selon les termes de la Licence Creative Commons
Attribution - Pas d'Utilisation Commerciale - Pas de Modification 4.0 International.
</availability>
[...]
</publicationStmt>
1.1.3 sourceDesc¶
Note
The sourceDesc
element contains information about the source document that was used to produce this TEI document. It will have a different meaning depending on the use of the TEI document:
- when importing a document unto Lodel,
sourceDesc
will contain metadata related to the printed edition if applicable; - in the export “sourceDesc” will contain the metadata of the publication context on OpenEdition (on the journal, issue, book…).
1.1.3.1 biblFull¶
Warning
The “biblFull” element is deprecated from version 1.6.2 of the TEI OpenEdition XML schema
1.1.3.2 biblStruct¶
Warning
The “biblStruct” element is supported:
- OEJ and OEB import: from the 1.6.2 version of the OpenEdition XML TEI schema;
- OE export: from the 1.6.0 version of the OpenEdition XML TEI schema
1.1.3.2.1 biblStruct/analytic¶
XPath
/TEI/teiHeader/sourceDesc/biblStruct/analytic/title[@type='main']
/TEI/teiHeader/sourceDesc/biblStruct/analytic/title[@type='sub']
/TEI/teiHeader/sourceDesc/biblStruct/analytic/title[@type='sup']
/TEI/teiHeader/sourceDesc/biblStruct/analytic/title[@type='alt' and @xml:lang]
/TEI/teiHeader/sourceDesc/biblStruct/analytic/author/
/TEI/teiHeader/sourceDesc/biblStruct/analytic/editor[@role='translator']
/TEI/teiHeader/sourceDesc/biblStruct/analytic/editor[not(@role)]
/TEI/teiHeader/sourceDesc/biblStruct/analytic/editor[@role='excavationsdirector']
/TEI/teiHeader/sourceDesc/biblStruct/analytic/editor[@role='collaborator']
Usage
- Only used in the OpenEdition’s output TEI, the
analytic
element contains the titles and contributors of the TEI document.
1.1.3.2.2 biblStruct/monogr¶
XPath
- Titles
/TEI/teiHeader/sourceDesc/biblStruct/monogr/title[@level='j']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/title[@level='s']
TEI/teiHeader/sourceDesc/biblStruct/monogr/title[@level='s' and @type='alt']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/title[@level='m']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/title[@level='m' and @type='alt']
- Identifiers (Journal)
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='eISSN']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='pISSN']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='url' and @subtype='issue']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='doi' and @subtype='issue']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='url' and @subtype='serie']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='doi' and @subtype='serie']
- Identifiers (Book)
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='eISBN']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='pISBN']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='url' and @subtype='book']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/idno[@type='doi' and @subtype='book']
- Information on the print edition
/TEI/teiHeader/sourceDesc/biblStruct/monogr/imprint/biblScope[@unit='page']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/imprint/biblScope[@unit='issue']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/imprint/date[@type='published']
/TEI/teiHeader/sourceDesc/biblStruct/monogr/imprint/publisher
Usage
In OpenEdition TEI export, the “monogr” element contains the metadata related to the publication environment of the TEI document (book, issue, section, review);
When importing articles on OpenEdition Journals or book chapters on OpenEdition Books (import OB), the following elements are supported:
- Pagination of the print edition (OJ import and OB import);
- Date of print publication (import OJ). On OpenEdition Books the print publication date is defined at the book level.
Print publication date: date in format DD/MM/YYYYY; do not use this date for OpenEdition Books;
Pagination: filled in Roman numbers (V-XXV) or Arabic numbers (5-25), without the mentions p. or pp.;
Bibliographical reference: used to specify the bibliographical reference of the document’s printed edition.
1.1.3.2.3 biblStruct/series¶
XPath
/TEI/teiHeader/sourceDesc/biblStruct/series/title[@level='s']
/TEI/teiHeader/sourceDesc/biblStruct/series/title[@level='s' and @type='alt']
/TEI/teiHeader/sourceDesc/biblStruct/series/idno[@type='eISSN']
/TEI/teiHeader/sourceDesc/biblStruct/series/idno[@type='pISSN']
/TEI/teiHeader/sourceDesc/biblStruct/series/idno[@type='url']
Usage
- In OpenEdition TEI export, for book chapters only, the
series
element contains the metadata related to the publishing environment of the TEI document (series).
1.1.3.2.4 biblStruct Examples¶
Journal article (import OEJ)
[...]
<sourceDesc>
<biblStruct>
<monogr>
<imprint>
<biblScope unit="page">39-56</biblScope>
<date type="published" when="2016-10-24">2016-10-24</date>
</imprint>
</monogr>
</biblStruct>
</sourceDesc>
Journal article (OpenEdition export)
[...]
<sourceDesc>
<biblStruct type="article">
<analytic>
<title level="a" type="main">La formation des étudiants marocains dans les pays de l’Est de l’Europe (1960-2015)</title>
<title level="a" type="alt" xml:lang="en">Moroccan Students’ Training in Eastern Europe Countries (1960-2015)</title>
<title level="a" type="alt" xml:lang="es">La formación de los estudiantes marroquíes en los países de Europa del Este (1960-2015)</title>
<author>
<persName>
<forename>Kamal</forename>
<surname>Mellakh</surname>
</persName>
<affiliation>
Enseignant-chercheur, Département de sociologie, Faculté des lettres et sciences humaines de Mohammedia, Université Hassan II, Casablanca B.P 546, Mohammedia, Maroc ; kmellakh@yahoo.fr
</affiliation>
</author>
</analytic>
<monogr>
<title level="j">Revue européenne des migrations internationales</title>
<idno type="eISSN">1777-5418</idno>
<idno type="pISSN">0765-0752</idno>
<title level="m">Former des élites : mobilités des étudiants d'Afrique au nord du Sahara dans les pays de l'ex-bloc socialiste</title>
<title level="m" type="alt" xml:lang="en">Training Elites: Mobilities of Students of Africa North of Sahara to the Former Socialist Block</title>
<title level="m" type="alt" xml:lang="es">Formar a las élites: movilidades de los estudiantes de África del norte del Sáhara hacia el ex-bloque socialista</title>
<idno type="doi" subtype="issue">10.4000/remi.7751</idno>
<idno type="url" subtype="issue">http://journals.openedition.org/remi/7751</idno>
<imprint>
<publisher>Université de Poitiers</publisher>
<biblScope unit="page">39-56</biblScope>
<biblScope unit="issue">vol. 32 - n°2</biblScope>
<date type="published" when="2016-10-24">2016-10-24</date>
</imprint>
</monogr>
</biblStruct>
</sourceDesc>
Book chapter (OpenEdition export)
[...]
<biblStruct type="chapter">
<analytic>
<title level="a" type="main">Albert Cossery écrit‑il arabe ?</title>
<author>
<persName>
<forename>Frédéric</forename>
<surname>Lagrange</surname>
</persName>
</author>
</analytic>
<monogr>
<title level="m">Savants, amants, poètes et fous</title>
<idno type="pISBN">9782351597521</idno>
<idno type="eISBN">9782351595503</idno>
<idno type="doi" subtype="book">10.4000/books.ifpo.13332</idno>
<idno type="url" subtype="book">http://books.openedition.org/ifpo/13332</idno>
<imprint>
<publisher>Presses de l’Ifpo</publisher>
<publisher>Centre français d'archéologie et de sciences sociales (Cefas)</publisher>
<biblScope unit="page">133-157</biblScope>
<date type="published" when="2019">2019</date>
</imprint>
</monogr>
<series>
<title level="s">Contemporain publications</title>
<idno type="pISSN">2225-7578</idno>
<idno type="url">http://books.openedition.org/ifpo/62</idno>
</series>
</biblStruct>
1.2 encodingDesc¶
Contains formatting declarations in the tagsDecl
element. See 2.2.3 Text layout: hi tags, rend and rendition attributes
1.3 profileDesc¶
1.3.1 Index: keywords, geography, chronology, themes, etc.¶
XPath
/TEI/teiHeader/profileDesc/textClass/keywords[@scheme and @xml:lang]/list/item
<persName>
: /TEI/teiHeader/profileDesc/textClass/keywords[@scheme]/list/item/persName/forename
and /TEI/teiHeader/profileDesc/textClass/keywords[@scheme]/list/item/persName/surname
Usage
- allowed values for the ‘scheme’ attribute:
<keywords scheme="keywords" lang="fr">
: keyword index (mandatory ‘xml:lang’ attribute with a value in ISO 639-1 format);<keywords scheme="geographical">
: Geographical index;<keywords scheme="chronological">
: Chronological index;<keywords scheme="subject">
: Thematic index;<keywords scheme="personcited">
: Cited persons index.
- pay attention to the case and spelling to avoid duplicates in indexes.
Example
<profileDesc>
[...]
<textClass>
<keywords scheme="keyword" xml:lang="fr">
<list>
<item>aenean</item>
<item>commodo</item>
<item>ligula</item>
<item>eget</item>
<item>dolor</item>
</list>
</keywords>
<keywords scheme="chronological">
<list>
<item>XXIe siecle</item>
</list>
</keywords>
<keywords scheme="geographical">
<list>
<item>France</item>
<item>Ile de France</item>
<item>Paris</item>
</list>
</keywords>
<keywords scheme="personcited">
<list>
<item>
<persName>
<forename>Olivier</forename>
<surname>Dumond</surname>
</persName>
</item>
</list>
</keywords>
[...]
1.3.2 Language¶
XPath
/TEI/teiHeader/profileDesc/langUsage/language
Usage
- Language: value in ISO 639-1 format;
Example
<profileDesc>
<langUsage>
<language>fr</language>
</langUsage>
[...]