# TEI Header
The TEI header
<teiHeader> is mandatory and contains descriptive meta-information about the document. The
<teiHeader> minimally contains a description of the electronic file inside a
<fileDesc>. The latter element consists of three mandatory components:
- the title statement
<titleStmt>, providing information about the title
<author>, and others responsible for the electronic text
- the edition statement
<editionStmt>, providing information about the
<author>, and other bibliographical information of the previous editions of the text
- the publication statement
<publicationStmt>, providing publication details about the electronic text in a structured way or as prose inside a paragraph
- a description of the source
<sourceDesc>, documenting bibliographic details about the electronic text’s material source (if any) in a structured way or in a prose paragraph
<TEI xmlns="http://www.tei-c.org/ns/1.0"> <teiHeader> <fileDesc> <titleStmt> <!-- Title statement --> </titleStmt> <editionStmt> <!-- Edition statement --> </editionStmt> <publicationStmt> <!-- Publication statement --> </publicationStmt> <sourceDesc> <!-- Source description --> </sourceDesc> </fileDesc> </teiHeader> <!-- Body, see TEI Body chapter --> </TEI>
# Title statement
The title statement
<titleStmt> is a mandatory element and contains meta-information as title, author and editor of the
<title xml:lang="lat">Somniale Danielis</title>
The element should always contain title of the document and has set
xml:lang attribute with ISO-639-3 language code.
Name of the document can be anything, but it is strongly advised to keep the name of the source text.
For list of language codes see language codes. The
<title> tag can be repeated as many times
as needed, but the
xml:lang should be always set to a different language.
<author xml:id="Author_MartinRocek">Martin Roček</author>
The element should containt name of the author of the digital text in following format
To link to the author later in text
xml:id attribute can be used. It is recommended to prefix
name of the author with letter
Author_, see example above.
Sometimes might be desired to keep the name of the author of the original text. In that case
author element should contain name of the author and your's name should be inside the responsibility statement
respStmt with description of your responsibilities.
<titleStmt> <title xml:lang="lat">The Importance of Being Earnest</title> <author xml:id="Author_Wilde">Oscar Wilde</author> <respStmt> <resp>Transribed and encoded by</resp> <name type="author">Martin Roček</name> </respStmt> </titleStmt>
<editor xml:id="Editor_MartinRocek">Martin Roček</editor>
The element contains name of the editor of the digital text in format
name surname. Similarly, as in case of authors,
xml:id can be used
to link to the editor later in text. It is also recommended to prefix name of the editor with letter
Editor_. Can be omitted if there are
See valid title statement
<titleStmt> <title xml:lang="lat">Somniale Danielis</title> <title xml:lang="eng">Dreambook of Daniel</title> <author>Martin Roček</author> </titleStmt>
# Edition statement
The edition statement provides detailed information about the edition of the electronic text (if applicable). Similar to editions of printed texts, electronic texts may be substantially revised in different versions. Somehow closer to the world of software programs, an edition of an electronic text can be compared to the “release” of a piece of software. For an electronic text, the alteration of its contents, or addition/expansion/removal of substantive (types of) meta-information could qualify a new version of an electronic text as a new edition.
An edition statement is optional for the first release of a computer file; it is mandatory for each later release, though this requirement cannot be enforced by the parser.
<edition xml:id="Edition_1S" n="1.0"> <title xml:lang="eng"></title> </edition>
Every edition should be inside the
xml:id attribute can be used to link to a particular edition
in text, it is recommended to prefix edition with
Edition_ letter. The
n attribute can be used to informn about version of the digital text.
<title xml:lang="eng">Somniale Danielis: the medieval dreambook with thematic annotations</title>
Likewise in the
<titleStmt>, this element should contain title of the edition with set
xml:lang attribute. See
table of the language codes for valid language abbreviations.
Element should contain date when the edition was published in a human readable form. Attribute
when should on the other
hand always contain date in machine readable form
YYYY stands for year,
MM for month and
DD for day.
In case only year is known, date can be omitted.
# Statement of responsibility
<respStmt> <name>Martin Roček</name> <resp>Added thematic annotations.</resp> </respStmt>
respStmt attribute contains descriptions of responsibilities specific to the current edition. It supplies a statement of responsibility for the intellectual content of a text, edition, recording, or series, where the specialized elements for authors, editors, etc. do not suffice or do not apply. May also be used to encode information about individuals or organizations which have played a role in the production or distribution of a bibliographic work. Name of the person should be always wrapped in the
name element and description of responsibility in the
<note>Note of the editor</note>
Should contain editor's note and description of differences between editions.
See valid edition statement
If, for example, the digital edition of this version of Somniale Danielis builds on an existing electronic edition, but adds a substantive new category of annotations by Martin Roček, this could be reflected in the
editionStmt as follows:
<editionStmt> <edition xml:id="Edition_2.O" n="2.0"> <title xml:lang="eng">Somniale Danielis: the Medieval Dreambook with thematic annotations</title> <date when="2020-09-30">2020</date> <note>Thematic annotations were added to the two oldest fragments of the Somniale Danielis.</note> </edition> <respStmt> <name>Martin Roček</name> <resp>Added thematic annotations.</resp> </respStmt> </editionStmt>
# Publication statement
The publicationStmt element is the third component of the fileDesc element and is mandatory. Its function is to name the agency by which a resource is made available (for example, a publisher or distributor) and to supply any additional information about the way in which it is made available such as licensing conditions, identifying numbers, etc.
<publisher>Faculty of Arts</publisher>
Provides the name of the organization responsible for the publication or distribution of a bibliographic item.
# Publication place
<pubPlace> <country>Czech Republic</country> <region><!-- Can be set for countries which are divided to regions --></region> <settlement>Prague</settlement> </pubPlace>
Contains the name of the place where the bibliographic item was published and is additionaly structured with
<country>element should always contain English name of the country where item was published
<region>element is optional and can be used to specify region where item was published
<settlement>element should contain name of the city where item was published
Same as before, date should contain information when the item was published.
<availability> <p>This is an open access work licensed under a Creative Commons Attribution 4.0 International license.</p> </availability>
In case the license needs to be mentioned inside the document, the availability statement can be used
availability. The license should be described inside a paragraph.
See valid publication statement
<publicationStmt> <publisher>Faculty of Arts</publisher> <pubPlace> <country>Czech Republic</country> <region><!-- Can be set for countries which are divided to regions --></region> <settlement>Prague</settlement> </pubPlace> <date when="2020-09-30">30. září 2020</date> <availability> <p>This is an open access work licensed under a Creative Commons Attribution 4.0 International license.</p> </availability> </publicationStmt>
# Encoding description
<encodingDesc> <projectDesc> <p><!-- General project description, optional --></p> </projectDesc> <refsDecl></refsDecl> </encodingDesc>
Documents the relationship between an electronic text and the source or sources from which it was derived. It can be
used to further describe principles that were used when the text was encoded. The text can be written in prose in
p or sub-components.
# Source description
<sourceDesc> <listWit> <witness xml:id="A17"></witness> </listWit> <!-- can contain various lists see People and places or Bibliography --> </sourceDesc>
sourceDesc element is the fifth and final component of the fileDesc element. It is a mandatory element and is used to record details of the source or sources from which a computer file is derived. This might be a printed text or a manuscript, another computer file, an audio or video recording of some kind, or a combination of these. An electronic file may also have no source, if what is being catalogued is an original text created in an electronic form. The paragraph
<p> element can and should be used for the general description of the sources, then each witness should be listed in the
See valid source description
This source description contains additional lists which are described in full on following pages.
<sourceDesc> <listWit> <witness xml:id="A17"></witness> </listWit> <listPerson> <person xml:id="C4"></person> </listPerson> <listPlace> <place xml:id="rome"></place> </listPlace> <listOrg> <org xml:id="catholic-church"></org> </listOrg> <listBibl> <bibl xml:id="Bib_RE_TAC" n="1"></bibl> </listBibl> </sourceDesc>