Association for Computational Linguistics Anthology Reference Corpus
TEI Documentation

This documentation was automatically generated by Roma 4.7. Please direct queries to Jonathon Read.

Table of contents

Elements of TEI P5 appropriate for marking up scientific papers from the Association for Computational Linguistics Anthology Reference Corpus (ACLARC). The schema was generated for use in the contributed task of the special workshop at ACL 2012, Rediscovering 50 Years of Discoveries.

1. Elements

1.1. <TEI>

<TEI> (TEI document) contains a single TEI-conformant document, comprising a TEI header and a text, either in isolation or as part of a <teiCorpus> element. [4. 15.1. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
versionspecifies the version number of the TEI Guidelines against which this document is valid.
Status Optional
Datatype
data.version
Values A TEI version number
Used by
Contained by
Empty element
May contain
header: teiHeader
textstructure: text
Declaration
element TEI { tei_att.global.attributes, attribute version { data.version }?, ( teiHeader, ( ( model.resourceLike+, text? ) | text ) ) }
Schematron
<s:ns prefix="tei" uri="http://www.tei-c.org/ns/1.0"/>
Schematron
<s:ns prefix="rng" uri="http://relaxng.org/ns/structure/1.0"/>
Example
<TEI version="1.2.0">  <teiHeader>   <fileDesc>    <titleStmt>     <title>The shortest TEI Document Imaginable</title>    </titleStmt>    <publicationStmt>     <p>First published as part of TEI P2.</p>    </publicationStmt>    <sourceDesc>     <p>No source: this is an original work.</p>    </sourceDesc>   </fileDesc>  </teiHeader>  <text>   <body>    <p>This is about the shortest TEI document imaginable.</p>   </body>  </text> </TEI>
Note This element is required.

1.2. <abbr>

<abbr> (abbreviation) contains an abbreviation of any sort. [3.5.5. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.responsibility (@cert, @resp)
typeallows the encoder to classify the abbreviation according to some convenient typology.
Status Optional
Datatype
data.enumerated
Sample values include:
suspension
the abbreviation provides the first letter(s) of the word or phrase, omitting the remainder.
contraction
the abbreviation omits some letter(s) in the middle.
brevigraph
the abbreviation comprises a special symbol or mark.
superscription
the abbreviation includes writing above the line.
acronym
the abbreviation comprises the initial letters of the words of a phrase.
title
the abbreviation is for a title of address (Dr, Ms, Mr, …)
organization
the abbreviation is for the name of an organization.
geographic
the abbreviation is for a geographic name.
Note The type attribute is provided for the sake of those who wish to classify abbreviations at their point of occurrence; this may be useful in some circumstances, though usually the same abbreviation will have the same type in all occurrences. As the sample values make clear, abbreviations may be classified by the method used to construct them, the method of writing them, or the referent of the term abbreviated; the typology used is up to the encoder and should be carefully planned to meet the needs of the expected use. For a typology of Middle English abbreviations, see [[undefined PETTY]]
Used by
model.choicePart model.pPart.editorial
Contained by
analysis: cl phr s span w
core: abbr add addrLine author bibl biblScope choice date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element abbr { tei_att.global.attributes, tei_att.responsibility.attributes, attribute type { data.enumerated }?, macro.phraseSeq }
Example
<choice>  <expan>North Atlantic Treaty Organization</expan>  <abbr cert="low">NorATO</abbr>  <abbr cert="high">NATO</abbr>  <abbr cert="high" xml:lang="fr">OTAN</abbr> </choice>
Example
<choice>  <abbr>SPQR</abbr>  <expan>senatus populusque romanorum</expan> </choice>
Note The <abbr> tag is not required; if appropriate, the encoder may transcribe abbreviations in the source text silently, without tagging them. If abbreviations are not transcribed directly but expanded silently, then the TEI header should so indicate.

1.3. <add>

<add> (addition) contains letters, words, or phrases inserted in the text by an author, scribe, annotator, or corrector. [3.4.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.transcriptional (@hand, @status, @cause, @seq) (att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp)) ) att.placement (@place) att.typed (@type, @subtype)
Used by
model.pPart.transcriptional
Contained by
analysis: cl phr s w
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element add { tei_att.global.attributes, tei_att.transcriptional.attributes, tei_att.placement.attributes, tei_att.typed.attributes, macro.paraContent }
Example
The story I am going to relate is true as to its main facts, and as to the consequences <add place="above">of these facts</add> from which this tale takes its title.
Note The <add> element should not be used for additions made by editors or encoders. In these cases, either the <corr> or <supplied> element should be used.

1.4. <addrLine>

<addrLine> (address line) contains one line of a postal address. [3.5.2. 2.2.4. 3.11.2.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.addrPart
Contained by
core: address
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element addrLine { tei_att.global.attributes, macro.phraseSeq }
Example
<address>  <addrLine>Computing Center, MC 135</addrLine>  <addrLine>P.O. Box 6998</addrLine>  <addrLine>Chicago, IL</addrLine>  <addrLine>60680 USA</addrLine> </address>
Note Addresses may be encoded either as a sequence of lines, or using any sequence of component elements from the model.addrPart class. Other non-postal forms of address, such as telephone numbers or email, should not be included within an <address> element directly but may be wrapped within an <addrLine> if they form part of the printed address in some source text.

1.5. <address>

<address> contains a postal address, for example of a publisher, an organization, or an individual. [3.5.2. 2.2.4. 3.11.2.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.addressLike model.publicationStmtPart
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence publicationStmt rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: interp interpGrp span spanGrp
core: addrLine cb gb lb name note pb postBox postCode street
figures: figure notatedMusic
header: idno
namesdates: forename persName surname
Declaration
element address { tei_att.global.attributes, ( model.global*, ( ( model.addrPart ), model.global* )+ ) }
Example
<address>  <street>via Marsala 24</street>  <postCode>40126</postCode>  <name>Bologna</name>  <name n="I">Italy</name> </address>
Example
<address>  <addrLine>Computing Center, MC 135</addrLine>  <addrLine>P.O. Box 6998</addrLine>  <addrLine>Chicago, IL 60680</addrLine>  <addrLine>USA</addrLine> </address>
Note This element should be used for postal addresses only. Within it, the generic element <addrLine> may be used as an alternative to any of the more specialized elements available from the model.addrPart class, such as <street>, <postCode> etc.

1.6. <affiliation>

<affiliation> (affiliation) contains an informal description of a person's present or past affiliation with some organization, for example an employer or sponsor. [15.2.2. ]
Modulenamesdates
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Used by
model.addressLike model.persStateLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element affiliation { tei_att.global.attributes, tei_att.editLike.attributes, tei_att.datable.attributes, tei_att.naming.attributes, macro.phraseSeq }
Example
<affiliation>Junior project officer for the US <name type="org">National Endowment for    the Humanities</name> </affiliation> <affiliation notAfter="1960-01-01" notBefore="1957-02-28">Paid up member of the <orgName>Australian Journalists Association</orgName> </affiliation>
Note If included, the name of an organization may be tagged using either the <name> element as above, or the more specific <orgName> element.

1.7. <analytic>

<analytic> (analytic level) contains bibliographic elements describing an item (e.g. an article or poem) published within a monograph or journal and not as an independent publication. [3.11.2.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
core: biblStruct
May contain
core: author date editor ref textLang title
header: idno
Declaration
element analytic { tei_att.global.attributes, ( author | editor | title | ref | date | textLang | idno )* }
Example
<biblStruct>  <analytic>   <author>Chesnutt, David</author>   <title>Historical Editions in the States</title>  </analytic>  <monogr>   <title level="j">Computers and the Humanities</title>   <imprint>    <biblScope>25.6</biblScope>    <date when="1991-12">(December, 1991):</date>    <biblScope>377–380</biblScope>   </imprint>  </monogr> </biblStruct>
Note May contain titles and statements of responsibility (author, editor, or other), in any order. The <analytic> element may only occur only within a <biblStruct>, where its use is mandatory for the description of an analytic level bibliographic item.

1.8. <appInfo>

<appInfo> (application information) records information about an application which has edited the TEI file.
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.encodingDescPart
Contained by
header: encodingDesc
May contain
header: application
Declaration
element appInfo { tei_att.global.attributes, model.applicationLike+ }
Example
<appInfo>  <application ident="Xaira" version="1.24">   <label>XAIRA Indexer</label>   <ptr target="#P1"/>  </application> </appInfo>

1.9. <application>

<application> provides information about an application which has acted upon the document.
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
identSupplies an identifier for the application, independent of its version number or display name.
Status Required
Datatype
data.name
versionSupplies a version number for the application, independent of its identifier or display name.
Status Required
Datatype
token { pattern = "[\d]+[a-z]*[\d]*(\.[\d]+[a-z]*[\d]*){0,3}" }
Used by
model.applicationLike
Contained by
header: appInfo
May contain
core: desc label p ptr ref
Declaration
element application { tei_att.global.attributes, tei_att.typed.attributes, tei_att.datable.attributes, attribute ident { data.name }, attribute version { token { pattern = "[\d]+[a-z]*[\d]*(\.[\d]+[a-z]*[\d]*){0,3}" } }, ( model.labelLike+, ( model.ptrLike* | model.pLike* ) ) }
Example
<appInfo>  <application ident="ImageMarkupTool1" notAfter="2006-06-01" version="1.5">   <label>Image Markup Tool</label>   <ptr target="#P1"/>   <ptr target="#P2"/>  </application> </appInfo>
This example shows an appInfo element documenting the fact that version 1.5 of the Image Markup Tool1 application has an interest in two parts of a document which was last saved on June 6 2006. The parts concerned are accessible at the URLs given as target for the two <ptr> elements.

1.10. <author>

<author> in a bibliographic reference, contains the name(s) of an author, personal or corporate, of a work; for example in the same form as that provided by a recognized bibliographic name authority. [3.11.2.2. 2.2.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Used by
model.respLike
Contained by
core: analytic bibl monogr
header: titleStmt
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element author { tei_att.global.attributes, tei_att.naming.attributes, macro.phraseSeq }
Example
<author>British Broadcasting Corporation</author> <author>La Fayette, Marie Madeleine Pioche de la Vergne, comtesse de (1634–1693)</author> <author>Anonymous</author> <author>Bill and Melinda Gates Foundation</author> <author>  <persName>Beaumont, Francis</persName> and <persName>John Fletcher</persName> </author> <author>  <orgName key="BBC">British Broadcasting    Corporation</orgName>: Radio 3 Network </author>
Note Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use a generally recognized name authority file to supply the content for this element. The attributes key or ref may also be used to reference canonical information about the author(s) intended from any appropriate authority, such as a library catalogue or online resource. In the case of a broadcast, use this element for the name of the company or network responsible for making the broadcast. Where an author is unknown or unspecified, this element may contain text such as Unknown or Anonymous. When the appropriate TEI modules are in use, it may also contain detailed tagging of the names used for people, organizations or places, in particular where multiple names are given.

1.11. <availability>

<availability> supplies information about the availability of a text, for example any restrictions on its use or distribution, its copyright status, any licence applying to it, etc. [2.2.4. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
statussupplies a code identifying the current availability of the text.
Status Optional
Legal values are:
free
the text is freely available.
unknown
the status of the text is unknown. [Default]
restricted
the text is not freely available.
Used by
model.publicationStmtPart
Contained by
header: publicationStmt
May contain
core: p
header: licence
Declaration
element availability { tei_att.global.attributes, tei_att.declarable.attributes, attribute status { "free" | "unknown" | "restricted" }?, model.availabilityPart+ }
Example
<availability status="restricted">  <p>Available for academic research purposes only.</p> </availability> <availability status="free">  <p>In the public domain</p> </availability> <availability status="restricted">  <p>Available under licence from the publishers.</p> </availability>
Example
<availability>  <licence target="http://opensource.org/licenses/MIT">   <p>The MIT License      applies to this document.</p>   <p>Copyright (C) 2011 by The University of Victoria</p>   <p>Permission is hereby granted, free of charge, to any person obtaining a copy      of this software and associated documentation files (the "Software"), to deal      in the Software without restriction, including without limitation the rights      to use, copy, modify, merge, publish, distribute, sublicense, and/or sell      copies of the Software, and to permit persons to whom the Software is      furnished to do so, subject to the following conditions:</p>   <p>The above copyright notice and this permission notice shall be included in      all copies or substantial portions of the Software.</p>   <p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR      IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,      FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE      AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER      LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,      OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN      THE SOFTWARE.</p>  </licence> </availability>
Note A consistent format should be adopted

1.12. <back>

<back> (back matter) contains any appendixes, etc. following the main part of a text. [4.7. 4. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls)
Used by
Contained by
textstructure: text
May contain
analysis: interp interpGrp span spanGrp
core: cb gb head lb note pb
figures: figure notatedMusic
textstructure: div docAuthor docDate docEdition docImprint docTitle
Declaration
element back { tei_att.global.attributes, tei_att.declaring.attributes, ( ( model.frontPart | model.pLike.front | model.global )*, ( ( ( ( model.div1Like ), ( model.frontPart | model.div1Like | model.global )* ) | ( ( model.divLike ), ( model.frontPart | model.divLike | model.global )* ) )? ), ( ( ( model.divBottomPart ), ( model.divBottomPart | model.global )* )? ) ) }
Example
<back>  <div1 type="appendix">   <head>The Golden Dream or, the Ingenuous Confession</head>   <p>To shew the Depravity of human Nature </p>  </div1>  <div1 type="epistle">   <head>A letter from the Printer, which he desires may be inserted</head>   <salute>Sir.</salute>   <p>I have done with your Copy, so you may return it to the Vatican, if you please </p>  </div1>  <div1 type="advert">   <head>The Books usually read by the Scholars of Mrs Two-Shoes are these and are sold at Mr      Newbery's at the Bible and Sun in St Paul's Church-yard.</head>   <list>    <item n="1">The Christmas Box, Price 1d.</item>    <item n="2">The History of Giles Gingerbread, 1d.</item>    <item n="42">A Curious Collection of Travels, selected from the Writers of all Nations,        10 Vol, Pr. bound 1l.</item>   </list>  </div1>  <div1 type="advert">   <head>    <hi rend="center">By the KING's Royal Patent,</hi> Are sold by J. NEWBERY, at the      Bible and Sun in St. Paul's Church-Yard.</head>   <list>    <item n="1">Dr. James's Powders for Fevers, the Small-Pox, Measles, Colds, &amp;c.        2s. 6d</item>    <item n="2">Dr. Hooper's Female Pills, 1s.</item>   </list>  </div1> </back>
Note The content model of back matter is identical to that of front matter, reflecting the facts of cultural history.

1.13. <bibl>

<bibl> (bibliographic citation) contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. [3.11.1. 2.2.7. 15.3.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default) att.typed (@type, @subtype) att.sortable (@sortKey)
Used by
model.biblLike model.biblPart model.msItemPart model.personPart
Contained by
core: add bibl del desc emph head hi item listBibl meeting note p q quote ref title
figures: cell figure
header: change licence rendition sourceDesc tagUsage
textstructure: body div docEdition
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address author bibl biblScope cb choice date del editor email emph expan gb hi lb meeting name note num pb ptr pubPlace publisher ref series term textLang time title
figures: figure notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element bibl { tei_att.global.attributes, tei_att.declarable.attributes, tei_att.typed.attributes, tei_att.sortable.attributes, ( text | model.gLike | model.highlighted | model.pPart.data | model.pPart.edit | model.segLike | model.ptrLike | model.biblPart | model.global )* }
Example
<bibl>Blain, Clements and Grundy: Feminist Companion to Literature in English (Yale, 1990)</bibl>
Example
<bibl>  <title level="a">The Interesting story of the Children in the Wood</title>. In <author>Victor E Neuberg</author>, <title>The Penny Histories</title>. <publisher>OUP</publisher>  <date>1968</date>. </bibl>
Example
<bibl subtype="book_chapter" type="article" xml:id="carlin_2003">  <author>   <name>    <surname>Carlin</surname>      (<forename>Claire</forename>)</name>  </author>, <title level="a">The Staging of Impotence : France’s last    congrès</title> dans <bibl type="monogr">   <title level="m">Theatrum mundi : studies in honor of Ronald W.      Tobin</title>, éd.  <editor>    <name>     <forename>Claire</forename>     <surname>Carlin</surname>    </name>   </editor> et  <editor>    <name>     <forename>Kathleen</forename>     <surname>Wine</surname>    </name>   </editor>,  <pubPlace>Charlottesville, Va.</pubPlace>,  <publisher>Rookwood Press</publisher>,  <date when="2003">2003</date>.  </bibl> </bibl>
Note Contains phrase-level elements, together with any combination of elements from the biblPart class

1.14. <biblFull>

<biblFull> (fully-structured bibliographic citation) contains a fully-structured bibliographic citation, in which all components of the TEI file description are present. [3.11.1. 2.2. 2.2.7. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default) att.sortable (@sortKey)
Used by
model.biblLike
Contained by
core: add del desc emph head hi item listBibl meeting note p q quote ref title
figures: cell figure
header: change licence rendition sourceDesc tagUsage
textstructure: body div docEdition
May contain
header: notesStmt publicationStmt seriesStmt sourceDesc titleStmt
Declaration
element biblFull { tei_att.global.attributes, tei_att.declarable.attributes, tei_att.sortable.attributes, ( ( titleStmt, editionStmt?, extent?, publicationStmt, seriesStmt?, notesStmt? ), sourceDesc* ) }
Example
<biblFull>  <titleStmt>   <title>The Feminist Companion to Literature in English: women writers from the middle ages      to the present</title>   <author>Blain, Virginia</author>   <author>Clements, Patricia</author>   <author>Grundy, Isobel</author>  </titleStmt>  <editionStmt>   <edition>UK edition</edition>  </editionStmt>  <extent>1231 pp</extent>  <publicationStmt>   <publisher>Yale University Press</publisher>   <pubPlace>New Haven and London</pubPlace>   <date>1990</date>  </publicationStmt>  <sourceDesc>   <p>No source: this is an original work</p>  </sourceDesc> </biblFull>

1.15. <biblScope>

<biblScope> (scope of citation) defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work. [3.11.2.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
typeidentifies the type of information conveyed by the element, e.g. columns, pages, volume.
Status Optional
Datatype
data.enumerated
Suggested values include:
vol
(volume) the element contains a volume number.
issue
the element contains an issue number, or volume and issue numbers.
pp
(pages) the element contains a page number or page range.
ll
(lines) the element contains a line number or line range.
chap
(chapter) the element contains a chapter indication (number and/or title)
part
the element identifies a part of a book or collection.
fromspecifies the starting point of the range of units indicated by the type attribute.
Status Optional
Datatype
data.word
tospecifies the end-point of the range of units indicated by the type attribute.
Status Optional
Datatype
data.word
Used by
model.imprintPart
Contained by
core: bibl imprint monogr series
header: seriesStmt
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element biblScope { tei_att.global.attributes, attribute type { "vol" | "issue" | "pp" | "ll" | "chap" | "part" | xsd:Name }?, attribute from { data.word }?, attribute to { data.word }?, macro.phraseSeq }
Example
<biblScope>pp 12–34</biblScope> <biblScope from="12" to="34" type="pp"/> <biblScope type="vol">II</biblScope> <biblScope type="pp">12</biblScope>

1.16. <biblStruct>

<biblStruct> (structured bibliographic citation) contains a structured bibliographic citation, in which only bibliographic sub-elements appear and in a specified order. [3.11.1. 2.2.7. 15.3.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default) att.typed (@type, @subtype) att.sortable (@sortKey)
Used by
model.biblLike
Contained by
core: add del desc emph head hi item listBibl meeting note p q quote ref title
figures: cell figure
header: change licence rendition sourceDesc tagUsage
textstructure: body div docEdition
May contain
core: analytic monogr note series
header: idno
Declaration
element biblStruct { tei_att.global.attributes, tei_att.declarable.attributes, tei_att.typed.attributes, tei_att.sortable.attributes, ( analytic*, ( monogr, series* )+, ( model.noteLike | idno )* ) }
Example
<biblStruct>  <monogr>   <author>Blain, Virginia</author>   <author>Clements, Patricia</author>   <author>Grundy, Isobel</author>   <title>The Feminist Companion to Literature in English: women writers from the middle ages      to the present</title>   <edition>first edition</edition>   <imprint>    <publisher>Yale University Press</publisher>    <pubPlace>New Haven and London</pubPlace>    <date>1990</date>   </imprint>  </monogr> </biblStruct>

1.17. <body>

<body> (text body) contains the whole body of a single unitary text, excluding any front or back matter. [4. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls)
Used by
Contained by
textstructure: text
May contain
analysis: interp interpGrp span spanGrp
core: bibl biblStruct cb desc gb head label lb list listBibl meeting note p pb q quote
figures: figure notatedMusic table
header: biblFull
namesdates: listRelation
textstructure: div docAuthor docDate
Declaration
element body { tei_att.global.attributes, tei_att.declaring.attributes, ( model.global*, ( ( model.divTop ), ( model.global | model.divTop )* )?, ( ( model.divGenLike ), ( model.global | model.divGenLike )* )?, ( ( ( model.divLike ), ( model.global | model.divGenLike )* )+ | ( ( model.div1Like ), ( model.global | model.divGenLike )* )+ | ( ( ( model.common ), model.global* )+, ( ( ( model.divLike ), ( model.global | model.divGenLike )* )+ | ( ( model.div1Like ), ( model.global | model.divGenLike )* )+ )? ) ), ( ( model.divBottom ), model.global* )* ) }
Example
<body>  <l>Nu scylun hergan hefaenricaes uard</l>  <l>metudæs maecti end his modgidanc</l>  <l>uerc uuldurfadur sue he uundra gihuaes</l>  <l>eci dryctin or astelidæ</l>  <l>he aerist scop aelda barnum</l>  <l>heben til hrofe haleg scepen.</l>  <l>tha middungeard moncynnæs uard</l>  <l>eci dryctin æfter tiadæ</l>  <l>firum foldu frea allmectig</l>  <trailer>primo cantauit Cædmon istud carmen.</trailer> </body>

1.18. <c>

<c> (character) represents a character. [17.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
Used by
model.segLike
Contained by
analysis: cl m pc phr s w
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May containEmpty element
Declaration
element c { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, macro.xtext }
Example
<phr>  <c>M</c>  <c>O</c>  <c>A</c>  <c>I</c>  <w>doth</w>  <w>sway</w>  <w>my</w>  <w>life</w> </phr>
Note Contains a single character, a <g> element, or a sequence of graphemes to be treated as a single character. The type attribute is used to indicate the function of this segmentation, taking values such as letter, punctuation, or digit etc.

1.19. <cRefPattern>

<cRefPattern> (canonical reference pattern) specifies an expression and replacement pattern for transforming a canonical reference into a URI. [2.3.5.3. 2.3.5. 2.3.5.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
matchPatternspecifies a regular expression against which the values of cRef attributes can be matched.
Status Required
Datatype
data.pattern
Values must be a regular expression according to the W3C XML Schema Language
Note Parenthesised groups are used not only for establishing order of precedence and atoms for quantification, but also for creating subpatterns to be referenced by the replacementPattern attribute.
replacementPatternspecifies a ‘replacement pattern’ which, once subpattern substitution has been performed, provides a URI.
Status Required
Datatype
text
Values Should be the skeleton of a relative or absolute URI, with references to groups in the matchPattern.
Note The strings ‘$1’ through ‘$9’ are references to the corresponding group in the regular expression specified by matchPattern (counting open parenthesis, left to right). Processors are expected to replace them with whatever matched the corresponding group in the regular expression. If a digit preceded by a dollar sign is needed in the actual replacement pattern (as opposed to being used as a back reference), the dollar sign must be written as %24.
Used by
Contained by
header: refsDecl
May contain
core: p
Declaration
element cRefPattern { tei_att.global.attributes, attribute matchPattern { data.pattern }, attribute replacementPattern { text }, model.pLike* }
Example
<cRefPattern   matchPattern="([1-9A-Za-z]+)\s+([0-9]+):([0-9]+)"   replacementPattern="#xpath(//div[@type='book'][@n='$1']/div[@type='chap'][@n='$2']/div[@type='verse'][@n='$3'])"/>
Note The result of the substitution may be either an absolute or a relative URI reference. In the latter case it is combined with the value of xml:base in force at the place where the cRef attribute occurs to form an absolute URI in the usual manner as prescribed by XML Base.

1.20. <cb/>

<cb/> (column break) marks the boundary between one column of a text and the next in a standard reference system. [3.10.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype) att.sourced (@ed) att.spanning (@spanTo) att.breaking (@break)
Used by
model.milestoneLike
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list listBibl name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May containEmpty element
Declaration
element cb { tei_att.global.attributes, tei_att.typed.attributes, tei_att.sourced.attributes, tei_att.spanning.attributes, tei_att.breaking.attributes, empty }
Example Markup of an early English dictionary printed in two columns:
<pb/> <cb n="1"/> <entryFree>  <form>Well</form>, <sense>a Pit to hold Spring-Water</sense>: <sense>In the Art of <hi rend="italic">War</hi>, a Depth the Miner    sinks into the Ground, to find out and disappoint the Enemies Mines,    or to prepare one</sense>. </entryFree> <entryFree>To <form>Welter</form>, <sense>to wallow</sense>, or <sense>lie groveling</sense>.</entryFree> <cb n="2"/> <entryFree>  <form>Wey</form>, <sense>the greatest Measure for dry Things,    containing five Chaldron</sense>. </entryFree> <entryFree>  <form>Whale</form>, <sense>the greatest of    Sea-Fishes</sense>. </entryFree>
Note On this element, the global n attribute indicates the number or other value associated with the column which follows the point of insertion of this <cb> element. Encoders should adopt a clear and consistent policy as to whether the numbers associated with column breaks relate to the physical sequence number of the column in the whole text, or whether columns are numbered within the page. By convention, the <cb> element is placed at the head of the column to which it refers.

1.21. <cell>

<cell> contains one cell of a table. [14.1.1. ]
Modulefigures
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.tableDecoration (@role, @rows, @cols)
Used by
Contained by
figures: row
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element cell { tei_att.global.attributes, tei_att.tableDecoration.attributes, macro.paraContent }
Example
<row>  <cell role="label">General conduct</cell>  <cell role="data">Not satisfactory, on account of his great unpunctuality    and inattention to duties</cell> </row>

1.22. <change>

<change> documents a change or set of changes made during the production of a source document, or during the revision of an electronic file. [2.5. 2.4.1. ]
Moduleheader
AttributesAttributes att.ascribed (@who) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.docStatus (@status) att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype)
targetpoints to one or more elements that belong to this change.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Used by
Contained by
header: listChange revisionDesc
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num p pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element change { tei_att.ascribed.attributes, tei_att.datable.attributes, tei_att.docStatus.attributes, tei_att.global.attributes, tei_att.typed.attributes, attribute target { list { data.pointer, data.pointer* } }?, macro.specialPara }
Example
<titleStmt>  <title> ... </title>  <editor xml:id="LDB">Lou Burnard</editor>  <respStmt xml:id="BZ">   <resp>copy editing</resp>   <name>Brett Zamir</name>  </respStmt> </titleStmt> <revisionDesc status="published">  <change status="public" when="2008-02-02" who="#BZ">Finished chapter 23</change>  <change status="draft" when="2008-01-02" who="#BZ">Finished chapter 2</change>  <change n="P2.2" when="1991-12-21" who="#LDB">Added examples to section 3</change>  <change when="1991-11-11" who="#MSM">Deleted chapter 10</change> </revisionDesc>
Example
<profileDesc>  <creation>   <listChange>    <change xml:id="DRAFT1">First draft in pencil</change>    <change notBefore="1880-12-09" xml:id="DRAFT2">First revision, mostly        using green ink</change>    <change notBefore="1881-02-13" xml:id="DRAFT3">Final corrections as        supplied to printer.</change>   </listChange>  </creation> </profileDesc>
Note The who attribute may be used to point to any other element, but will typically specify a <respStmt> or <person> element elsewhere in the header, identifying the person responsible for the change and their role in making it. It is recommended that changes be recorded with the most recent first. The status attribute may be used to indicate the status of a document following the change documented.

1.23. <choice>

<choice> groups a number of alternative encodings for the same point in a text. [3.4. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.linePart model.pPart.editorial
Contained by
analysis: cl phr s span w
core: abbr add addrLine author bibl biblScope choice date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
core: abbr choice expan
Declaration
element choice { tei_att.global.attributes, ( model.choicePart | choice )* }
Example An American encoding of Gulliver's Travels which retains the British spelling but also provides a version regularized to American spelling might be encoded as follows.
<p>Lastly, That, upon his solemn oath to observe all the above articles, the said man-mountain shall have a daily allowance of meat and drink sufficient for the support of <choice>   <sic>1724</sic>   <corr>1728</corr>  </choice> of our subjects, with free access to our royal person, and other marks of our <choice>   <orig>favour</orig>   <reg>favor</reg>  </choice>.</p>
Note Because the children of a <choice> element all represent alternative ways of encoding the same sequence, it is natural to think of them as mutually exclusive. However, there may be cases where a full representation of a text requires the alternative encodings to be considered as parallel. Note also that <choice> elements may self-nest. Where the purpose of an encoding is to record multiple witnesses of a single work, rather than to identify multiple possible encoding decisions at a given point, the <app> element and associated elements discussed in section 12.1. should be preferred.

1.24. <cl>

<cl> (clause) represents a grammatical clause. [17.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
Used by
model.segLike
Contained by
analysis: cl phr s
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element cl { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, macro.phraseSeq }
Example
<cl function="clause_modifier" type="relative">Which frightened both the heroes so,<cl>They quite forgot their quarrel.</cl> </cl>
Note The type attribute may be used to indicate the type of clause, taking values such as finite, nonfinite, declarative, interrogative, relative etc. as appropriate.

1.25. <date>

<date> contains a date in any format. [3.5.4. 2.2.4. 2.5. 3.11.2.3. 15.2.3. 13.3.6. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp)) att.typed (@type, @subtype)
Used by
model.dateLike model.publicationStmtPart
Contained by
analysis: cl phr s span
core: abbr add addrLine analytic author bibl biblScope date del desc editor email emph expan head headItem headLabel hi imprint item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence publicationStmt rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element date { tei_att.global.attributes, tei_att.datable.attributes, tei_att.editLike.attributes, tei_att.typed.attributes, ( text | model.gLike | model.phrase | model.global )* }
Example
<date when="1980-02">early February 1980</date>
Example
Given on the <date when="1977-06-12">Twelfth Day of June in the Year of Our Lord One Thousand Nine Hundred and Seventy-seven of the Republic the Two Hundredth and first and of the University the Eighty-Sixth.</date>
Example
<date when="1990-09">September 1990</date>

1.26. <del>

<del> (deletion) contains a letter, word, or passage deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector. [3.4.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.transcriptional (@hand, @status, @cause, @seq) (att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp)) ) att.typed (@type, @subtype)
Used by
model.pPart.transcriptional
Contained by
analysis: cl phr s w
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element del { tei_att.global.attributes, tei_att.transcriptional.attributes, tei_att.typed.attributes, macro.paraContent }
Example
<l>  <del rend="overtyped">Mein</del> Frisch <del rend="overstrike" type="primary">schwebt</del> weht der Wind </l>
Example
<del rend="overstrike">  <gap quantity="5" reason="illegible" unit="character"/> </del>
Note Degrees of uncertainty over what can still be read, or whether a deletion was intended may be indicated by use of the <certainty> element (see 21. ). This element should be used for deletion of shorter sequences of text, typically single words or phrases. The <delSpan> element should be used for longer sequences of text, for those containing structural subdivisions, and for those containing overlapping additions and deletions. The text deleted must be at least partially legible in order for the encoder to be able to transcribe it (unless it is restored in a <supplied> tag). Illegible or lost text within a deletion may be marked using the <gap> tag to signal that text is present but has not been transcribed, or is no longer visible. Attributes on the <gap> element may be used to indicate how much text is omitted, the reason for omitting it, etc. If text is not fully legible, the <unclear> element (available when using the additional tagset for transcription of primary sources) should be used to signal the areas of text which cannot be read with confidence in a similar way. There is a clear distinction in the TEI between <del>, which is a statement of the the or a later scribe's intent to cancel or remove text, and elements such as <gap> or <unclear> which signal the editor's decision to omit or inability to read the text remaining. See further sections 11.3.1.7. and, for the close association of the <del> tag with the <gap>, <damage>, <unclear> and <supplied> elements (the latter three tags available when using the additional tagset for transcription of primary sources), 11.3.3.2. . The <del> tag should not be used for deletions made by editors or encoders. In these cases, either <corr>, <surplus> or <gap> should be used.

1.27. <desc>

<desc> (description) contains a brief description of the object documented by its parent element, including its intended usage, purpose, or application where this is appropriate. [22.4.4. 22.4.5. 22.4.6. 22.4.7. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.translatable (@version)
Used by
model.glossLike model.labelLike
Contained by
analysis: interp interpGrp
core: add del desc emph graphic head hi item meeting note p q quote ref title
figures: cell figure notatedMusic
header: application change licence rendition tagUsage
textstructure: body div docEdition
May contain
core: abbr address bibl biblStruct choice date desc email emph expan hi label list listBibl name num ptr q quote ref term time title
figures: table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element desc { tei_att.global.attributes, tei_att.translatable.attributes, macro.limitedContent }
Example
<desc>contains a brief description of the purpose and application for an element, attribute, attribute value, class, or entity.</desc>
Note TEI convention requires that this be expressed as a finite clause, begining with an active verb.

1.28. <div>

<div> (text division) contains a subdivision of the front, body, or back of a text. [4.1. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.divLike (@org, @sample, @part) att.typed (@type, @subtype) att.declaring (@decls)
Used by
model.divLike
Contained by
textstructure: back body div front
May contain
analysis: interp interpGrp span spanGrp
core: bibl biblStruct cb desc gb head label lb list listBibl meeting note p pb q quote
figures: figure notatedMusic table
header: biblFull
namesdates: listRelation
textstructure: div docAuthor docDate
Declaration
element div { tei_att.global.attributes, tei_att.divLike.attributes, tei_att.typed.attributes, tei_att.declaring.attributes, ( ( model.divTop | model.global )*, ( ( ( ( ( model.divLike | model.divGenLike ), model.global* )+ ) | ( ( ( model.common ), model.global* )+, ( ( model.divLike | model.divGenLike ), model.global* )* ) ), ( ( model.divBottom ), model.global* )* )? ) }
Example
<body>  <div type="part">   <head>Fallacies of Authority</head>   <p>The subject of which is Authority in various shapes, and the object, to repress all      exercise of the reasoning faculty.</p>   <div n="1" type="chapter">    <head>The Nature of Authority</head>    <p>With reference to any proposed measures having for their object the greatest        happiness of the greatest number....</p>    <div n="1.1" type="section">     <head>Analysis of Authority</head>     <p>What on any given occasion is the legitimate weight or influence to be attached to          authority ... </p>    </div>    <div n="1.2" type="section">     <head>Appeal to Authority, in What Cases Fallacious.</head>     <p>Reference to authority is open to the charge of fallacy when... </p>    </div>   </div>  </div> </body>

1.29. <docAuthor>

<docAuthor> (document author) contains the name of the author of the document, as given on the title page (often but not always contained in a byline). [4.6. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.canonical (@key, @ref)
Used by
model.divWrapper model.pLike.front model.titlepagePart
Contained by
core: list
textstructure: back body div front group
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element docAuthor { tei_att.global.attributes, tei_att.canonical.attributes, macro.phraseSeq }
Example
<titlePage>  <docTitle>   <titlePart>Travels into Several Remote Nations of the World, in Four      Parts.</titlePart>  </docTitle>  <byline> By <docAuthor>Lemuel Gulliver</docAuthor>, First a Surgeon,    and then a Captain of several Ships</byline> </titlePage>
Note The document author's name often occurs within a byline, but the <docAuthor> element may be used whether the <byline> element is used or not.

1.30. <docDate>

<docDate> (document date) contains the date of a document, as given (usually) on a title page. [4.6. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
whengives the value of the date in standard form, i.e. YYYY-MM-DD.
Status Optional
Datatype
data.temporal.w3c
Values a date in one of the formats specified in XML Schema Part 2: Datatypes Second Edition
Note For simple dates, the when attribute should give the Gregorian or proleptic Gregorian date in the form (YYYY-MM-DD) specified by XML Schema Part 2.
Used by
model.divWrapper model.pLike.front model.titlepagePart
Contained by
core: list
textstructure: back body div docImprint front group
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element docDate { tei_att.global.attributes, attribute when { data.temporal.w3c }?, macro.phraseSeq }
Example
<docImprint>Oxford, Clarendon Press, <docDate>1987</docDate> </docImprint>
Note Cf. the general <date> element in the core tag set. This specialized element is provided for convenience in marking and processing the date of the documents, since it is likely to require specialized handling for many applications.

1.31. <docEdition>

<docEdition> (document edition) contains an edition statement as presented on a title page of a document. [4.6. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.pLike.front model.titlepagePart
Contained by
textstructure: back front
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element docEdition { tei_att.global.attributes, macro.paraContent }
Example
<docEdition>The Third edition Corrected</docEdition>
Note Cf. the <edition> element of bibliographic citation. As usual, the shorter name has been given to the more frequent element.

1.32. <docImprint>

<docImprint> (document imprint) contains the imprint statement (place and date of publication, publisher name), as given (usually) at the foot of a title page. [4.6. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.pLike.front model.titlepagePart
Contained by
textstructure: back front
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr pubPlace publisher ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
textstructure: docDate
Declaration
element docImprint { tei_att.global.attributes, ( text | model.gLike | model.phrase | pubPlace | docDate | publisher | model.global )* }
Example
<docImprint>Oxford, Clarendon Press, 1987</docImprint>
Imprints may be somewhat more complex:
<docImprint>  <pubPlace>London</pubPlace> Printed for <name>E. Nutt</name>, at <pubPlace>Royal Exchange</pubPlace>; <name>J. Roberts</name> in <pubPlace>wick-Lane</pubPlace>; <name>A. Dodd</name> without <pubPlace>Temple-Bar</pubPlace>; and <name>J. Graves</name> in <pubPlace>St. James's-street.</pubPlace>  <date>1722.</date> </docImprint>
Note Cf. the <imprint> element of bibliographic citations. As with title, author, and editions, the shorter name is reserved for the element likely to be used more often.

1.33. <docTitle>

<docTitle> (document title) contains the title of a document, including all its constituents, as given on a title page. [4.6. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.canonical (@key, @ref)
Used by
model.pLike.front model.titlepagePart
Contained by
textstructure: back front
May contain
analysis: interp interpGrp span spanGrp
core: cb gb lb note pb
figures: figure notatedMusic
Declaration
element docTitle { tei_att.global.attributes, tei_att.canonical.attributes, ( model.global*, model.global+ ) }
Example
<docTitle>  <titlePart type="main">The DUNCIAD, VARIOURVM.</titlePart>  <titlePart type="sub">WITH THE PROLEGOMENA of SCRIBLERUS.</titlePart> </docTitle>

1.34. <editor>

<editor> secondary statement of responsibility for a bibliographic item, for example the name of an individual, institution or organization, (or of several such) acting as editor, compiler, translator, etc. [3.11.2.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Used by
model.respLike
Contained by
core: analytic bibl monogr series
header: seriesStmt titleStmt
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element editor { tei_att.global.attributes, tei_att.naming.attributes, macro.phraseSeq }
Example
<editor>Eric Johnson</editor> <editor role="illustrator">John Tenniel</editor>
Note A consistent format should be adopted. Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use generally recognized authority lists for the exact form of personal names.

1.35. <editorialDecl>

<editorialDecl> (editorial practice declaration) provides details of editorial principles and practices applied during the encoding of a text. [2.3.3. 2.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
Used by
model.encodingDescPart
Contained by
header: encodingDesc
May contain
core: p
header: hyphenation normalization quotation segmentation
Declaration
element editorialDecl { tei_att.global.attributes, tei_att.declarable.attributes, ( model.pLike | model.editorialDeclPart )+ }
Example
<editorialDecl>  <normalization>   <p>All words converted to Modern American spelling using      Websters 9th Collegiate dictionary   </p>  </normalization>  <quotation form="std" marks="all">   <p>All opening quotation marks converted to “ all closing      quotation marks converted to &amp;cdq;.</p>  </quotation> </editorialDecl>

1.36. <email>

<email> (electronic mail address) contains an e-mail address identifying a location to which e-mail messages can be delivered. [3.5.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.addressLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element email { tei_att.global.attributes, macro.phraseSeq }
Example
<email>editors@tei-c.org</email>
Note The format of a modern Internet email address is defined in RFC 2822

1.37. <emph>

<emph> (emphasized) marks words or phrases which are stressed or emphasized for linguistic or rhetorical effect. [3.3.2.2. 3.3.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.emphLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element emph { tei_att.global.attributes, macro.paraContent }
Example
You took the car and did <emph>what</emph>?!!
Example
<q>What it all comes to is this,</q> he said. <q>  <emph>What    does Christopher Robin do in the morning nowadays?</emph> </q>

1.38. <encodingDesc>

<encodingDesc> (encoding description) documents the relationship between an electronic text and the source or sources from which it was derived. [2.3. 2.1.1. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.teiHeaderPart
Contained by
header: teiHeader
May contain
core: p
header: appInfo editorialDecl projectDesc refsDecl samplingDecl tagsDecl
Declaration
element encodingDesc { tei_att.global.attributes, ( ( model.encodingDescPart | model.pLike )+ ) }
Example
<encodingDesc>  <p>Basic encoding, capturing lexical information only. All    hyphenation, punctuation, and variant spellings normalized. No    formatting or layout information preserved.</p> </encodingDesc>

1.39. <expan>

<expan> (expansion) contains the expansion of an abbreviation. [3.5.5. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp))
Used by
model.choicePart model.pPart.editorial
Contained by
analysis: cl phr s span w
core: abbr add addrLine author bibl biblScope choice date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element expan { tei_att.global.attributes, tei_att.editLike.attributes, macro.phraseSeq }
Example
The address is Southmoor <choice>  <expan>Road</expan>  <abbr>Rd</abbr> </choice>
Example
<expan xml:lang="la">  <abbr>Imp</abbr>  <ex>erator</ex> </expan>
Note The content of this element should usually be a complete word or phrase. The <ex> element provided by the transcr module may be used to mark up sequences of letters supplied within such an expansion.

1.40. <figure>

<figure> groups elements representing or containing graphic information such as an illustration, formula, or figure. [14.4. ]
Modulefigures
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.placement (@place) att.typed (@type, @subtype)
Used by
model.global
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
analysis: interp interpGrp span spanGrp
core: bibl biblStruct cb desc gb graphic head label lb list listBibl note p pb q quote
figures: figure formula notatedMusic table
header: biblFull
namesdates: listRelation
Declaration
element figure { tei_att.global.attributes, tei_att.placement.attributes, tei_att.typed.attributes, ( model.headLike | model.common | model.graphicLike | model.global | model.divBottomPart )* }
Example
<figure>  <head>The View from the Bridge</head>  <figDesc>A Whistleresque view showing four or five sailing boats in the foreground, and a    series of buoys strung out between them.</figDesc>  <graphic scale="0.5" url="http://www.example.org/fig1.png"/> </figure>

1.41. <fileDesc>

<fileDesc> (file description) contains a full bibliographic description of an electronic file. [2.2. 2.1.1. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
header: teiHeader
May contain
header: notesStmt publicationStmt seriesStmt sourceDesc titleStmt
Declaration
element fileDesc { tei_att.global.attributes, ( ( titleStmt, editionStmt?, extent?, publicationStmt, seriesStmt?, notesStmt? ), sourceDesc+ ) }
Example
<fileDesc>  <titleStmt>   <title>The shortest possible TEI document</title>  </titleStmt>  <publicationStmt>   <p>Distributed as part of TEI P5</p>  </publicationStmt>  <sourceDesc>   <p>No print source exists: this is an original digital text</p>  </sourceDesc> </fileDesc>
Note The major source of information for those seeking to create a catalogue entry or bibliographic citation for an electronic file. As such, it provides a title and statements of responsibility together with details of the publication or distribution of the file, of any series to which it belongs, and detailed bibliographic notes for matters not addressed elsewhere in the header. It also contains a full bibliographic description for the source or sources from which the electronic text was derived.

1.42. <forename>

<forename> contains a forename, given or baptismal name. [13.2.1. ]
Modulenamesdates
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Used by
model.persNamePart
Contained by
analysis: cl phr s span
core: abbr add addrLine address author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element forename { tei_att.global.attributes, tei_att.personal.attributes, tei_att.typed.attributes, macro.phraseSeq }
Example
<persName>  <roleName>Ex-President</roleName>  <forename>George</forename>  <surname>Bush</surname> </persName>

1.43. <formula>

<formula> contains a mathematical or other formula. [14.2. ]
Modulefigures
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
notationspecifies the notation used for the content of the element.
Status Optional
Datatype
data.enumerated
Used by
model.graphicLike
Contained by
analysis: cl phr s
core: abbr add addrLine author biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell figure formula table
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
core: graphic
figures: formula
Declaration
element formula { tei_att.global.attributes, attribute notation { data.enumerated }?, ( text | model.graphicLike )* }
Example
<formula notation="tex">$e=mc^2$</formula>
Note

1.44. <front>

<front> (front matter) contains any prefatory matter (headers, title page, prefaces, dedications, etc.) found at the start of a document, before the main body. [4.6. 4. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls)
Used by
Contained by
textstructure: text
May contain
analysis: interp interpGrp span spanGrp
core: cb gb head lb note pb
figures: figure notatedMusic
textstructure: div docAuthor docDate docEdition docImprint docTitle
Declaration
element front { tei_att.global.attributes, tei_att.declaring.attributes, ( ( model.frontPart | model.pLike.front | model.global )*, ( ( ( ( model.div1Like ), ( model.frontPart | model.div1Like | model.global )* ) | ( ( model.divLike ), ( model.frontPart | model.divLike | model.global )* ) )? ), ( ( ( model.divBottomPart ), ( model.divBottomPart | model.global )* )? ) ) }
Example
<front>  <epigraph>   <quote>Nam Sibyllam quidem Cumis ego ipse oculis meis      vidi in ampulla pendere, et cum illi pueri dicerent:   <q xml:lang="grc">Sibylla ti weleis</q>; respondebat      illa: <q xml:lang="grc">apowanein welo.</q>   </quote>  </epigraph>  <div type="dedication">   <p>For Ezra Pound <q xml:lang="it">il miglior fabbro.</q>   </p>  </div> </front>
Example
<front>  <div type="dedication">   <p>To our three selves</p>  </div>  <div type="preface">   <head>Author's Note</head>   <p>All the characters in this book are purely imaginary, and if the      author has used names that may suggest a reference to living persons      she has done so inadvertently.      ...</p>  </div> </front>

1.45. <gb/>

<gb/> (gathering begins) marks the point in a transcribed codex at which a new gathering or quire begins. [3.10.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype) att.spanning (@spanTo) att.breaking (@break)
Used by
model.milestoneLike
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list listBibl name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May containEmpty element
Declaration
element gb { tei_att.global.attributes, tei_att.typed.attributes, tei_att.spanning.attributes, tei_att.breaking.attributes, empty }
Example
<gb n="iii"/> <pb n="2r"/> <pb n="2v"/>
Note By convention, <gb> elements should appear at the start of the first page in the gathering. The global n attribute indicates the number or other value used to identify this gathering in a collation. The type attribute may be used to further characterize the gathering in any respect.

1.46. <graphic>

<graphic> indicates the location of an inline graphic, illustration, or figure. [3.9. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.internetMedia (@mimeType) att.declaring (@decls)
widthThe display width of the image
Status Optional
Datatype
data.outputMeasurement
heightThe display height of the image
Status Optional
Datatype
data.outputMeasurement
scaleA scale factor to be applied to the image to make it the desired display size
Status Optional
Datatype
data.numeric
url(uniform resource locator) A URL which refers to the image itself.
Status Required
Datatype
data.pointer
Used by
model.graphicLike model.titlepagePart
Contained by
analysis: cl phr s
core: abbr add addrLine author biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell figure formula notatedMusic table
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
core: desc
Declaration
element graphic { tei_att.global.attributes, tei_att.internetMedia.attributes, tei_att.declaring.attributes, attribute width { data.outputMeasurement }?, attribute height { data.outputMeasurement }?, attribute scale { data.numeric }?, attribute url { data.pointer }, model.glossLike* }
Example
<figure>  <graphic url="fig1.png"/>  <head>Figure One: The View from the Bridge</head>  <figDesc>A Whistleresque view showing four or five sailing boats in the foreground, and a    series of buoys strung out between them.</figDesc> </figure>
Note The mimeType attribute should be used to supply the MIME media type of the image specified by the url attribute.

1.47. <group>

<group> contains the body of a composite text, grouping together a sequence of distinct texts (or groups of such texts) which are regarded as a unit for some purpose, for example the collected works of an author, a sequence of prose essays, etc. [4. 4.3.1. 15.1. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls)
Used by
Contained by
textstructure: group text
May contain
analysis: interp interpGrp span spanGrp
core: cb gb head lb meeting note pb
figures: figure notatedMusic
textstructure: docAuthor docDate group text
Declaration
element group { tei_att.global.attributes, tei_att.declaring.attributes, ( ( model.divTop | model.global )*, ( ( text | group ), ( text | group | model.global )* ), model.divBottom* ) }
Example
<text>  <front/>  <group>   <text/>   <text/>  </group> </text>

1.48. <head>

<head> (heading) contains any type of heading, for example the title of a section, or the heading of a list, glossary, manuscript description, etc. [4.2.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype)
Used by
model.headLike model.pLike.front
Contained by
core: list listBibl
figures: figure table
textstructure: back body div front group
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element head { tei_att.global.attributes, tei_att.typed.attributes, ( text | model.gLike | model.phrase | model.inter | model.lLike | model.global )* }
Example The most common use for the <head> element is to mark the headings of sections. In older writings, the headings or incipits may be rather longer than usual in modern works. If a section has an explicit ending as well as a heading, it should be marked as a <trailer>, as in this example:
<div1 n="I" type="book">  <head>In the name of Christ here begins the first book of the ecclesiastical history of    Georgius Florentinus, known as Gregory, Bishop of Tours.</head>  <div2 type="section">   <head>In the name of Christ here begins Book I of the history.</head>   <p>Proposing as I do ...</p>   <p>From the Passion of our Lord until the death of Saint Martin four hundred and twelve      years passed.</p>   <trailer>Here ends the first Book, which covers five thousand, five hundred and ninety-six      years from the beginning of the world down to the death of Saint Martin.</trailer>  </div2> </div1>
Example The <head> element is also used to mark headings of other units, such as lists:
With a few exceptions, connectives are equally useful in all kinds of discourse: description, narration, exposition, argument. <list type="simple">  <head>Connectives</head>  <item>above</item>  <item>accordingly</item>  <item>across from</item>  <item>adjacent to</item>  <item>again</item>  <item/> </list>
Note The <head> element is used for headings at all levels; software which treats (e.g.) chapter headings, section headings, and list titles differently must determine the proper processing of a <head> element based on its structural position. A <head> occurring as the first element of a list is the title of that list; one occurring as the first element of a <div1> is the title of that chapter or section.

1.49. <headItem>

<headItem> (heading for list items) contains the heading for the item or gloss column in a glossary list or similar structured list. [3.7. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
core: list
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element headItem { tei_att.global.attributes, macro.phraseSeq }
Example
The simple, straightforward statement of an idea is preferable to the use of a worn-out expression. <list type="gloss">  <headLabel rend="small caps">TRITE</headLabel>  <headItem rend="small caps">SIMPLE, STRAIGHTFORWARD</headItem>  <label>bury the hatchet</label>  <item>stop fighting, make peace</item>  <label>at loose ends</label>  <item>disorganized</item>  <label>on speaking terms</label>  <item>friendly</item>  <label>fair and square</label>  <item>completely honest</item>  <label>at death's door</label>  <item>near death</item> </list>
Note The <headItem> element may appear only if each item in the list is preceded by a <label>.

1.50. <headLabel>

<headLabel> (heading for list labels) contains the heading for the label or term column in a glossary list or similar structured list. [3.7. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
core: list
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element headLabel { tei_att.global.attributes, macro.phraseSeq }
Example
The simple, straightforward statement of an idea is preferable to the use of a worn-out expression. <list type="gloss">  <headLabel rend="small caps">TRITE</headLabel>  <headItem rend="small caps">SIMPLE, STRAIGHTFORWARD</headItem>  <label>bury the hatchet</label>  <item>stop fighting, make peace</item>  <label>at loose ends</label>  <item>disorganized</item>  <label>on speaking terms</label>  <item>friendly</item>  <label>fair and square</label>  <item>completely honest</item>  <label>at death's door</label>  <item>near death</item> </list>
Note The <headLabel> element may appear only if each item in the list is preceded by a <label>.

1.51. <hi>

<hi> (highlighted) marks a word or phrase as graphically distinct from the surrounding text, for reasons concerning which no claim is made. [3.3.2.2. 3.3.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.hiLike
Contained by
analysis: cl phr s span w
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element hi { tei_att.global.attributes, macro.paraContent }
Example
<hi rend="gothic">And this Indenture further witnesseth</hi> that the said <hi rend="italic">Walter Shandy</hi>, merchant, in consideration of the said intended marriage ...

1.52. <hyphenation>

<hyphenation> summarizes the way in which hyphenation in a source text has been treated in an encoded version of it. [2.3.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
eol(end-of-line) indicates whether or not end-of-line hyphenation has been retained in a text.
Status Optional
Legal values are:
all
all end-of-line hyphenation has been retained, even though the lineation of the original may not have been.
some
end-of-line hyphenation has been retained in some cases. [Default]
hard
all soft end-of-line hyphenation has been removed: any remaining end-od-line hyphenation should be retained.
none
all end-of-line hyphenation has been removed: any remaining hyphenation occurred within the line.
Used by
model.editorialDeclPart
Contained by
header: editorialDecl
May contain
core: p
Declaration
element hyphenation { tei_att.global.attributes, tei_att.declarable.attributes, attribute eol { "all" | "some" | "hard" | "none" }?, model.pLike+ }
Example
<hyphenation eol="some">  <p>End-of-line hyphenation silently removed where appropriate</p> </hyphenation>

1.53. <idno>

<idno> (identifier) supplies any form of identifier used to identify some object, such as a bibliographic item, a person, a title, an organization, etc. in a standardized way. [2.2.4. 2.2.5. 3.11.2.3. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.sortable (@sortKey)
typecategorizes the identifier, for example as an ISBN, Social Security number, etc.
Status Optional
Datatype
data.enumerated
Used by
model.nameLike model.publicationStmtPart
Contained by
analysis: cl phr s span
core: abbr add addrLine address analytic author bibl biblScope biblStruct date del desc editor email emph expan head headItem headLabel hi item label meeting monogr name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell
header: change licence publicationStmt rendition seriesStmt tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May containEmpty element
Declaration
element idno { tei_att.global.attributes, tei_att.sortable.attributes, attribute type { data.enumerated }?, macro.xtext }
Example
<idno type="ISSN">0143-3385</idno> <idno type="DOI">http://dx.doi.org/10.1000/123</idno> <idno type="URL">http://authority.nzetc.org/463/</idno> <idno type="LT">Thomason Tract E.537(17)</idno> <idno type="Wing">C695</idno> <idno type="oldCat">  <g ref="#sym"/>345 </idno>
In the last case, the identifier includes a non-Unicode character which is defined elsewhere by means of a <glyph> or <char> element referenced here as #sym.
Note<idno>should be used for labels which identify an object or concept in a formal cataloguing system such as a database or an RDF store, or in a distributed system such as the World Wide Web.

1.54. <imprint>

<imprint> groups information relating to the publication or distribution of a bibliographic item. [3.11.2.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
core: monogr
May contain
analysis: interp interpGrp span spanGrp
core: biblScope cb date gb lb note pb pubPlace publisher time
figures: figure notatedMusic
Declaration
element imprint { tei_att.global.attributes, ( ( ( model.imprintPart ) | ( model.dateLike ) ), model.global* )+ }
Example
<imprint>  <pubPlace>Oxford</pubPlace>  <publisher>Clarendon Press</publisher>  <date>1987</date> </imprint>

1.55. <interp>

<interp> (interpretation) summarizes a specific interpretative annotation which can be linked to a span of text. [17.3. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.interpLike (@type, @inst) (att.responsibility (@cert, @resp))
Used by
model.global.meta
Contained by
analysis: cl interpGrp m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
core: desc
Declaration
element interp { tei_att.global.attributes, tei_att.interpLike.attributes, ( text | model.gLike | model.glossLike )* }
Example
<interp type="structuralunit" xml:id="ana_am">aftermath</interp>
Note Generally, each <interp> element carries an xml:id attribute. This permits the encoder to explicitly associate the interpretation represented by the content of an <interp> with any textual element through its ana attribute. Alternatively (or, in addition) an <interp> may carry an inst attribute which points to one or more textual elements to which the analysis represented by the content of the <interp> applies.

1.56. <interpGrp>

<interpGrp> (interpretation group) collects together a set of related interpretations which share responsibility or type. [17.3. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.interpLike (@type, @inst) (att.responsibility (@cert, @resp))
Used by
model.global.meta
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
analysis: interp
core: desc
Declaration
element interpGrp { tei_att.global.attributes, tei_att.interpLike.attributes, ( model.glossLike*, interp+ ) }
Example
<interpGrp resp="#TMA" type="structuralunit">  <desc>basic structural organization</desc>  <interp xml:id="I1">introduction</interp>  <interp xml:id="I2">conflict</interp>  <interp xml:id="I3">climax</interp>  <interp xml:id="I4">revenge</interp>  <interp xml:id="I5">reconciliation</interp>  <interp xml:id="I6">aftermath</interp> </interpGrp> <bibl xml:id="TMA"/>
Note Any number of <interp> elements.

1.57. <item>

<item> contains one component of a list. [3.7. 2.5. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.sortable (@sortKey)
Used by
Contained by
core: list
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num p pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element item { tei_att.global.attributes, tei_att.sortable.attributes, macro.specialPara }
Example
<list type="ordered">  <head>Here begin the chapter headings of Book IV</head>  <item n="4.1">The death of Queen Clotild.</item>  <item n="4.2">How King Lothar wanted to appropriate one third of the Church revenues.</item>  <item n="4.3">The wives and children of Lothar.</item>  <item n="4.4">The Counts of the Bretons.</item>  <item n="4.5">Saint Gall the Bishop.</item>  <item n="4.6">The priest Cato.</item>  <item> ...</item> </list>
Note May contain simple prose or a sequence of chunks. Whatever string of characters is used to label a list item in the copy text may be used as the value of the global n attribute, but it is not required that numbering be recorded explicitly. In ordered lists, the n attribute on the <item> element is by definition synonymous with the use of the <label> element to record the enumerator of the list item. In glossary lists, however, the term being defined should be given with the <label> element, not n.

1.58. <label>

<label> contains any label or heading used to identify part of a text, typically but not exclusively in a list or glossary. [3.7. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.labelLike
Contained by
core: add del desc emph head hi item list meeting note p q quote ref title
figures: cell figure notatedMusic
header: application change licence rendition tagUsage
textstructure: body div docEdition
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element label { tei_att.global.attributes, macro.phraseSeq }
Example Labels are commonly used for the headwords in glossary lists; note the use of the global xml:lang attribute to set the default language of the glossary list to Middle English, and identify the glosses and headings as modern English or Latin:
<list type="gloss" xml:lang="enm">  <head xml:lang="en">Vocabulary</head>  <headLabel xml:lang="en">Middle English</headLabel>  <headItem xml:lang="en">New English</headItem>  <label>nu</label>  <item xml:lang="en">now</item>  <label>lhude</label>  <item xml:lang="en">loudly</item>  <label>bloweth</label>  <item xml:lang="en">blooms</item>  <label>med</label>  <item xml:lang="en">meadow</item>  <label>wude</label>  <item xml:lang="en">wood</item>  <label>awe</label>  <item xml:lang="en">ewe</item>  <label>lhouth</label>  <item xml:lang="en">lows</item>  <label>sterteth</label>  <item xml:lang="en">bounds, frisks (cf. <cit>    <ref>Chaucer, K.T.644</ref>    <quote>a courser, <term>sterting</term>as the fyr</quote>   </cit>  </item>  <label>verteth</label>  <item xml:lang="la">pedit</item>  <label>murie</label>  <item xml:lang="en">merrily</item>  <label>swik</label>  <item xml:lang="en">cease</item>  <label>naver</label>  <item xml:lang="en">never</item> </list>
Example Labels may also be used to record explicitly the numbers or letters which mark list items in ordered lists, as in this extract from Gibbon's Autobiography. In this usage the <label> element is synonymous with the n attribute on the <item> element:
I will add two facts, which have seldom occurred in the composition of six, or at least of five quartos. <list rend="runon" type="ordered">  <label>(1)</label>  <item>My first rough manuscript, without any intermediate copy, has been sent to the press.</item>  <label>(2) </label>  <item>Not a sheet has been seen by any human eyes, excepting those of the author and the    printer: the faults and the merits are exclusively my own.</item> </list>
Example Labels may also be used for other structured list items, as in this extract from the journal of Edward Gibbon:
<list type="gloss">  <label>March 1757.</label>  <item>I wrote some critical observations upon Plautus.</item>  <label>March 8th.</label>  <item>I wrote a long dissertation upon some lines of Virgil.</item>  <label>June.</label>  <item>I saw Mademoiselle Curchod — <quote xml:lang="la">Omnia vincit amor, et nos cedamus      amori.</quote>  </item>  <label>August.</label>  <item>I went to Crassy, and staid two days.</item> </list>
Note that the <label> might also appear within the <item> rather than as its sibling. Though syntactically valid, this usage is not recommended TEI practice.
Example Labels may also be used to represent a label or heading attached to a paragraph or sequence of paragraphs not treated as a structural division, or to a group of verse lines. Note that, in this case, the <label> element appears within the <p> or <lg> element, rather than as a preceding sibling of it.
<p>[...] <lb/>&amp; n’entrer en mauuais &amp; mal-heu- <lb/>ré meſnage. Or des que le conſente- <lb/>ment des parties y eſt le mariage eſt <lb/> arreſté, quoy que de faict il ne ſoit <label rend="right">Puiſſance maritale    entre les Romains.</label>  <lb/> conſommé. Depuis la conſomma- <lb/>tion du mariage la femme eſt ſoubs <lb/> la puiſſance du mary, s’il n’eſt eſcla- <lb/>ue ou enfant de famille : car en ce <lb/> cas, la femme, qui a eſpouſé vn en- <lb/>fant de famille, eſt ſous la puiſſance [...]</p> <p>In this example the text of the label appears in the right hand margin of the original source, next to the paragraph it describes, but approximately in the middle of it. </p>

1.59. <lb/>

<lb/> (line break) marks the start of a new (typographic) line in some edition or version of a text. [3.10.3. 7.2.5. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype) att.sourced (@ed) att.spanning (@spanTo) att.breaking (@break)
Used by
model.milestoneLike
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list listBibl name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May containEmpty element
Declaration
element lb { tei_att.global.attributes, tei_att.typed.attributes, tei_att.sourced.attributes, tei_att.spanning.attributes, tei_att.breaking.attributes, empty }
Example This example shows typographical line breaks within metrical lines, where they occur at different places in different editions:
<l>Of Mans First Disobedience,<lb ed="1674"/> and<lb ed="1667"/> the Fruit</l> <l>Of that Forbidden Tree, whose<lb ed="1667 1674"/> mortal tast</l> <l>Brought Death into the World,<lb ed="1667"/> and all<lb ed="1674"/> our woe,</l>
Example This example encodes typographical line breaks as a means of preserving the visual appearance of a title page. The break attribute is used to show that the line break does not (as elsewhere) mark the start of a new word.
<titlePart rend="italic">  <lb/>L'auteur susdict supplie les Lecteurs <lb/>benevoles, soy reserver à rire au soi-<lb break="no"/>xante &amp; dixhuytiesme livre. </titlePart>
Note By convention, <lb> elements should appear at the point in the text where a new line starts. The n attribute, if used, indicates the number or other value associated with the text between this point and the next <lb> element, typically the sequence number of the line within the page, or other appropriate unit. This element is intended to be used for marking actual line breaks on a manuscript or printed page, at the point where they occur; it should not be used to tag structural units such as lines of verse (for which the <l> element is available) except in circumstances where structural units cannot otherwise be marked. The type attribute may be used to characterize the line break in any respect. The more specialised attributes break and ed should be preferred when the intent is to indicate whether or not the line break is word-breaking, or to note the source from which it derives.

1.60. <licence>

<licence> contains information about a licence or other legal agreement applicable to the text. [2.2.4. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.pointing (@target, @evaluate) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Used by
model.availabilityPart
Contained by
header: availability
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num p pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element licence { tei_att.global.attributes, tei_att.pointing.attributes, tei_att.datable.attributes, macro.specialPara }
Example
<licence   target="http://www.nzetc.org/tm/scholarly/tei-NZETC-Help.html#licensing"> Licence: Creative Commons Attribution-Share Alike 3.0 New Zealand Licence </licence>
Example
<availability>  <licence    notBefore="2013-01-01"    target="http://creativecommons.org/licenses/by/3.0/">   <p>The Creative Commons Attribution 3.0 Unported (CC BY 3.0) Licence      applies to this document.</p>   <p>The lience was added on January 1, 2013.</p>  </licence> </availability>
Note A <licence> element should be supplied for each licence agreement applicable to the text in question. The target attribute may be used to reference a full version of the licence. The when, notBefore, notAfter, from or to attributes may be used in combination to indicate the date or dates of applicability of the licence.

1.61. <list>

<list> (list) contains any sequence of items organized as a list. [3.7. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.sortable (@sortKey)
typedescribes the form of the list.
Status Optional
Datatype
data.enumerated
Suggested values include:
ordered
list items are numbered or lettered.
bulleted
list items are marked with a bullet or other typographic device.
simple
list items are not numbered or bulleted. [Default]
gloss
each list item glosses some term or concept, which is given by a label element preceding the list item.
Note The formal syntax of the element declarations allows <label> tags to be omitted from lists tagged <list type="gloss">; this is however a semantic error.
Used by
model.listLike
Contained by
core: add del desc emph head hi item meeting note p q quote ref title
figures: cell figure
header: change licence rendition revisionDesc sourceDesc tagUsage
textstructure: body div docEdition
May contain
analysis: interp interpGrp span spanGrp
core: cb gb head headItem headLabel item label lb meeting note pb
figures: figure notatedMusic
textstructure: docAuthor docDate
Declaration
element list { tei_att.global.attributes, tei_att.sortable.attributes, attribute type { "ordered" | "bulleted" | "simple" | "gloss" | xsd:Name }?, ( ( ( model.divTop ) | ( model.global ) )*, ( ( item, model.global* )+ | ( headLabel?, headItem?, ( label, model.global*, item, model.global* )+ ) ), ( ( model.divBottom ), model.global* )* ) }
Example
<list type="ordered">  <item>a butcher</item>  <item>a baker</item>  <item>a candlestick maker, with <list type="bullets">    <item>rings on his fingers</item>    <item>bells on his toes</item>   </list>  </item> </list>
Example The following example treats the short numbered clauses of Anglo-Saxon legal codes as lists of items. The text is from an ordinance of King Athelstan (924–939):
<div1 type="section">  <head>Athelstan's Ordinance</head>  <list type="ordered">   <item n="1">Concerning thieves. First, that no thief is to be spared who is caught with      the stolen goods, [if he is] over twelve years and [if the value of the goods is] over      eightpence. <list type="ordered">     <item n="1.1">And if anyone does spare one, he is to pay for the thief with his          wergild — and the thief is to be no nearer a settlement on that account — or to          clear himself by an oath of that amount.</item>     <item n="1.2">If, however, he [the thief] wishes to defend himself or to escape, he is          not to be spared [whether younger or older than twelve].</item>     <item n="1.3">If a thief is put into prison, he is to be in prison 40 days, and he may          then be redeemed with 120 shillings; and the kindred are to stand surety for him          that he will desist for ever.</item>     <item n="1.4">And if he steals after that, they are to pay for him with his wergild,          or to bring him back there.</item>     <item n="1.5">And if he steals after that, they are to pay for him with his wergild,          whether to the king or to him to whom it rightly belongs; and everyone of those who          supported him is to pay 120 shillings to the king as a fine.</item>    </list>   </item>   <item n="2">Concerning lordless men. And we pronounced about these lordless men, from whom      no justice can be obtained, that one should order their kindred to fetch back such a      person to justice and to find him a lord in public meeting. <list type="ordered">     <item n="2.1">And if they then will not, or cannot, produce him on that appointed day,          he is then to be a fugitive afterwards, and he who encounters him is to strike him          down as a thief.</item>     <item n="2.2">And he who harbours him after that, is to pay for him with his wergild          or to clear himself by an oath of that amount.</item>    </list>   </item>   <item n="3">Concerning the refusal of justice. The lord who refuses justice and upholds      his guilty man, so that the king is appealed to, is to repay the value of the goods and      120 shillings to the king; and he who appeals to the king before he demands justice as      often as he ought, is to pay the same fine as the other would have done, if he had      refused him justice. <list type="ordered">     <item n="3.1">And the lord who is an accessory to a theft by his slave, and it becomes          known about him, is to forfeit the slave and be liable to his wergild on the first          occasionp if he does it more often, he is to be liable to pay all that he owns.</item>     <item n="3.2">And likewise any of the king's treasurers or of our reeves, who has been          an accessory of thieves who have committed theft, is to liable to the same.</item>    </list>   </item>   <item n="4">Concerning treachery to a lord. And we have pronounced concerning treachery to      a lord, that he [who is accused] is to forfeit his life if he cannot deny it or is      afterwards convicted at the three-fold ordeal.</item>  </list> </div1>
Note that nested lists have been used so the tagging mirrors the structure indicated by the two-level numbering of the clauses. The clauses could have been treated as a one-level list with irregular numbering, if desired.
Example
<p>These decrees, most blessed Pope Hadrian, we propounded in the public council ... and they confirmed them in our hand in your stead with the sign of the Holy Cross, and afterwards inscribed with a careful pen on the paper of this page, affixing thus the sign of the Holy Cross. <list type="simple">   <item>I, Eanbald, by the grace of God archbishop of the holy church of York, have      subscribed to the pious and catholic validity of this document with the sign of the Holy      Cross.</item>   <item>I, Ælfwold, king of the people across the Humber, consenting have subscribed with      the sign of the Holy Cross.</item>   <item>I, Tilberht, prelate of the church of Hexham, rejoicing have subscribed with the      sign of the Holy Cross.</item>   <item>I, Higbald, bishop of the church of Lindisfarne, obeying have subscribed with the      sign of the Holy Cross.</item>   <item>I, Ethelbert, bishop of Candida Casa, suppliant, have subscribed with thef sign of      the Holy Cross.</item>   <item>I, Ealdwulf, bishop of the church of Mayo, have subscribed with devout will.</item>   <item>I, Æthelwine, bishop, have subscribed through delegates.</item>   <item>I, Sicga, patrician, have subscribed with serene mind with the sign of the Holy      Cross.</item>  </list> </p>
Note May contain an optional heading followed by a series of items, or a series of label and item pairs, the latter being optionally preceded by one or two specialized headings.

1.62. <listBibl>

<listBibl> (citation list) contains a list of bibliographic citations of any kind. [3.11.1. 2.2.7. 15.3.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.sortable (@sortKey) att.declarable (@default) att.typed (@type, @subtype)
Used by
model.listLike model.msItemPart
Contained by
core: add del desc emph head hi item listBibl meeting note p q quote ref title
figures: cell figure
header: change licence rendition sourceDesc tagUsage
textstructure: body div docEdition
May contain
core: bibl biblStruct cb gb head lb listBibl pb
header: biblFull
namesdates: listRelation
Declaration
element listBibl { tei_att.global.attributes, tei_att.sortable.attributes, tei_att.declarable.attributes, tei_att.typed.attributes, ( model.headLike*, ( model.biblLike | model.milestoneLike | listBibl )+ ) }
Example
<listBibl>  <head>Works consulted</head>  <bibl>Blain, Clements and Grundy: Feminist Companion to    Literature in English (Yale, 1990)  </bibl>  <biblStruct>   <analytic>    <title>The Interesting story of the Children in the Wood</title>   </analytic>   <monogr>    <title>The Penny Histories</title>    <author>Victor E Neuberg</author>    <imprint>     <publisher>OUP</publisher>     <date>1968</date>    </imprint>   </monogr>  </biblStruct> </listBibl>

1.63. <listChange>

<listChange> groups a number of change descriptions associated with either the creation of a source text or the revision of an encoded text.
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.sortable (@sortKey)
orderedindicates whether the ordering of its child <change> elements is to be considered significant or not
Status Optional
Datatype
data.truthValue
Used by
Contained by
header: listChange revisionDesc
May contain
header: change listChange
Declaration
element listChange { tei_att.global.attributes, tei_att.sortable.attributes, attribute ordered { data.truthValue }?, ( listChange | change )+ }
Example
<revisionDesc>  <listChange>   <change when="1991-11-11" who="#LB"> deleted chapter 10 </change>   <change when="1991-11-02" who="#MSM"> completed first draft </change>  </listChange> </revisionDesc>
Example
<profileDesc>  <creation>   <listChange ordered="true">    <change xml:id="CHG-1">First stage, written in ink by a writer</change>    <change xml:id="CHG-2">Second stage, written in Goethe's hand using pencil</change>    <change xml:id="CHG-3">Fixation of the revised passages and further revisions by        Goethe using ink</change>    <change xml:id="CHG-4">Addition of another stanza in a different hand,        probably at a later stage</change>   </listChange>  </creation> </profileDesc>
NoteWhen this element appears within the <creation> element it documents the set of revision campaigns or stages identified during the evolution of the original text. When it appears within the <revisionDesc> element, it documents only changes made during the evolution of the encoded representation of that text.

1.64. <listRelation>

<listRelation> provides information about relationships identified amongst people, places, and organizations, either informally as prose or as formally expressed relation links. [15.2.2. ]
Modulenamesdates
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype) att.sortable (@sortKey)
Used by
model.biblLike
Contained by
core: add del desc emph head hi item listBibl meeting note p q quote ref title
figures: cell figure
header: change licence rendition sourceDesc tagUsage
textstructure: body div docEdition
May contain
core: p
Declaration
element listRelation { tei_att.global.attributes, tei_att.typed.attributes, tei_att.sortable.attributes, ( model.pLike+ ) }
Example
<listPerson>  <person xml:id="pp1"/>  <person xml:id="pp2"/> </listPerson> <listRelation type="personal">  <relation active="#pp1 #pp2" name="parent" passive="#pp3 #pp4"/>  <relation mutual="#pp1 #pp2" name="spouse"/> </listRelation> <listRelation type="social">  <relation active="#pp1" name="employer" passive="#pp3 #pp5 #pp6 #pp7"/> </listRelation>
The persons with identifiers pp1 and p2 are the parents of pp3 and pp4; they are also married to each other; pp1 is the employer of pp3, pp5, pp6, and pp7.
Example
<listRelation>  <p>All speakers are members of the Ceruli family, born in Naples.</p> </listRelation>
Note May contain a prose description organized as paragraphs, or a sequence of <relation> elements.

1.65. <m>

<m> (morpheme) represents a grammatical morpheme. [17.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
baseFormidentifies the morpheme's base form.
Status Optional
Datatype
data.word
Values a string of characters representing the spelling of the morpheme's base form.
Used by
model.segLike
Contained by
analysis: cl m phr s w
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c interp interpGrp m span spanGrp
core: cb gb lb note pb
figures: figure notatedMusic
Declaration
element m { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, attribute baseForm { data.word }?, ( text | model.gLike | seg | m | c | model.global )* }
Example
<w type="adjective">  <w type="noun">   <m baseForm="con" type="prefix">com</m>   <m type="root">fort</m>  </w>  <m type="suffix">able</m> </w>
Note The type attribute may be used to indicate the type of morpheme, taking values such as clitic, prefix, stem, etc. as appropriate.

1.66. <meeting>

<meeting> contains the formalized descriptive title for a meeting or conference, for use in a bibliographic description for an item derived from such a meeting, or as a heading or preamble to publications emanating from it. [3.11.2.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.divWrapper model.respLike
Contained by
core: bibl list monogr
header: titleStmt
textstructure: body div group
May contain
core: abbr address bibl biblStruct choice date desc email emph expan hi label list listBibl name num ptr q quote ref term time title
figures: table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element meeting { tei_att.global.attributes, macro.limitedContent }
Example
<div>  <meeting>Ninth International Conference on Middle High German Textual Criticism, Aachen,    June 1998.</meeting>  <list type="attendance">   <head>List of Participants</head>   <item>    <persName>...</persName>   </item>   <item>    <persName>...</persName>   </item>  </list>  <p>...</p> </div>

1.67. <monogr>

<monogr> (monographic level) contains bibliographic elements describing an item (e.g. a book or journal) published as an independent item (i.e. as a separate physical object). [3.11.2.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
core: biblStruct
May contain
core: author biblScope editor imprint meeting note ref textLang title
header: idno
Declaration
element monogr { tei_att.global.attributes, ( ( ( ( author | editor ), ( author | editor )*, title+, ( idno | textLang | editor )* ) | ( ( title | ref )+, ( idno | textLang | author | editor )* ) )?, ( model.noteLike | meeting )*, ( edition, ( idno | editor )* )*, imprint, ( imprint | extent | biblScope )* ) }
Example
<biblStruct>  <analytic>   <author>Chesnutt, David</author>   <title>Historical Editions in the States</title>  </analytic>  <monogr>   <title level="j">Computers and the Humanities</title>   <imprint>    <biblScope>25.6</biblScope>    <date when="1991-12">(December, 1991):</date>    <biblScope>377–380</biblScope>   </imprint>  </monogr> </biblStruct>
Example
<biblStruct type="book">  <monogr>   <author>    <persName>     <forename>Leo Joachim</forename>     <surname>Frachtenberg</surname>    </persName>   </author>   <title level="m" type="main">Lower Umpqua Texts</title>   <imprint>    <pubPlace>New York</pubPlace>    <publisher>Columbia University Press</publisher>    <date>1914</date>   </imprint>  </monogr>  <series>   <title level="s" type="main">Columbia University Contributions to      Anthropology</title>   <biblScope type="vol">4</biblScope>  </series> </biblStruct>
Note May contain specialized bibliographic elements, in a prescribed order. The <monogr> element may only occur only within a <biblStruct>, where its use is mandatory for the description of an monographic level bibliographic item.

1.68. <name>

<name> (name, proper noun) contains a proper noun or noun phrase. [3.5.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype)
Used by
model.nameLike.agent
Contained by
analysis: cl phr s span
core: abbr add addrLine address author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element name { tei_att.global.attributes, tei_att.naming.attributes, tei_att.typed.attributes, macro.phraseSeq }
Example
<name type="person">Thomas Hoccleve</name> <name type="place">Villingaholt</name> <name type="org">Vetus Latina Institut</name> <name ref="#HOC001" type="person">Occleve</name>
Note Proper nouns referring to people, places, and organizations may be tagged instead with <persName>, <placeName>, or <orgName>, when the TEI module for names and dates is included.

1.69. <namespace>

<namespace> supplies the formal name of the namespace to which the elements documented by its children belong. [2.3.4. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
namethe full formal name of the namespace concerned.
Status Required
Datatype
data.namespace
Used by
Contained by
header: tagsDecl
May contain
header: tagUsage
Declaration
element namespace { tei_att.global.attributes, attribute name { data.namespace }, tagUsage+ }
Example
<namespace name="http://www.tei-c.org/ns/1.0">  <tagUsage    gi="hi"    occurs="28"    render="#it"    withId="2"> Used only to mark English words    italicised in the copy text </tagUsage> </namespace>

1.70. <normalization>

<normalization> indicates the extent of normalization or regularization of the original source carried out in converting it to electronic form. [2.3.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
sourceindicates the authority for any normalization carried out.
Status Optional
Datatype
data.pointer
Values Points to a bibliographic description or other resource documenting the principles underlying the normalization which has been applied.
methodindicates the method adopted to indicate normalizations within the text.
Status Optional
Legal values are:
silent
normalization made silently [Default]
markup
normalization represented using markup
Used by
model.editorialDeclPart
Contained by
header: editorialDecl
May contain
core: p
Declaration
element normalization { tei_att.global.attributes, tei_att.declarable.attributes, attribute source { data.pointer }?, attribute method { "silent" | "markup" }?, model.pLike+ }
Example
<editorialDecl>  <normalization method="markup">   <p>Where both upper- and lower-case i, j, u, v, and vv have been normalized, to modern      20th century typographical practice, the <gi>choice</gi> element has been used to      enclose <gi>orig</gi> and <gi>reg</gi> elements giving the original and new values      respectively. ... </p>  </normalization>  <normalization method="silent">   <p>Spacing between words and following punctuation has been regularized to zero spaces;      spacing between words has been regularized to one space.</p>  </normalization>  <normalization source="http://www.dict.sztaki.hu/webster">   <p>Spelling converted throughout to Modern American usage, based on Websters 9th      Collegiate dictionary.</p>  </normalization> </editorialDecl>

1.71. <notatedMusic>

<notatedMusic> encodes the presence of music notation in a text
Modulefigures
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.placement (@place) att.typed (@type, @subtype)
Used by
model.global
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
core: desc graphic label ptr ref
Declaration
element notatedMusic { tei_att.global.attributes, tei_att.placement.attributes, tei_att.typed.attributes, ( model.labelLike | model.ptrLike | graphic )* }
Example
<notatedMusic>  <ptr target="bar1.xml"/>  <graphic url="bar1.jpg"/>  <desc>First bar of Chopin's Scherzo No.3 Op.39</desc> </notatedMusic>
Note It is possible to describe the content of the notation using elements from the model.labelLike class and it is possible to point to an external representation using elements from model.ptrLike. It is possible to specify the location of digital objects representing the notated music in other media such as images or audio-visual files. The encoder's interpretation of the correspondence between the notated music and these digital objects is not encoded explicitly. We recommend the use of graphic and binaryObject mainly as a fallback mechanism when the notated music format is not displayable by the application using the encoding. The alignment of encoded notated music, images carrying the notation, and audio files is a complex matter for which we refer the encoder to other formats and specifications such as MPEG-SMR.

1.72. <note>

<note> contains a note or annotation. [3.8.1. 2.2.6. 3.11.2.6. 9.3.5.4. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.placement (@place) att.pointing (@target, @evaluate) att.responsibility (@cert, @resp) att.typed (@type, @subtype)
anchoredindicates whether the copy text shows the exact place of reference for the note.
Status Optional
Datatype
data.truthValue
Note In modern texts, notes are usually anchored by means of explicit footnote or endnote symbols. An explicit indication of the phrase or line annotated may however be used instead (e.g. ‘page 218, lines 3–4’). The anchored attribute indicates whether any explicit location is given, whether by symbol or by prose cross-reference. The value true indicates that such an explicit location is indicated in the copy text; the value false indicates that the copy text does not indicate a specific place of attachment for the note. If the specific symbols used in the copy text at the location the note is anchored are to be recorded, use the n attribute.
targetEndpoints to the end of the span to which the note is attached, if the note is not embedded in the text at that point.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values reference to the xml:id(s) of element(s) which end at the location(s) in question, or to an empty element at the point in question.
Note This attribute is retained for backwards compatibility; it may be removed at a subsequent release of the Guidelines. The recommended way of pointing to a span of elements is by means of the range function of XPointer, as further described in 16.2.4.4. .
Used by
model.noteLike
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope biblStruct date del editor email emph expan head headItem headLabel hi imprint item label list monogr name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence notesStmt
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num p pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element note { tei_att.global.attributes, tei_att.placement.attributes, tei_att.pointing.attributes, tei_att.responsibility.attributes, tei_att.typed.attributes, attribute anchored { data.truthValue }?, attribute targetEnd { list { data.pointer, data.pointer* } }?, macro.specialPara }
Example In the following example, the translator has supplied a footnote containing an explanation of the term translated as "painterly":
And yet it is not only in the great line of Italian renaissance art, but even in the painterly <note place="bottom" resp="#MDMH" type="gloss">  <term xml:lang="de">Malerisch</term>. This word has, in the German, two distinct meanings, one objective, a quality residing in the object, the other subjective, a mode of apprehension and creation. To avoid confusion, they have been distinguished in English as <mentioned>picturesque</mentioned> and <mentioned>painterly</mentioned> respectively. </note> style of the Dutch genre painters of the seventeenth century that drapery has this psychological significance.
For this example to be valid, the code MDMH must be defined elsewhere, for example by means of a responsibility statement in the associated TEI Header:
<respStmt xml:id="MDMH">  <resp>translation from German to English</resp>  <name>Hottinger, Marie Donald Mackie</name> </respStmt>
Example The global n attribute may be used to supply the symbol or number used to mark the note's point of attachment in the source text, as in the following example:
Mevorakh b. Saadya's mother, the matriarch of the family during the second half of the eleventh century, <note anchored="true" n="126"> The alleged mention of Judah Nagid's mother in a letter from 1071 is, in fact, a reference to Judah's children; cf. above, nn. 111 and 54. </note> is well known from Geniza documents published by Jacob Mann.
However, if notes are numbered in sequence and their numbering can be reconstructed automatically by processing software, it may well be considered unnecessary to record the note numbers.

1.73. <notesStmt>

<notesStmt> (notes statement) collects together any notes providing information about a text additional to that recorded in other parts of the bibliographic description. [2.2.6. 2.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
header: biblFull fileDesc
May contain
core: note
Declaration
element notesStmt { tei_att.global.attributes, model.noteLike+ }
Example
<notesStmt>  <note>Historical commentary provided by Mark Cohen</note>  <note>OCR scanning done at University of Toronto</note> </notesStmt>
Note Information of different kinds should not be grouped together into the same note.

1.74. <num>

<num> (number) contains a number, written in any form. [3.5.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.ranging (@atLeast, @atMost, @min, @max, @confidence)
typeindicates the type of numeric value.
Status Optional
Datatype
data.enumerated
Suggested values include:
cardinal
absolute number, e.g. 21, 21.5
ordinal
ordinal number, e.g. 21st
fraction
fraction, e.g. one half or three-quarters
percentage
a percentage
Note If a different typology is desired, other values can be used for this attribute.
valuesupplies the value of the number in standard form.
Status Optional
Datatype
data.numeric
Values a numeric value.
Note The standard form used is defined by the TEI datatype data.numeric.
Used by
model.measureLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element num { tei_att.global.attributes, tei_att.ranging.attributes, attribute type { "cardinal" | "ordinal" | "fraction" | "percentage" | xsd:Name }?, attribute value { data.numeric }?, macro.phraseSeq }
Example
<p>I reached <num type="cardinal" value="21">twenty-one</num> on my <num type="ordinal" value="21">twenty-first</num> birthday</p> <p>Light travels at <num value="3E10">3×10<hi rend="sup">10</hi>  </num> cm per second.</p>
Note Detailed analyses of quantities and units of measure in historical documents may also use the feature structure mechanism described in chapter 18. . The <num> element is intended for use in simple applications.

1.75. <p>

<p> (paragraph) marks paragraphs in prose. [3.1. 7.2.5. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls)
Used by
model.availabilityPart model.pLike
Contained by
core: item note q quote
figures: figure
header: application availability cRefPattern change editorialDecl encodingDesc hyphenation licence normalization projectDesc publicationStmt quotation refsDecl samplingDecl segmentation seriesStmt sourceDesc
namesdates: listRelation
textstructure: body div
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element p { tei_att.global.attributes, tei_att.declaring.attributes, macro.paraContent }
Example
<p>Hallgerd was outside. <q>There is blood on your axe,</q> she said. <q>What have you    done?</q> </p> <p>  <q>I have now arranged that you can be married a second time,</q> replied Thjostolf. </p> <p>  <q>Then you must mean that Thorvald is dead,</q> she said. </p> <p>  <q>Yes,</q> said Thjostolf. <q>And now you must think up some plan for me.</q> </p>

1.76. <pb/>

<pb/> (page break) marks the boundary between one page of a text and the next in a standard reference system. [3.10.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype) att.sourced (@ed) att.spanning (@spanTo) att.breaking (@break)
Used by
model.milestoneLike
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list listBibl name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May containEmpty element
Declaration
element pb { tei_att.global.attributes, tei_att.typed.attributes, tei_att.sourced.attributes, tei_att.spanning.attributes, tei_att.breaking.attributes, empty }
Example Page numbers may vary in different editions of a text.
<p> ... <pb ed="ed2" n="145"/> ... <pb ed="ed1" n="283"/> ... </p>
Example A page break may be associated with a facsimile image of the page it introduces by means of the facs attribute
<body>  <pb facs="page1.png" n="1"/>  <p/>  <pb facs="page2.png" n="2"/>  <p/> </body>
Note By convention, <pb> elements should appear at the start of the page to which they refer. The global n attribute indicates the number or other value associated with the page which follows. This will normally be the page number or signature printed on it, since the physical sequence number is implicit in the presence of the <pb> element itself. The type attribute may be used to characterize the page break in any respect, for example as word-breaking or not.

1.77. <pc>

<pc> (punctuation character) a character or string of characters regarded as constituting a single punctuation mark. [17.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
forceindicates the extent to which this punctuation mark conventionally separates words or phrases
Status Optional
Datatype
data.enumerated
Legal values are:
strong
the punctuation mark is a word separator
weak
the punctuation mark is not a word separator
inter
the punctuation mark may or may not be a word separator
unitprovides a name for the kind of unit delimited by this punctuation mark.
Status Optional
Datatype
data.enumerated
preindicates whether this punctuation mark precedes or follows the unit it delimits.
Status Optional
Datatype
data.truthValue
Used by
model.segLike
Contained by
analysis: cl phr s
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c
Declaration
element pc { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, attribute force { "strong" | "weak" | "inter" }?, attribute unit { data.enumerated }?, attribute pre { data.truthValue }?, ( text | model.gLike | c )* }
Example
<phr>  <w>do</w>  <w>you</w>  <w>understand</w>  <pc type="interrogative">?</pc> </phr>
Note .

1.78. <persName>

<persName> (personal name) contains a proper noun or proper-noun phrase referring to a person, possibly including any or all of the person's forenames, surnames, honorifics, added names, etc. [13.2.1. ]
Modulenamesdates
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Used by
model.nameLike.agent model.persStateLike
Contained by
analysis: cl phr s span
core: abbr add addrLine address author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element persName { tei_att.global.attributes, tei_att.datable.attributes, tei_att.editLike.attributes, tei_att.personal.attributes, tei_att.typed.attributes, macro.phraseSeq }
Example
<persName>  <forename>Edward</forename>  <forename>George</forename>  <surname type="linked">Bulwer-Lytton</surname>, <roleName>Baron Lytton of  <placeName>Knebworth</placeName>  </roleName> </persName>

1.79. <phr>

<phr> (phrase) represents a grammatical phrase. [17.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
Used by
model.segLike
Contained by
analysis: cl phr s
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element phr { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, macro.phraseSeq }
Example
<phr function="extraposted_modifier" type="verb">To talk <phr function="complement" type="preposition">of <phr function="object" type="noun">many things</phr>  </phr> </phr>
Note The type attribute may be used to indicate the type of phrase, taking values such as noun, verb, preposition, etc. as appropriate.

1.80. <postBox>

<postBox> (postal box or post office box) contains a number or other identifier for some postal delivery point other than a street address. [3.5.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.addrPart
Contained by
core: address
May containCharacter data only
Declaration
element postBox { tei_att.global.attributes, text }
Example
<postBox>P.O. Box 280</postBox>
Example
<postBox>Postbus 532</postBox>
Note The position and nature of postal codes is highly country-specific; the conventions appropriate to the country concerned should be used.

1.81. <postCode>

<postCode> (postal code) contains a numerical or alphanumeric code used as part of a postal address to simplify sorting or delivery of mail. [3.5.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.addrPart
Contained by
core: address
May containCharacter data only
Declaration
element postCode { tei_att.global.attributes, text }
Example
<postCode>HR1 3LR</postCode>
Example
<postCode>60142-7</postCode>
Note The position and nature of postal codes is highly country-specific; the conventions appropriate to the country concerned should be used.

1.82. <projectDesc>

<projectDesc> (project description) describes in detail the aim or purpose for which an electronic file was encoded, together with any other relevant information concerning the process by which it was assembled or collected. [2.3.1. 2.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
Used by
model.encodingDescPart
Contained by
header: encodingDesc
May contain
core: p
Declaration
element projectDesc { tei_att.global.attributes, tei_att.declarable.attributes, model.pLike+ }
Example
<projectDesc>  <p>Texts collected for use in the Claremont Shakespeare Clinic, June 1990</p> </projectDesc>

1.83. <ptr/>

<ptr/> (pointer) defines a pointer to another location. [3.6. 16.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.pointing (@target, @evaluate) att.internetMedia (@mimeType) att.typed (@type, @subtype) att.declaring (@decls)
cRef(canonical reference) specifies the destination of the pointer by supplying a canonical reference from a scheme defined in a <refsDecl> element in the TEI header
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values the value of cRef should be constructed so that when the algorithm for the resolution of canonical references (described in section 16.2.5. ) is applied to it the result is a valid URI reference to the intended target
Note The <refsDecl> to use may be indicated with the decls attribute. Currently these Guidelines only provide for a single canonical reference to be encoded on any given <ptr> element.
Used by
model.ptrLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell notatedMusic
header: application change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May containEmpty element
Declaration
element ptr { tei_att.global.attributes, tei_att.pointing.attributes, tei_att.internetMedia.attributes, tei_att.typed.attributes, tei_att.declaring.attributes, attribute cRef { list { data.word, data.word* } }?, empty }
Schematron
<s:report test="@target and @cRef">Only one of the attributes 'target' and 'cRef' may be supplied.</s:report>
Example
<ptr target="#p143 #p144"/> <ptr target="http://www.tei-c.org"/>

1.84. <pubPlace>

<pubPlace> (publication place) contains the name of the place where a bibliographic item was published. [3.11.2.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Used by
model.imprintPart model.publicationStmtPart
Contained by
core: bibl imprint
header: publicationStmt
textstructure: docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element pubPlace { tei_att.global.attributes, tei_att.naming.attributes, macro.phraseSeq }
Example
<publicationStmt>  <publisher>Oxford University Press</publisher>  <pubPlace>Oxford</pubPlace>  <date>1989</date> </publicationStmt>

1.85. <publicationStmt>

<publicationStmt> (publication statement) groups information concerning the publication or distribution of an electronic or other text. [2.2.4. 2.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
header: biblFull fileDesc
May contain
core: address date p pubPlace publisher
header: availability idno
Declaration
element publicationStmt { tei_att.global.attributes, ( model.pLike+ | model.publicationStmtPart+ ) }
Example
<publicationStmt>  <publisher>C. Muquardt </publisher>  <pubPlace>Bruxelles &amp; Leipzig</pubPlace>  <date when="1846"/> </publicationStmt>
Example
<publicationStmt>  <publisher>Chadwyck Healey</publisher>  <pubPlace>Cambridge</pubPlace>  <availability>   <p>Available under licence only</p>  </availability>  <date when="1992">1992</date> </publicationStmt>
Note Although not enforced by the schemas, it is a requirement for TEI conformance that information about publication place, address, identifier, availability, and date be given in that order, following the name of the publisher, distributor, or authority concerned

1.86. <publisher>

<publisher> provides the name of the organization responsible for the publication or distribution of a bibliographic item. [3.11.2.3. 2.2.4. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.imprintPart model.publicationStmtPart
Contained by
core: bibl imprint
header: publicationStmt
textstructure: docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element publisher { tei_att.global.attributes, macro.phraseSeq }
Example
<imprint>  <pubPlace>Oxford</pubPlace>  <publisher>Clarendon Press</publisher>  <date>1987</date> </imprint>
Note Use the full form of the name by which a company is usually referred to, rather than any abbreviation of it which may appear on a title page

1.87. <q>

<q> (separated from the surrounding text with quotation marks) contains material which is marked as (ostensibly) being somehow different than the surrounding text, for any one of a variety of reasons including, but not limited to: direct speech or thought, technical terms or jargon, authorial distance, quotations from elsewhere, and passages that are mentioned but not used. [3.3.3. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.ascribed (@who)
typemay be used to indicate whether the offset passage is spoken or thought, or to characterize it more finely.
Status Optional
Datatype
data.enumerated
Suggested values include:
spoken
representation of speech
thought
representation of thought, e.g. internal monologue
written
quotation from a written source
soCalled
authorial distance
foreign
(foreign words)
distinct
(linguistically distinct)
term
(technical term)
emph
(rhetorically emphasized)
mentioned
refering to itself, not its normal referant
Used by
model.qLike
Contained by
core: add del desc emph head hi item meeting note p q quote ref title
figures: cell figure
header: change licence rendition tagUsage
textstructure: body div docEdition
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num p pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element q { tei_att.global.attributes, tei_att.ascribed.attributes, attribute type { "spoken" | "thought" | "written" | "soCalled" | "foreign" | "distinct" | "term" | "emph" | "mentioned" | xsd:Name }?, macro.specialPara }
Example
It is spelled <q>Tübingen</q> — to enter the letter <q>u</q> with an umlaut hold down the <q>option</q> key and press <q>0 0 f c</q>
Note May be used to indicate that a passage is distinguished from the surrounding text by quotation marks for reasons concerning which no claim is made. When used in this manner, <q> may be thought of as syntactic sugar for <hi> with a value of rend that indicates the use of quotation marks.

1.88. <quotation>

<quotation> specifies editorial practice adopted with respect to quotation marks in the original. [2.3.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
marks(quotation marks) indicates whether or not quotation marks have been retained as content within the text.
Status Optional
Legal values are:
none
no quotation marks have been retained
some
some quotation marks have been retained
all
all quotation marks have been retained [Default]
formspecifies how quotation marks are indicated within the text.
Status Optional
Note The form attribute is deprecated. Although retained for compatibility, this attribute will be removed at a subsequent release.
Used by
model.editorialDeclPart
Contained by
header: editorialDecl
May contain
core: p
Declaration
element quotation { tei_att.global.attributes, tei_att.declarable.attributes, attribute marks { "none" | "some" | "all" }?, attribute form { text }?, model.pLike+ }
Example
<quotation marks="none">  <p>No quotation marks have been retained. Instead, the <att>rend</att> attribute on the  <gi>q</gi> element is used to specify what kinds of quotation mark was used, according    to the following list: <list type="gloss">    <label>dq</label>    <item>double quotes, open and close</item>    <label>sq</label>    <item>single quotes, open and close</item>    <label>dash</label>    <item>long dash open, no close</item>    <label>dg</label>    <item>double guillemets, open and close</item>   </list>  </p> </quotation>
Example
<quotation marks="all">  <p>All quotation marks are retained in the text and are represented by appropriate Unicode    characters.</p> </quotation>

1.89. <quote>

<quote> (quotation) contains a phrase or passage attributed by the narrator or author to some agency external to the text. [3.3.3. 4.3.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.typed (@type, @subtype)
Used by
model.quoteLike
Contained by
core: add del desc emph head hi item meeting note p q quote ref title
figures: cell figure
header: change licence rendition tagUsage
textstructure: body div docEdition
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num p pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element quote { tei_att.global.attributes, tei_att.typed.attributes, macro.specialPara }
Example
Lexicography has shown little sign of being affected by the work of followers of J.R. Firth, probably best summarized in his slogan, <quote>You shall know a word by the company it keeps</quote> <ref>(Firth, 1957)</ref>
Note If a bibliographic citation is supplied for the source of a quotation, the two may be grouped using the <cit> element.

1.90. <ref>

<ref> (reference) defines a reference to another location, possibly modified by additional text or comment. [3.6. 16.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.pointing (@target, @evaluate) att.internetMedia (@mimeType) att.typed (@type, @subtype) att.declaring (@decls)
cRef(canonical reference) specifies the destination of the reference by supplying a canonical reference from a scheme defined in a <refsDecl> element in the TEI header
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values the value of cRef should be constructed so that when the algorithm for the resolution of canonical references (described in section 16.2.5. ) is applied to it the result is a valid URI reference to the intended target
Note The <refsDecl> to use may be indicated with the decls attribute. Currently these Guidelines only provide for a single canonical reference to be encoded on any given <ref> element.
Used by
model.ptrLike
Contained by
analysis: cl phr s span
core: abbr add addrLine analytic author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting monogr name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell notatedMusic
header: application change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element ref { tei_att.global.attributes, tei_att.pointing.attributes, tei_att.internetMedia.attributes, tei_att.typed.attributes, tei_att.declaring.attributes, attribute cRef { list { data.word, data.word* } }?, macro.paraContent }
Schematron
<s:report test="@target and @cRef">Only one of the attributes 'target' and 'cRef' may be supplied.</s:report>
Example
<ref   target="http://www.natcorp.ox.ac.uk/Texts/A02.xml#s2"> See especially the second sentence</ref> See also <ref>s.v. <term>locution</term> </ref>.
Note The target and cRef attributes are mutually exclusive.

1.91. <refState/>

<refState/> (reference state) specifies one component of a canonical reference defined by the milestone method. [2.3.5.3. 2.3.5. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.sourced (@ed)
unitindicates what kind of state is changing at this milestone.
Status Required
Datatype
data.enumerated
Suggested values include:
page
page breaks in the reference edition.
column
column breaks.
line
line breaks.
book
any units termed book, liber, etc.
poem
individual poems in a collection.
canto
cantos or other major sections of a poem.
stanza
stanzas within a poem, book, or canto.
act
acts within a play.
scene
scenes within a play or act.
section
sections of any kind.
absent
passages not present in the reference edition.
lengthspecifies the fixed length of the reference component.
Status Optional
Datatype
data.count
Values Should be a positive integer; if no value is provided, the length is unlimited and goes to the next delimiter or to the end of the value.
Note When constructing a reference, if the reference component found is of numeric type, the length is made up by inserting leading zeros; if it is not, by inserting trailing blanks. In either case, reference components are truncated if necessary at the right hand side. When seeking a reference, the length indicates the number of characters which should be compared. Values longer than this will be regarded as matching, if they start correctly.
delim(delimiter) supplies a delimiting string following the reference component.
Status Optional
Datatype
text
Values If a single space is used it is interpreted as whitespace.
Used by
Contained by
header: refsDecl
May containEmpty element
Declaration
element refState { tei_att.global.attributes, tei_att.sourced.attributes, attribute unit { "page" | "column" | "line" | "book" | "poem" | "canto" | "stanza" | "act" | "scene" | "section" | "absent" | xsd:Name }, attribute length { data.count }?, attribute delim { text }?, empty }
Example
<refState delim=":" unit="book"/> <refState length="4" unit="line"/>

1.92. <refsDecl>

<refsDecl> (references declaration) specifies how canonical references are constructed for this text. [2.3.5.3. 2.3. 2.3.5. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
Used by
model.encodingDescPart
Contained by
header: encodingDesc
May contain
core: p
header: cRefPattern refState
Declaration
element refsDecl { tei_att.global.attributes, tei_att.declarable.attributes, ( model.pLike+ | cRefPattern+ | refState+ ) }
Example
<refsDecl>  <cRefPattern    matchPattern="([A-Za-z0-9]+) ([0-9]+):([0-9]+)"    replacementPattern="#xpath(//body/div[@n='$1']/div[$2]/div3[$3])"/> </refsDecl>
This example is a formal representation for the referencing scheme described informally in the following example.
Example
<refsDecl>  <p>References are made up by concatenating the value for the  <att>n</att> attribute on the highest level <gi>div</gi>    element, followed by a space, followed by the sequential    number of the next level <gi>div</gi> followed by a colon    followed by the sequential number of the next (and lowest)    level <gi>div</gi>.</p> </refsDecl>

1.93. <rendition>

<rendition> supplies information about the rendition or appearance of one or more elements in the source text. [2.3.4. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
schemeidentifies the language used to describe the rendition.
Status Optional
Legal values are:
css
Cascading Stylesheet Language
xslfo
Extensible Stylesheet Language Formatting Objects
free
Informal free text description
other
A user-defined rendition description language
scopewhere CSS is used, provides a way of defining ‘pseudo-elements’, that is, styling rules applicable to specific sub-portions of an element.
Status Optional
Sample values include
first-line
styling applies to the first line of the target element
first-letter
styling applies to the first letter of the target element
before
styling should be applied immediately before the content of the target element
after
styling should be applied immediately after the content of the target element
Used by
Contained by
header: tagsDecl
May contain
core: abbr address bibl biblStruct choice date desc email emph expan hi label list listBibl name num ptr q quote ref term time title
figures: table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element rendition { tei_att.global.attributes, attribute scheme { "css" | "xslfo" | "free" | "other" }?, attribute scope { text }?, macro.limitedContent }
Example
<tagsDecl>  <rendition scheme="css" xml:id="r-center">text-align: center;</rendition>  <rendition scheme="css" xml:id="r-small">font-size: small;</rendition>  <rendition scheme="css" xml:id="r-large">font-size: large;</rendition>  <rendition scheme="css" scope="first-letter" xml:id="initcaps">font-size: xx-large</rendition> </tagsDecl>
Note The present release of these Guidelines does not specify the content of this element in any further detail. It may be used to hold a description of the default rendition to be associated with the specified element, expressed in running prose, or in some more formal language such as CSS.

1.94. <revisionDesc>

<revisionDesc> (revision description) summarizes the revision history for a file. [2.5. 2.1.1. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.docStatus (@status)
Used by
Contained by
header: teiHeader
May contain
core: list
header: change listChange
Declaration
element revisionDesc { tei_att.global.attributes, tei_att.docStatus.attributes, ( list | listChange | change+ ) }
Example
<revisionDesc status="embargoed">  <change when="1991-11-11" who="#LB"> deleted chapter 10 </change> </revisionDesc>
Note If present on this element, the status attribute should indicate the current status of the document. The same attribute may appear on any <change> to record the status at the time of that change. Conventionally change elements should be given in reverse date order, with the most recent change at the start of the list.

1.95. <row>

<row> contains one row of a table. [14.1.1. ]
Modulefigures
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.tableDecoration (@role, @rows, @cols)
Used by
Contained by
figures: table
May contain
figures: cell
Declaration
element row { tei_att.global.attributes, tei_att.tableDecoration.attributes, cell+ }
Example
<row role="data">  <cell role="label">Classics</cell>  <cell>Idle listless and unimproving</cell> </row>

1.96. <s>

<s> (s-unit) contains a sentence-like division of a text. [17.1. 8.4.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
Used by
model.segLike
Contained by
analysis: cl phr s
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element s { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, macro.phraseSeq }
Schematron
<s:report test="tei:s">You may not nest one s element within another: use seg instead</s:report>
Example
<head>  <s>A short affair</s> </head> <s>When are you leaving?</s> <s>Tomorrow.</s>
Note The <s> element may be used to mark orthographic sentences, or any other segmentation of a text, provided that the segmentation is end-to-end, complete, and non-nesting. For segmentation which is partial or recursive, the <seg> should be used instead. The type attribute may be used to indicate the type of segmentation intended, according to any convenient typology.

1.97. <samplingDecl>

<samplingDecl> (sampling declaration) contains a prose description of the rationale and methods used in sampling texts in the creation of a corpus or collection. [2.3.2. 2.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
Used by
model.encodingDescPart
Contained by
header: encodingDesc
May contain
core: p
Declaration
element samplingDecl { tei_att.global.attributes, tei_att.declarable.attributes, model.pLike+ }
Example
<samplingDecl>  <p>Samples of up to 2000 words taken at random from the beginning, middle, or end of each    text identified as relevant by respondents.</p> </samplingDecl>
Note This element records all information about systematic inclusion or omission of portions of the text, whether a reflection of sampling procedures in the pure sense or of systematic omission of material deemed either too difficult to transcribe or not of sufficient interest.

1.98. <segmentation>

<segmentation> describes the principles according to which the text has been segmented, for example into sentences, tone-units, graphemic strata, etc. [2.3.3. 15.3.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
Used by
model.editorialDeclPart
Contained by
header: editorialDecl
May contain
core: p
Declaration
element segmentation { tei_att.global.attributes, tei_att.declarable.attributes, model.pLike+ }
Example
<segmentation>  <p>   <gi>s</gi> elements mark orthographic sentences and are numbered sequentially within    their parent <gi>div</gi> element </p> </segmentation>
Example
<p>  <gi>seg</gi> elements are used to mark functional constituents of various types within each <gi>s</gi>; the typology used is defined by a <gi>taxonomy</gi> element in the corpus header <gi>classDecl</gi> </p>

1.99. <series>

<series> (series information) contains information about the series in which a book or other bibliographic item has appeared. [3.11.2.1. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.biblPart
Contained by
core: bibl biblStruct
May contain
analysis: interp interpGrp span spanGrp
core: biblScope cb editor gb lb note pb ref textLang title
figures: figure notatedMusic
header: idno
Declaration
element series { tei_att.global.attributes, ( text | model.gLike | title | ref | editor | biblScope | idno | textLang | model.global )* }
Example
<series xml:lang="de">  <title level="s">Halbgraue Reihe zur Historischen Fachinformatik</title>  <respStmt>   <resp>Herausgegeben von</resp>   <name type="person">Manfred Thaller</name>   <name type="org">Max-Planck-Institut für Geschichte</name>  </respStmt>  <title level="s">Serie A: Historische Quellenkunden</title>  <biblScope>Band 11</biblScope> </series>

1.100. <seriesStmt>

<seriesStmt> (series statement) groups information about the series, if any, to which a publication belongs. [2.2.5. 2.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
header: biblFull fileDesc
May contain
core: biblScope editor p title
header: idno
Declaration
element seriesStmt { tei_att.global.attributes, ( model.pLike+ | ( title+, editor*, ( idno | biblScope )* ) ) }
Example
<seriesStmt>  <title>Machine-Readable Texts for the Study of Indian Literature</title>  <respStmt>   <resp>ed. by</resp>   <name>Jan Gonda</name>  </respStmt>  <biblScope type="vol">1.2</biblScope>  <idno type="ISSN">0 345 6789</idno> </seriesStmt>

1.101. <sourceDesc>

<sourceDesc> (source description) describes the source from which an electronic text was derived or generated, typically a bibliographic description in the case of a digitized text, or a phrase such as "born digital" for a text which has no previous existence. [2.2.7. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declarable (@default)
Used by
Contained by
header: biblFull fileDesc
May contain
core: bibl biblStruct list listBibl p
figures: table
header: biblFull
namesdates: listRelation
Declaration
element sourceDesc { tei_att.global.attributes, tei_att.declarable.attributes, ( model.pLike+ | ( model.biblLike | model.sourceDescPart | model.listLike )+ ) }
Example
<sourceDesc>  <bibl>   <title level="a">The Interesting story of the Children in the Wood</title>. In  <author>Victor E Neuberg</author>, <title>The Penny Histories</title>.  <publisher>OUP</publisher>   <date>1968</date>. </bibl> </sourceDesc>
Example
<sourceDesc>  <p>Born digital: no previous source exists.</p> </sourceDesc>

1.102. <span>

<span> associates an interpretative annotation directly with a span of text. [17.3. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.interpLike (@type, @inst) (att.responsibility (@cert, @resp))
fromspecifies the beginning of the passage being annotated; if not accompanied by a to attribute, then specifies the entire passage.
Status Required
Datatype
data.pointer
Values The identifier of the element which occurs at the beginning of the passage.
tospecifies the end of the passage being annotated.
Status Optional
Datatype
data.pointer
Values The identifier of the element which occurs at the end of the passage.
Used by
model.global.meta
Contained by
analysis: cl m phr s span spanGrp w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
analysis: interp interpGrp span spanGrp
core: abbr address cb choice date email emph expan gb hi lb name note num pb ptr ref term time title
figures: figure notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element span { tei_att.global.attributes, tei_att.interpLike.attributes, attribute from { data.pointer }, attribute to { data.pointer }?, macro.phraseSeq.limited }
Example
<p xml:id="para2">(The "aftermath" starts here)</p> <p xml:id="para3">(The "aftermath" continues here)</p> <p xml:id="para4">(The "aftermath" ends in this paragraph)</p> <span from="#para2" to="#para4" type="structure">aftermath</span>

1.103. <spanGrp>

<spanGrp> (span group) collects together span tags. [17.3. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.interpLike (@type, @inst) (att.responsibility (@cert, @resp))
Used by
model.global.meta
Contained by
analysis: cl m phr s span w
core: abbr add addrLine address author bibl biblScope date del editor email emph expan head headItem headLabel hi imprint item label list name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell figure table
header: change licence
namesdates: affiliation forename persName surname
textstructure: back body div docAuthor docDate docEdition docImprint docTitle front group text
May contain
analysis: span
Declaration
element spanGrp { tei_att.global.attributes, tei_att.interpLike.attributes, span* }
Example
<u xml:id="UU1">Can I have ten oranges and a kilo of bananas please?</u> <u xml:id="UU2">Yes, anything else?</u> <u xml:id="UU3">No thanks.</u> <u xml:id="UU4">That'll be dollar forty.</u> <u xml:id="UU5">Two dollars</u> <u xml:id="UU6">Sixty, eighty, two dollars. <anchor xml:id="UU6e"/>Thank you.<anchor xml:id="UU6f"/> </u> <spanGrp type="transactions">  <span from="#UU1">sale request</span>  <span from="#UU2" to="#UU3">sale compliance</span>  <span from="#UU4">sale</span>  <span from="#UU5" to="#UU6">purchase</span>  <span from="#UU6e" to="#UU6f">purchase closure</span> </spanGrp>

1.104. <street>

<street> a full street address including any name or number identifying a building as well as the name of the street or route on which it is located. [3.5.2. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.addrPart
Contained by
core: address
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element street { tei_att.global.attributes, macro.phraseSeq }
Example
<street>via della Faggiola, 36</street>
Example
<street>  <name>Duntaggin</name>, 110 Southmoor Road </street>
Note The order and presentation of house names and numbers and street names, etc., may vary considerably in different countries. The encoding should reflect the order which is appropriate in the country concerned.

1.105. <surname>

<surname> contains a family (inherited) name, as opposed to a given, baptismal, or nick name. [13.2.1. ]
Modulenamesdates
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Used by
model.persNamePart
Contained by
analysis: cl phr s span
core: abbr add addrLine address author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element surname { tei_att.global.attributes, tei_att.personal.attributes, tei_att.typed.attributes, macro.phraseSeq }
Example
<surname type="combine">St John Stevas</surname>

1.106. <table>

<table> contains text displayed in tabular form, in rows and columns. [14.1.1. ]
Modulefigures
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
rowsindicates the number of rows in the table.
Status Optional
Datatype
data.count
Values If no number is supplied, an application must calculate the number of rows.
Note Rows should be presented from top to bottom.
cols(columns) indicates the number of columns in each row of the table.
Status Optional
Datatype
data.count
Values If no number is supplied, an application must calculate the number of columns.
Note Within each row, columns should be presented left to right.
Used by
model.listLike
Contained by
core: add del desc emph head hi item meeting note p q quote ref title
figures: cell figure
header: change licence rendition sourceDesc tagUsage
textstructure: body div docEdition
May contain
analysis: interp interpGrp span spanGrp
core: cb gb graphic head lb note pb
figures: figure formula notatedMusic row
Declaration
element table { tei_att.global.attributes, attribute rows { data.count }?, attribute cols { data.count }?, ( ( ( model.headLike | model.global )*, ( row, model.global* )+ ) | model.graphicLike+ ) }
Example
<table cols="4" rows="4">  <head>Poor Men's Lodgings in Norfolk (Mayhew, 1843)</head>  <row role="label">   <cell role="data"/>   <cell role="data">Dossing Cribs or Lodging Houses</cell>   <cell role="data">Beds</cell>   <cell role="data">Needys or Nightly Lodgers</cell>  </row>  <row role="data">   <cell role="label">Bury St Edmund's</cell>   <cell role="data">5</cell>   <cell role="data">8</cell>   <cell role="data">128</cell>  </row>  <row role="data">   <cell role="label">Thetford</cell>   <cell role="data">3</cell>   <cell role="data">6</cell>   <cell role="data">36</cell>  </row>  <row role="data">   <cell role="label">Attleboro'</cell>   <cell role="data">3</cell>   <cell role="data">5</cell>   <cell role="data">20</cell>  </row>  <row role="data">   <cell role="label">Wymondham</cell>   <cell role="data">1</cell>   <cell role="data">11</cell>   <cell role="data">22</cell>  </row> </table>
Note Contains an optional heading and a series of rows. Any rendition information should be supplied using the global rend attribute, at the table, row, or cell level as appropriate.

1.107. <tagUsage>

<tagUsage> supplies information about the usage of a specific element within a text. [2.3.4. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
gi(element name) the name (generic identifier) of the element indicated by the tag.
Status Required
Datatype
data.name
Values the name of an element within the namespace indicated by the parent <namespace> element
occursspecifies the number of occurrences of this element within the text.
Status Recommended
Datatype
data.count
Values an integer number greater than zero
withId(with unique identifier) specifies the number of occurrences of this element within the text which bear a distinct value for the global xml:id attribute.
Status Recommended
Datatype
data.count
Values an integer number greater than zero
renderspecifies the identifier of a <rendition> element which defines how this element is to be rendered.
Status Optional
Datatype
data.pointer
Values an identifier specified as the value of the xml:id attribute on some <rendition> element in the current document.
Used by
Contained by
header: namespace
May contain
core: abbr address bibl biblStruct choice date desc email emph expan hi label list listBibl name num ptr q quote ref term time title
figures: table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element tagUsage { tei_att.global.attributes, attribute gi { data.name }, attribute occurs { data.count }?, attribute withId { data.count }?, attribute render { data.pointer }?, macro.limitedContent }
Example
<tagsDecl>  <rendition xml:id="it">Render using a slant or italic variant on the current font</rendition>  <namespace name="http://www.tei-c.org/ns/1.0">   <tagUsage     gi="hi"     occurs="28"     render="#it"     withId="2"> Used to mark English words      italicised in the copy text.</tagUsage>   <tagUsage gi="foreign" render="#it">Used to mark non-English words in the copy text.</tagUsage>  </namespace> </tagsDecl>

1.108. <tagsDecl>

<tagsDecl> (tagging declaration) provides detailed information about the tagging applied to a document. [2.3.4. 2.3. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
model.encodingDescPart
Contained by
header: encodingDesc
May contain
header: namespace rendition
Declaration
element tagsDecl { tei_att.global.attributes, ( rendition*, namespace* ) }
Example
<tagsDecl>  <rendition xml:id="rend-it">to be rendered in italic font</rendition>  <namespace name="http://www.tei-c.org/ns/1.0">   <tagUsage gi="hi" occurs="467" render="#rend-it"/>   <tagUsage gi="title" occurs="45" render="#rend-it"/>  </namespace>  <namespace name="http://docbook.org/ns/docbook">   <tagUsage gi="para" occurs="10"/>  </namespace> </tagsDecl>

1.109. <teiHeader>

<teiHeader> (TEI Header) supplies the descriptive and declarative information making up an electronic title page prefixed to every TEI-conformant text. [2.1.1. 15.1. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
typespecifies the kind of document to which the header is attached, for example whether it is a corpus or individual text.
Status Optional
Datatype
data.enumerated
Sample values include:
text
the header is attached to a single text. [Default]
corpus
the header is attached to a corpus.
Used by
Contained by
textstructure: TEI
May contain
header: encodingDesc fileDesc revisionDesc
Declaration
element teiHeader { tei_att.global.attributes, attribute type { data.enumerated }?, ( fileDesc, model.teiHeaderPart*, revisionDesc? ) }
Example
<teiHeader>  <fileDesc>   <titleStmt>    <title>Shakespeare: the first folio (1623) in electronic form</title>    <author>Shakespeare, William (1564–1616)</author>    <respStmt>     <resp>Originally prepared by</resp>     <name>Trevor Howard-Hill</name>    </respStmt>    <respStmt>     <resp>Revised and edited by</resp>     <name>Christine Avern-Carr</name>    </respStmt>   </titleStmt>   <publicationStmt>    <distributor>Oxford Text Archive</distributor>    <address>     <addrLine>13 Banbury Road, Oxford OX2 6NN, UK</addrLine>    </address>    <idno type="OTA">119</idno>    <availability>     <p>Freely available on a non-commercial basis.</p>    </availability>    <date when="1968">1968</date>   </publicationStmt>   <sourceDesc>    <bibl>The first folio of Shakespeare, prepared by Charlton Hinman (The Norton Facsimile,        1968)</bibl>   </sourceDesc>  </fileDesc>  <encodingDesc>   <projectDesc>    <p>Originally prepared for use in the production of a series of old-spelling        concordances in 1968, this text was extensively checked and revised for use during the        editing of the new Oxford Shakespeare (Wells and Taylor, 1989).</p>   </projectDesc>   <editorialDecl>    <correction>     <p>Turned letters are silently corrected.</p>    </correction>    <normalization>     <p>Original spelling and typography is retained, except that long s and ligatured          forms are not encoded.</p>    </normalization>   </editorialDecl>   <refsDecl xml:id="ASLREF">    <cRefPattern      matchPattern="(\S+) ([^.]+)\.(.*)"      replacementPattern="#xpath(//div1[@n='$1']/div2/[@n='$2']//lb[@n='$3'])">     <p>A reference is created by assembling the following, in the reverse order as that          listed here: <list>       <item>the <att>n</att> value of the preceding <gi>lb</gi>       </item>       <item>a period</item>       <item>the <att>n</att> value of the ancestor <gi>div2</gi>       </item>       <item>a space</item>       <item>the <att>n</att> value of the parent <gi>div1</gi>       </item>      </list>     </p>    </cRefPattern>   </refsDecl>  </encodingDesc>  <revisionDesc>   <list>    <item>     <date when="1989-04-12">12 Apr 89</date> Last checked by CAC</item>    <item>     <date when="1989-03-01">1 Mar 89</date> LB made new file</item>   </list>  </revisionDesc> </teiHeader>
Note One of the few elements unconditionally required in any TEI document.

1.110. <term>

<term> contains a single-word, multi-word, or symbolic designation which is regarded as a technical term. [3.3.4. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls) att.pointing (@target, @evaluate) att.typed (@type, @subtype) att.canonical (@key, @ref) att.sortable (@sortKey)
cRefidentifies the associated <gloss> element using a canonical reference from a scheme defined in a <refsDecl> element in the TEI header
Status Optional
Datatype
data.pointer
Values the result of applying the algorithm for the resolution of canonical references (described in section 16.2.5. ) should be a valid URI reference that resolves to a <gloss> element
Values Le résultat de l'application de l'algorithme pour la résolution de références canoniques (décrites dans la section 16.2.5. ) devrait être une référence à un URI valide réductible à un élément élément<gloss>
Note The <refsDecl> to use may be indicated with the decls attribute.
Used by
model.emphLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element term { tei_att.global.attributes, tei_att.declaring.attributes, tei_att.pointing.attributes, tei_att.typed.attributes, tei_att.canonical.attributes, tei_att.sortable.attributes, attribute cRef { data.pointer }?, macro.phraseSeq }
Example
A computational device that infers structure from grammatical strings of words is known as a <term>parser</term>, and much of the history of NLP over the last 20 years has been occupied with the design of parsers.
Example
We may define <term rend="sc" xml:id="TDPV">discoursal point of view</term> as <gloss target="#TDPV">the relationship, expressed through discourse structure, between the implied author or some other addresser, and the fiction.</gloss>
Note This element is used to supply the form under which an index entry is to be made for the location of a parent <index> element. In formal terminological work, there is frequently discussion over whether terms must be atomic or may include multi-word lexical items, symbolic designations, or phraseological units. The <term> element may be used to mark any of these. No position is taken on the philosophical issue of what a term can be; the looser definition simply allows the <term> element to be used by practitioners of any persuasion. As with other members of the att.canonical class, instances of this element occuring in a text may be associated with a canonical definition, either by means of a URI (using the ref attribute), or by means of some system-specific code value (using the key attribute). Because the mutually exclusive target and cRef attributes overlap with the function of the ref attribute, they are deprecated and may be removed at a subsequent release.

1.111. <text>

<text> contains a single text of any kind, whether unitary or composite, for example a poem or drama, a collection of essays, a novel, a dictionary, or a corpus sample. [4. 15.1. ]
Moduletextstructure
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.declaring (@decls) att.typed (@type, @subtype)
Used by
Contained by
textstructure: TEI group
May contain
analysis: interp interpGrp span spanGrp
core: cb gb lb note pb
figures: figure notatedMusic
textstructure: back body front group
Declaration
element text { tei_att.global.attributes, tei_att.declaring.attributes, tei_att.typed.attributes, ( model.global*, ( front, model.global* )?, ( body | group ), model.global*, ( back, model.global* )? ) }
Example
<text>  <front>   <docTitle>    <titlePart>Autumn Haze</titlePart>   </docTitle>  </front>  <body>   <l>Is it a dragonfly or a maple leaf</l>   <l>That settles softly down upon the water?</l>  </body> </text>
Example The body of a text may be replaced by a group of nested texts, as in the following schematic:
<text>  <front/>  <group>   <text/>   <text/>  </group> </text>
Note This element should not be used to represent a text which is inserted at an arbitrary point within the structure of another, for example as in an embedded or quoted narrative; the <floatingText> is provided for this purpose.

1.112. <textLang>

<textLang> (text language) describes the languages and writing systems identified within the bibliographic work being described, rather than its description. [3.11.2.3. 10.6.6. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
mainLang(main language) supplies a code which identifies the chief language used in the bibliographic work.
Status Optional
Datatype
data.language
Values a recognised language ‘tag’ generated according to BCP 47 which may additionally be documented by a <language> element in the header
otherLangs(other languages) one or more codes identifying any other languages used in the bibliographic work.
Status Optional
Datatype 0–∞ occurrences of 
data.language
separated by whitespace
Values a list of codes, each of which is a recognised language ‘tag’ generated according to BCP 47 which may additionally be documented by a <language> element in the header
Used by
model.biblPart model.msItemPart
Contained by
core: analytic bibl monogr series
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element textLang { tei_att.global.attributes, attribute mainLang { data.language }?, attribute otherLangs { list { data.language* } }?, macro.phraseSeq }
Example
<textLang mainLang="en" otherLangs="la"> Predominantly in English with Latin glosses</textLang>
Note Note that this element should not be used to document the languages or writing systems used for the bibliographic or manuscript description itself: as for all other TEI elements, such information should be provided by means of the global xml:lang attribute attached to the element containing the description. The same values should be used to identify languages and writing systems in all cases, and the codes used may be documented further in the <language> element.

1.113. <time>

<time> contains a phrase defining a time of day in any format. [3.5.4. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp)) att.typed (@type, @subtype)
Used by
model.dateLike
Contained by
analysis: cl phr s span
core: abbr add addrLine author bibl biblScope date del desc editor email emph expan head headItem headLabel hi imprint item label meeting name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence rendition tagUsage
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address cb choice date del email emph expan gb graphic hi lb name note num pb ptr ref term time title
figures: figure formula notatedMusic
header: idno
namesdates: affiliation forename persName surname
Declaration
element time { tei_att.global.attributes, tei_att.datable.attributes, tei_att.editLike.attributes, tei_att.typed.attributes, ( text | model.gLike | model.phrase | model.global )* }
Example
As he sat smiling, the quarter struck — <time when="11:45:00">the quarter to twelve</time>.

1.114. <title>

<title> contains a title for any kind of work. [3.11.2.2. 2.2.1. 2.2.5. ]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.canonical (@key, @ref)
levelindicates the bibliographic level for a title, that is, whether it identifies an article, book, journal, series, or unpublished material.
Status Optional
Legal values are:
a
(analytic) analytic title (article, poem, or other item published as part of a larger item)
m
(monographic) monographic title (book, collection, or other item published as a distinct item, including single volumes of multi-volume works)
j
(journal) journal title
s
(series) series title
u
(unpublished) title of unpublished material (including theses and dissertations unless published by a commercial press)
Note The level of a title is sometimes implied by its context: for example, a title appearing directly within an <analytic> element is ipso facto of level ‘a’, and one appearing within a <series> element of level ‘s’. For this reason, the level attribute is not required in contexts where its value can be unambiguously inferred. Where it is supplied in such contexts, its value should not contradict the value implied by its parent element.
typeclassifies the title according to some convenient typology.
Status Optional
Datatype
data.enumerated
Sample values include:
main
main title
sub
(subordinate) subtitle, title of part
alt
(alternate) alternate title, often in another language, by which the work is also known
short
abbreviated form of title
desc
(descriptive) descriptive paraphrase of the work functioning as a title
Note This attribute is provided for convenience in analysing titles and processing them according to their type; where such specialized processing is not necessary, there is no need for such analysis, and the entire title, including subtitles and any parallel titles, may be enclosed within a single <title> element.
Used by
model.emphLike model.msQuoteLike
Contained by
analysis: cl phr s span
core: abbr add addrLine analytic author bibl biblScope date del desc editor email emph expan head headItem headLabel hi item label meeting monogr name note num p pubPlace publisher q quote ref series street term textLang time title
figures: cell
header: change licence rendition seriesStmt tagUsage titleStmt
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
core: abbr add address bibl biblStruct cb choice date del desc email emph expan gb graphic hi label lb list listBibl name note num pb ptr q quote ref term time title
figures: figure formula notatedMusic table
header: biblFull idno
namesdates: affiliation forename listRelation persName surname
Declaration
element title { tei_att.global.attributes, tei_att.canonical.attributes, attribute level { "a" | "m" | "j" | "s" | "u" }?, attribute type { data.enumerated }?, macro.paraContent }
Example
<title>Information Technology and the Research Process: Proceedings of a conference held at Cranfield Institute of Technology, UK, 18–21 July 1989</title>
Example
<title>Hardy's Tess of the D'Urbervilles: a machine readable edition</title>
Example
<title type="full">  <title type="main">Synthèse</title>  <title type="sub">an international journal for    epistemology, methodology and history of    science</title> </title>
Note The attributes key and ref, inherited from the class att.canonical may be used to indicate the canonical form for the title; the former, by supplying (for example) the identifier of a record in some external library system; the latter by pointing to an XML element somewhere containing the canonical form of the title.

1.115. <titleStmt>

<titleStmt> (title statement) groups information about the title of a work and those responsible for its intellectual content. [2.2.1. 2.2. ]
Moduleheader
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana))
Used by
Contained by
header: biblFull fileDesc
May contain
core: author editor meeting title
Declaration
element titleStmt { tei_att.global.attributes, ( title+, model.respLike* ) }
Example
<titleStmt>  <title>Capgrave's Life of St. John Norbert: a machine-readable transcription</title>  <respStmt>   <resp>compiled by</resp>   <name>P.J. Lucas</name>  </respStmt> </titleStmt>

1.116. <w>

<w> (word) represents a grammatical (not necessarily orthographic) word. [17.1. ]
Moduleanalysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.analytic (@ana)) att.segLike (@function, @part) att.typed (@type, @subtype)
lemmaprovides a lemma for the word, such as an uninflected dictionary entry form.
Status Optional
Datatype
data.key
lemmaRefprovides a pointer to a definition of the lemma for the word, for example in an online lexicon.
Status Optional
Datatype
data.pointer
Values any valid URI
Used by
model.segLike
Contained by
analysis: cl phr s w
core: abbr add addrLine author bibl biblScope date del editor email emph expan head headItem headLabel hi item label name note num p pubPlace publisher q quote ref street term textLang time title
figures: cell
header: change licence
namesdates: affiliation forename persName surname
textstructure: docAuthor docDate docEdition docImprint
May contain
analysis: c interp interpGrp m span spanGrp w
core: abbr add cb choice del expan gb hi lb note pb
figures: figure notatedMusic
Declaration
element w { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, attribute lemma { data.key }?, attribute lemmaRef { data.pointer }?, ( text | model.gLike | seg | w | m | c | model.global | model.lPart | model.hiLike | model.pPart.edit )* }
Example
<w   lemma="hit"   lemmaRef="http://www.example.com/lexicon/hitvb.xml"   type="verb">hitt<m type="suffix">ing</m> </w>

2. Model classes

2.1. model.addrPart

model.addrPart groups elements such as names or postal codes which may appear as part of a postal address.
Moduletei
Used by
address
Membersmodel.nameLike [model.nameLike.agent [name persName] idno model.persNamePart [surname forename] ] addrLine street postCode postBox

2.2. model.addressLike

model.addressLike groups elements used to represent a postal or e-mail address.
Moduletei
Used by
model.pPart.data
Membersemail address affiliation

2.3. model.applicationLike

model.applicationLike groups elements used to record application-specific information about a document in its header.
Moduletei
Used by
appInfo
Membersapplication

2.4. model.availabilityPart

model.availabilityPart groups elements such as licences and paragraphs of text which may appear as part of an availability statment
Moduletei
Used by
availability
Membersp licence

2.5. model.biblLike

model.biblLike groups elements containing a bibliographic description.
Moduletei
Used by
listBibl model.inter sourceDesc
Membersbibl biblStruct biblFull listRelation

2.6. model.biblPart

model.biblPart groups elements which represent components of a bibliographic description.
Moduletei
Used by
bibl
Membersmodel.respLike [author editor meeting] model.imprintPart [publisher biblScope pubPlace] series bibl textLang

2.7. model.choicePart

model.choicePart groups elements (other than <choice> itself) which can be used within a <choice> alternation.
Moduletei
Used by
choice
Membersabbr expan

2.8. model.common

model.common groups common chunk- and inter-level elements.
Moduletei
Used by
body div figure
Membersmodel.divPart [model.lLike model.pLike [p] ] model.inter [model.biblLike [bibl biblStruct biblFull listRelation] model.labelLike [desc label] model.listLike [list listBibl table] model.qLike [model.quoteLike [quote] q] ]
Note This class defines the set of chunk- and inter-level elements; it is used in many content models, including those for textual divisions.

2.9. model.dateLike

model.dateLike groups elements containing temporal expressions.
Moduletei
Used by
imprint model.pPart.data
Membersdate time

2.10. model.divBottom

model.divBottom groups elements appearing at the end of a text division.
Moduletei
Used by
body div group list
Membersmodel.divWrapper [meeting docAuthor docDate] model.divBottomPart

2.11. model.divLike

model.divLike groups elements used to represent un-numbered generic structural divisions.
Moduletei
Used by
back body div front
Membersdiv

2.12. model.divPart

model.divPart groups paragraph-level elements appearing directly within divisions.
Moduletei
Used by
macro.specialPara model.common
Membersmodel.lLike model.pLike [p]
Note Note that this element class does not include members of the model.inter class, which can appear either within or between paragraph-level items.

2.13. model.divTop

model.divTop groups elements appearing at the beginning of a text division.
Moduletei
Used by
body div group list
Membersmodel.divWrapper [meeting docAuthor docDate] model.divTopPart [model.headLike [head] ]

2.14. model.divTopPart

model.divTopPart groups elements which can occur only at the beginning of a text division.
Moduletei
Used by
model.divTop
Membersmodel.headLike [head]

2.15. model.divWrapper

model.divWrapper groups elements which can appear at either top or bottom of a textual division.
Moduletei
Used by
model.divBottom model.divTop
Membersmeeting docAuthor docDate

2.16. model.editorialDeclPart

model.editorialDeclPart groups elements which may be used inside <editorialDecl> and appear multiple times.
Moduletei
Used by
editorialDecl
Membersnormalization quotation hyphenation segmentation

2.17. model.emphLike

model.emphLike groups phrase-level elements which are typographically distinct and to which a specific function can be attributed.
Moduletei
Used by
model.highlighted model.limitedPhrase
Membersemph term title

2.18. model.encodingDescPart

model.encodingDescPart groups elements which may be used inside <encodingDesc> and appear multiple times.
Moduletei
Used by
encodingDesc
MembersprojectDesc samplingDecl editorialDecl tagsDecl refsDecl appInfo

2.19. model.global

model.global groups elements which may appear at any point within a TEI text.
Moduletei
Used by
address back bibl body date div docImprint docTitle figure front group head imprint list m macro.paraContent macro.phraseSeq macro.phraseSeq.limited macro.specialPara series table text time w
Membersmodel.global.meta [span spanGrp interp interpGrp] model.milestoneLike [gb pb lb cb] model.noteLike [note] notatedMusic figure

2.20. model.global.meta

model.global.meta groups globally available elements which describe the status of other elements.
Moduletei
Used by
model.global
Membersspan spanGrp interp interpGrp
Note Elements in this class are typically used to hold groups of links or of abstract interpretations, or by provide indications of certainty etc. It may find be convenient to localize all metadata elements, for example to contain them within the same divison as the elements that they relate to; or to locate them all to a division of their own. They may however appear at any point in a TEI text.

2.21. model.glossLike

model.glossLike groups elements which provide an alternative name, explanation, or description for any markup construct.
Moduletei
Used by
graphic interp interpGrp
Membersdesc

2.22. model.graphicLike

model.graphicLike groups elements containing images, formulae, and similar objects.
Moduletei
Used by
figure formula model.phrase table
Membersgraphic formula

2.23. model.headLike

model.headLike groups elements used to provide a title or heading at the start of a text division.
Moduletei
Used by
figure listBibl model.divTopPart table
Membershead

2.24. model.hiLike

model.hiLike groups phrase-level elements which are typographically distinct but to which no specific function can be attributed.
Moduletei
Used by
model.highlighted model.limitedPhrase model.linePart w
Membershi

2.25. model.highlighted

model.highlighted groups phrase-level elements which are typographically distinct.
Moduletei
Used by
bibl model.phrase
Membersmodel.hiLike [hi] model.emphLike [emph term title]

2.26. model.imprintPart

model.imprintPart groups the bibliographic elements which occur inside imprints.
Moduletei
Used by
imprint model.biblPart
Memberspublisher biblScope pubPlace

2.27. model.inter

model.inter groups elements which can appear either within or between paragraph-like elements.
Moduletei
Used by
head macro.limitedContent macro.paraContent macro.specialPara model.common
Membersmodel.biblLike [bibl biblStruct biblFull listRelation] model.labelLike [desc label] model.listLike [list listBibl table] model.qLike [model.quoteLike [quote] q]

2.28. model.labelLike

model.labelLike groups elements used to gloss or explain other parts of a document.
Moduletei
Used by
application model.inter notatedMusic
Membersdesc label

2.29. model.limitedPhrase

model.limitedPhrase groups phrase-level elements excluding those elements primarily intended for transcription of existing sources.
Moduletei
Used by
macro.limitedContent macro.phraseSeq.limited
Membersmodel.hiLike [hi] model.emphLike [emph term title] model.pPart.editorial [choice abbr expan] model.ptrLike [ptr ref] model.pPart.data [model.dateLike [date time] model.measureLike [num] model.addressLike [email address affiliation] model.nameLike [model.nameLike.agent [name persName] idno model.persNamePart [surname forename] ] ]

2.30. model.linePart

model.linePart groups transcriptional elements which appear within lines or zones of a source-oriented transcription within a <sourceDoc> element.
Moduletei
Used by
Membersmodel.segLike [s cl phr w m c pc] model.hiLike [hi] model.pPart.transcriptional [add del] choice

2.31. model.listLike

model.listLike groups list-like elements.
Moduletei
Used by
model.inter sourceDesc
Memberslist listBibl table

2.32. model.measureLike

model.measureLike groups elements which denote a number, a quantity, a measurement, or similar piece of text that conveys some numerical meaning.
Moduletei
Used by
model.pPart.data
Membersnum

2.33. model.milestoneLike

model.milestoneLike groups milestone-style elements used to represent reference systems.
Moduletei
Used by
listBibl model.global
Membersgb pb lb cb

2.34. model.msItemPart

model.msItemPart groups elements which can appear within a manuscript item description.
Moduletei
Used by
Membersmodel.quoteLike [quote] model.respLike [author editor meeting] model.msQuoteLike [title] bibl listBibl textLang

2.35. model.msQuoteLike

model.msQuoteLike groups elements which represent passages such as titles quoted from a manuscript as a part of its description.
Moduletei
Used by
model.msItemPart
Memberstitle

2.36. model.nameLike

model.nameLike groups elements which name or refer to a person, place, or organization.
Moduletei
Used by
model.addrPart model.pPart.data
Membersmodel.nameLike.agent [name persName] idno model.persNamePart [surname forename]
Note A superset of the naming elements that may appear in datelines, addresses, statements of responsibility, etc.

2.37. model.nameLike.agent

model.nameLike.agent groups elements which contain names of individuals or corporate bodies.
Moduletei
Used by
model.nameLike
Membersname persName
Note This class is used in the content model of elements which reference names of people or organizations.

2.38. model.noteLike

model.noteLike groups globally-available note-like elements.
Moduletei
Used by
biblStruct model.global monogr notesStmt
Membersnote

2.39. model.pLike

model.pLike groups paragraph-like elements.
Moduletei
Used by
application cRefPattern editorialDecl encodingDesc hyphenation listRelation model.divPart normalization projectDesc publicationStmt quotation refsDecl samplingDecl segmentation seriesStmt sourceDesc
Membersp

2.40. model.pLike.front

model.pLike.front groups paragraph-like elements which can occur as direct constituents of front matter.
Moduletei
Used by
back front
Membershead docTitle docAuthor docEdition docImprint docDate

2.41. model.pPart.data

model.pPart.data groups phrase-level elements containing names, dates, numbers, measures, and similar data.
Moduletei
Used by
bibl model.limitedPhrase model.phrase
Membersmodel.dateLike [date time] model.measureLike [num] model.addressLike [email address affiliation] model.nameLike [model.nameLike.agent [name persName] idno model.persNamePart [surname forename] ]

2.42. model.pPart.edit

model.pPart.edit groups phrase-level elements for simple editorial correction and transcription.
Moduletei
Used by
bibl model.phrase w
Membersmodel.pPart.editorial [choice abbr expan] model.pPart.transcriptional [add del]

2.43. model.pPart.editorial

model.pPart.editorial groups phrase-level elements for simple editorial interventions that may be useful both in transcribing and in authoring.
Moduletei
Used by
model.limitedPhrase model.pPart.edit
Memberschoice abbr expan

2.44. model.pPart.transcriptional

model.pPart.transcriptional groups phrase-level elements used for editorial transcription of pre-existing source materials.
Moduletei
Used by
model.linePart model.pPart.edit
Membersadd del

2.45. model.persNamePart

model.persNamePart groups elements which form part of a personal name.
Modulenamesdates
Used by
model.nameLike
Memberssurname forename

2.46. model.persStateLike

model.persStateLike groups elements describing changeable characteristics of a person which have a definite duration, for example occupation, residence, or name.
Moduletei
Used by
model.personPart
MemberspersName affiliation
Note These characteristics of an individual are typically a consequence of their own action or that of others.

2.47. model.personPart

model.personPart groups elements which form part of the description of a person.
Moduletei
Used by
Membersmodel.persStateLike [persName affiliation] bibl

2.48. model.phrase

model.phrase groups elements which can occur at the level of individual words or phrases.
Moduletei
Used by
date docImprint head macro.paraContent macro.phraseSeq macro.specialPara time
Membersmodel.segLike [s cl phr w m c pc] model.highlighted [model.hiLike [hi] model.emphLike [emph term title] ] model.graphicLike [graphic formula] model.pPart.edit [model.pPart.editorial [choice abbr expan] model.pPart.transcriptional [add del] ] model.ptrLike [ptr ref] model.lPart model.pPart.data [model.dateLike [date time] model.measureLike [num] model.addressLike [email address affiliation] model.nameLike [model.nameLike.agent [name persName] idno model.persNamePart [surname forename] ] ]
Note This class of elements can occur only within larger elements of the class inter or chunk. In prose, this means these elements can occur within paragraphs, list items, lines of verse, etc.

2.49. model.ptrLike

model.ptrLike groups elements used for purposes of location and reference.
Moduletei
Used by
application bibl model.limitedPhrase model.phrase notatedMusic
Membersptr ref

2.50. model.publicationStmtPart

model.publicationStmtPart groups elements which may appear within the <publicationStmt> element of the TEI Header.
Moduletei
Used by
publicationStmt
Membersaddress date publisher pubPlace idno availability

2.51. model.qLike

model.qLike groups elements related to highlighting which can appear either within or between chunk-level elements.
Moduletei
Used by
model.inter
Membersmodel.quoteLike [quote] q

2.52. model.quoteLike

model.quoteLike groups elements used to directly contain quotations.
Moduletei
Used by
model.msItemPart model.qLike
Membersquote

2.53. model.respLike

model.respLike groups elements which are used to indicate intellectual or other significant responsibility, for example within a bibliographic element.
Moduletei
Used by
model.biblPart model.msItemPart titleStmt
Membersauthor editor meeting

2.54. model.segLike

model.segLike groups elements used for arbitrary segmentation.
Moduletei
Used by
bibl model.linePart model.phrase
Memberss cl phr w m c pc
Note The principles on which segmentation is carried out, and any special codes or attribute values used, should be defined explicitly in the <segmentation> element of the <encodingDesc> within the associated TEI header.

2.55. model.teiHeaderPart

model.teiHeaderPart groups high level elements which may appear more than once in a TEI Header.
Moduletei
Used by
teiHeader
MembersencodingDesc

2.56. model.titlepagePart

model.titlepagePart groups elements which can occur as direct constituents of a title page, such as <docTitle>, <docAuthor>, <docImprint>, or <epigraph>.
Moduletei
Used by
Membersgraphic docTitle docAuthor docEdition docImprint docDate

3. Attribute classes

3.1. att.ascribed

att.ascribed provides attributes for elements representing speech or action that can be ascribed to a specific individual.
Moduletei
Membersq change
AttributesAttributes
whoindicates the person, or group of people, to whom the element content is ascribed.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values For transcribed speech, this will typically identify a participant or participant group; in other contexts, it will point to any identified <person> element.

3.2. att.breaking

att.breaking provides an attribute to indicate whether or not the element concerned is considered to mark the end of an orthographic token in the same way as whitespace.
Moduletei
Membersgb pb lb cb
AttributesAttributes
breakindicates whether or not the element bearing this attribute should be considered to mark the end of an orthographic token in the same way as whitespace.
Status Recommended
Datatype
data.enumerated
Sample values include
yes
the element bearing this attribute is considered to mark the end of any adjacent orthographic token irrespective of the presence of any adjacent whitespace
no
the element bearing this attribute is considered not to mark the end of any adjacent orthographic token irrespective of the presence of any adjacent whitespace
maybe
no assertion is made as to whether or not the element bearing this attribute is considered to mark the end of any adjacent orthographic token.
Note

3.3. att.canonical

att.canonical provides attributes which can be used to associate a representation such as a name or title with canonical information about the object being named or referenced.
Moduletei
Membersatt.naming [att.personal [persName surname forename] name author editor pubPlace affiliation] term title docTitle docAuthor
AttributesAttributes
keyprovides an externally-defined means of identifying the entity (or entities) being named, using a coded value of some kind.
Status Optional
Datatype
data.key
Values any string of Unicode characters
Note The value may be a unique identifier from a database, or any other externally-defined string identifying the referent.
ref(reference) provides an explicit means of locating a full definition for the entity being named by means of one or more URIs.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Note The value must point directly to one or more XML elements by means of one or more URIs, separated by whitespace. If more than one is supplied, the implication is that the name identifies several distinct entities.

3.4. att.datable

att.datable provides attributes for normalization of elements that contain dates, times, or datable events.
Moduletei
Membersdate time licence application change persName affiliation
AttributesAttributes att.datable.w3c (@when, @notBefore, @notAfter, @from, @to) att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso) att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)
calendarindicates the system or calendar to which the date represented by the content of this element belongs.
Status Optional
Datatype
data.pointer
He was born on <date   calendar="#Gregorian">Feb. 22, 1732</date> (<date   calendar="#Julian"   when="1732-02-22"> Feb. 11, 1731/32, O.S.</date>).
periodsupplies a pointer to some location defining a named period of time within which the datable item is understood to have occurred.
Status Optional
Datatype
data.pointer
Note This ‘superclass’ provides attributes that can be used to provide normalized values of temporal information. By default, the attributes from the att.datable.w3c class are provided. If the module for names & dates is loaded, this class also provides attributes from the att.datable.iso and att.datable.custom classes. In general, the possible values of attributes restricted to the W3C datatypes form a subset of those values available via the ISO 8601 standard. However, the greater expressiveness of the ISO datatypes may not be needed, and there exists much greater software support for the W3C datatypes.

3.5. att.datable.custom

att.datable.custom provides attributes for normalization of elements that contain datable events to a custom dating system (i.e. other than the Gregorian used by W3 and ISO).
Modulenamesdates
Membersatt.datable [date time licence application change persName affiliation]
AttributesAttributes
when-customsupplies the value of a date or time in some standard form.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values Any string representing a valid date, time, or one of a variety of combinations.
The following are examples of custom date or time formats that are not valid ISO or W3C format normalizations, normalized to a different dating system
<p>Alhazen died in Cairo on the <date    when="1040-03-06"    when-custom="431-06-12"> 12th day of Jumada t-Tania, 430 AH  </date>.</p> <p>The current world will end <date    when="2012-12-21"    when-custom="13.0.0.0.0">at the end of B'ak'tun 13</date>.</p> <p>The Battle of Meggidu (<date    when-custom="Thutmose_III:23">23rd year of the reign of Thutmose III</date>).</p> <p>Esidorus bix(i)t in p(ac)e annos LXX pl(u)s m(inu)s s(ub) <date    when-custom="Ind:4-10-11">d(ie)    XI men(sis) O(cto)b(ris) ind(ictione) IIII</date> </p>
Not all custom date formulations will have Gregorian equivalents. The when-custom attribute and other custom dating are not contrained to a datatype by the TEI, but individual projects are recommended to regularize and document their dating formats.
notBefore-customspecifies the earliest possible date for the event in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values A normalized form of temporal expression.
notAfter-customspecifies the latest possible date for the event in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values A normalized form of temporal expression.
from-customindicates the starting point of the period in some standard form.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values A normalized form of temporal expression.
to-customindicates the ending point of the period in some standard form.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values A normalized form of temporal expression.
datingPointsupplies a pointer to some location defining a named point in time with reference to which the datable item is understood to have occurred
Status Optional
Datatype
data.pointer
datingMethodsupplies a pointer to a <calendarDesc> element or other means of interpreting the values of the custom dating attributes.
Status Optional
Datatype
data.pointer

3.6. att.datable.iso

att.datable.iso provides attributes for normalization of elements that contain datable events using the ISO 8601 standard.
Modulenamesdates
Membersatt.datable [date time licence application change persName affiliation]
AttributesAttributes
when-isosupplies the value of a date or time in a standard form.
Status Optional
Datatype
data.temporal.iso
Values Any string representing a valid date, time, or one of a variety of combinations.
The following are examples of ISO date, time, and date & time formats that are not valid W3C format normalizations.
<date   when-iso="1996-09-24T07:25+00">Sept. 24th, 1996 at 3:25 in the morning</date> <date   when-iso="1996-09-24T03:25-04">Sept. 24th, 1996 at 3:25 in the morning</date> <time   when-iso="1999-01-04T20:42-05">4 Jan 1999 at 8:42 pm</time> <time   when-iso="1999-W01-1T20,70-05">4 Jan 1999 at 8:42 pm</time> <date   when-iso="2006-05-18T10:03">a few minutes after ten in the morning on Thu 18 May</date> <time   when-iso="03:00">3 A.M.</time> <time   when-iso="14">around two</time> <time   when-iso="15,5">half past three</time>
All of the examples of the when attribute in the att.datable.w3c class are also valid with respect to this attribute.
He likes to be punctual. I said <q>  <time    when-iso="12">around noon</time> </q>, and he showed up at <time   when-iso="12:00:00">12 O'clock</time> on the dot.
The second occurence of <time> could have been encoded with the when attribute, as 12:00:00 is a valid time with respect to the W3C XML Schema Part 2: Datatypes specification. The first occurence could not.
Note The value of the when-iso attribute should be the normalized representation of the date, time, or combined date & time intended, in any of the standard formats specified by ISO 8601, using the Gregorian calendar.
notBefore-isospecifies the earliest possible date for the event in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.iso
Values A normalized form of temporal expression conforming ISO 8601.
notAfter-isospecifies the latest possible date for the event in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.iso
Values A normalized form of temporal expression conforming ISO 8601.
from-isoindicates the starting point of the period in standard form.
Status Optional
Datatype
data.temporal.iso
Values A normalized form of temporal expression conforming ISO 8601.
to-isoindicates the ending point of the period in standard form.
Status Optional
Datatype
data.temporal.iso
Values A normalized form of temporal expression conforming ISO 8601.
Note If both when-iso and dur-iso are specified, the values should be interpreted as indicating a span of time by its starting time (or date) and duration. That is,
<date dur-iso="P8D" when-iso="2007-06-01"/>
indicates the same time period as
<date when-iso="2007-06-01/P8D"/>
In providing a ‘regularized’ form, no claim is made that the form in the source text is incorrect; the regularized form is simply that chosen as the main form for purposes of unifying variant forms under a single heading.

3.7. att.datable.w3c

att.datable.w3c provides attributes for normalization of elements that contain datable events using the W3C datatypes.
Moduletei
Membersatt.datable [date time licence application change persName affiliation]
AttributesAttributes
whensupplies the value of the date or time in a standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.w3c
Values A normalized form of temporal expression conforming to the W3C XML Schema Part 2: Datatypes Second Edition.
Examples of W3C date, time, and date & time formats.
<p>  <date    when="1945-10-24">24 Oct 45</date>  <date    when="1996-09-24T07:25:00Z">September 24th, 1996 at 3:25 in the morning</date>  <time    when="1999-01-04T20:42:00-05:00">Jan 4 1999 at 8 pm</time>  <time    when="14:12:38">fourteen twelve and 38 seconds</time>  <date    when="1962-10">October of 1962</date>  <date    when="--06-12">June 12th</date>  <date    when="---01">the first of the month</date>  <date    when="--08">August</date>  <date    when="2006">MMVI</date>  <date    when="0056">AD 56</date>  <date    when="-0056">56 BC</date> </p>
This list begins in the year 1632, more precisely on Trinity Sunday, i.e. the Sunday after Pentecost, in that year the <date   calendar="#Julian"   when="1632-06-06">27th of May (old style)</date>.
<opener>  <dateline>   <placeName>Dorchester, Village,</placeName>   <date     when="1828-03-02">March 2d. 1828.</date>  </dateline>  <salute>To    Mrs. Cornell,</salute> Sunday <time    when="12:00:00">noon.</time> </opener>
Note The value of the when attribute should be the normalized representation of the date, time, or combined date & time intended, in any of the standard formats specified by XML Schema Part 2: Datatypes Second Edition, using the Gregorian calendar. The most commonly-encountered format for the date part of the when attribute is yyyy-mm-dd, but yyyy, --mm, ---dd, yyyy-mm, or --mm-dd may also be used. For the time part, the form hh:mm:ss is used. Note that this format does not currently permit use of the value 0000 to represent the year 1 BCE; instead the value -0001 should be used.
notBeforespecifies the earliest possible date for the event in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.w3c
Values A normalized form of temporal expression conforming to the W3C XML Schema Part 2: Datatypes Second Edition.
notAfterspecifies the latest possible date for the event in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.w3c
Values A normalized form of temporal expression conforming to the W3C XML Schema Part 2: Datatypes Second Edition.
fromindicates the starting point of the period in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.w3c
Values A normalized form of temporal expression conforming to the W3C XML Schema Part 2: Datatypes Second Edition.
toindicates the ending point of the period in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype
data.temporal.w3c
Values A normalized form of temporal expression conforming to the W3C XML Schema Part 2: Datatypes Second Edition.

3.8. att.declarable

att.declarable provides attributes for those elements in the TEI Header which may be independently selected by means of the special purpose decls attribute.
Moduletei
Membersbibl biblStruct listBibl availability sourceDesc biblFull projectDesc samplingDecl editorialDecl normalization quotation hyphenation segmentation refsDecl
AttributesAttributes
defaultindicates whether or not this element is selected by default when its parent is selected.
Status Optional
Datatype
data.truthValue
Legal values are:
true
This element is selected if its parent is selected
false
This element can only be selected explicitly, unless it is the only one of its kind, in which case it is selected if its parent is selected. [Default]
Note The rules governing the association of declarable elements with individual parts of a TEI text are fully defined in chapter 15.3. . Only one element of a particular type may have a default attribute with a value of true.

3.9. att.declaring

att.declaring provides attributes for elements which may be independently associated with a particular declarable element within the header, thus overriding the inherited default for that element.
Moduletei
Membersp term ptr ref graphic text body group div front back
AttributesAttributes
declsidentifies one or more declarable elements within the header, which are understood to apply to the element bearing this attribute and its content.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values must identify a set of declarable elements of different types.
Note The rules governing the association of declarable elements with individual parts of a TEI text are fully defined in chapter 15.3. .

3.10. att.dimensions

att.dimensions provides attributes for describing the size of physical objects.
Moduletei
Membersatt.editLike [att.transcriptional [add del] date time expan persName affiliation]
AttributesAttributes att.ranging (@atLeast, @atMost, @min, @max, @confidence)
unitnames the unit used for the measurement
Status Optional
Datatype
data.enumerated
Suggested values include:
cm
(centimetres)
mm
(millimetres)
in
(inches)
lines
lines of text
chars
(characters) characters of text
quantityspecifies the length in the units specified
Status Optional
Datatype
data.numeric
extentindicates the size of the object concerned using a project-specific vocabulary combining quantity and units in a single string of words.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values any measurement phrase, e.g. 25 letters, 2 × 3 inches.
<gap   extent="5 words"/>
<height   extent="half the page"/>
precisioncharacterizes the precision of the values specified by the other attributes.
Status Optional
Datatype
data.certainty
scopewhere the measurement summarizes more than one observation, specifies the applicability of this measurement.
Status Optional
Datatype
data.enumerated
Sample values include:
all
measurement applies to all instances.
most
measurement applies to most of the instances inspected.
range
measurement applies to only the specified range of instances.

3.11. att.divLike

att.divLike provides attributes common to all elements which behave in the same way as divisions.
Moduletei
Membersdiv
AttributesAttributes
org(organization) specifies how the content of the division is organized.
Status Optional
Legal values are:
composite
composite content: i.e. no claim is made about the sequence in which the immediate contents of this division are to be processed, or their inter-relationships.
uniform
uniform content: i.e. the immediate contents of this element are regarded as forming a logical unit, to be processed in sequence. [Default]
sampleindicates whether this division is a sample of the original source and if so, from which part.
Status Optional
Legal values are:
initial
division lacks material present at end in source.
medial
division lacks material at start and end.
final
division lacks material at start.
unknown
position of sampled material within original unknown.
complete
division is not a sample. [Default]
partspecifies whether or not the division is fragmented by some other structural element, for example a speech which is divided between two or more verse stanzas.
Status Optional
Legal values are:
Y
(yes) the division is incomplete in some respect
N
(no) either the division is complete, or no claim is made as to its completeness. [Default]
I
(initial) the initial part of an incomplete division
M
(medial) a medial part of an incomplete division
F
(final) the final part of an incomplete division
Note The values I, M, or F should be used only where it is clear how the division is to be reconstituted.

3.12. att.docStatus

att.docStatus provides attributes for use on metadata elements describing the status of a document.
Moduletei
MembersrevisionDesc change
AttributesAttributes
statusdescribes the status of a document either currently or, when associated with a dated element, at the time indicated.
Status Optional
Datatype
data.enumerated
Sample values include:
approved
candidate
cleared
deprecated
draft
[Default]
embargoed
expired
frozen
galley
proposed
published
recommendation
submitted
unfinished
withdrawn
Example
<revisionDesc status="published">  <change status="published" when="2010-10-21"/>  <change status="cleared" when="2010-10-02"/>  <change status="embargoed" when="2010-08-02"/>  <change status="frozen" when="2010-05-01" who="#MSM"/>  <change status="draft" when="2010-03-01" who="#LB"/> </revisionDesc>

3.13. att.editLike

att.editLike provides attributes describing the nature of a encoded scholarly intervention or interpretation of any kind.
Moduletei
Membersatt.transcriptional [add del] date time expan persName affiliation
AttributesAttributes att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.responsibility (@cert, @resp)
evidenceindicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation.
Status Optional
Datatype 1–∞ occurrences of 
data.enumerated
separated by whitespace
Suggested values include:
internal
there is internal evidence to support the intervention.
external
there is external evidence to support the intervention.
conjecture
the intervention or interpretation has been made by the editor, cataloguer, or scholar on the basis of their expertise.
sourcecontains a list of one or more pointers indicating sources supporting the given intervention or interpretation.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values A space-delimited series of sigla; each sigil should correspond to a witness or witness group and occur as the value of the xml:id attribute on a <witness> or <msDesc> element elsewhere in the document.
instantIs this an instant revision?
Status Optional
Datatype
data.xTruthValue
Note The members of this attribute class are typically used to represent any kind of editorial intervention in a text, for example a correction or interpretation, or to date or localize manuscripts etc.

3.14. att.global

att.global provides attributes common to all elements in the TEI encoding scheme.
Moduletei
Membersp emph hi quote q desc term choice add del name email address addrLine street postCode postBox num date time abbr expan ptr ref list item label head headLabel headItem note graphic gb pb lb cb analytic monogr series author editor title meeting imprint publisher biblScope pubPlace bibl biblStruct listBibl textLang teiHeader fileDesc titleStmt publicationStmt idno availability licence seriesStmt notesStmt sourceDesc biblFull encodingDesc projectDesc samplingDecl editorialDecl normalization quotation hyphenation segmentation tagsDecl tagUsage namespace rendition refsDecl cRefPattern refState appInfo application revisionDesc change listChange TEI text body group div docTitle docAuthor docEdition docImprint docDate front back table row cell formula notatedMusic figure persName surname forename affiliation listRelation s cl phr w m c pc span spanGrp interp interpGrp
AttributesAttributes att.global.analytic (@ana)
xml:id(identifier) provides a unique identifier for the element bearing the attribute.
Status Optional
Datatype
xsd:ID
Values any valid XML identifier.
Note The xml:id attribute may be used to specify a canonical reference for an element; see section 3.10. .
n(number) gives a number (or other label) for an element, which is not necessarily unique within the document.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values the value consists of one or more instances of data.word. Each instance may contain only letters, digits, punctuation characters, or symbols: it may not contain whitespace or word separating characters. It need not be restricted to numbers.
Note The n attribute may be used to specify the numbering of chapters, sections, list items, etc.; it may also be used in the specification of a standard reference system for the text.
xml:lang(language) indicates the language of the element content using a ‘tag’ generated according to BCP 47
Status Optional
Datatype
data.language
Values The value must conform to BCP 47. If the value is a private use code (i.e., starts with x- or contains -x-) it should, and if not it may, match the value of an ident attribute of a <language> element supplied in the TEI Header of the current document.
Note the xml:lang value will be inherited from the immediately enclosing element, or from its parent, and so on up the document hierarchy. It is generally good practice to specify xml:lang at the highest appropriate level, noticing that a different default may be needed for the teiHeader from that needed for the associated resource element or elements, and that a single TEI document may contain texts in many languages.
rend(rendition) indicates how the element in question was rendered or presented in the source text.
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values may contain any number of tokens, each of which may contain letters, punctuation marks, or symbols, but not word-separating characters.
<head   rend="align(center) case(allcaps)">  <lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her <lb/>  <hi    rend="case(mixed)">New Blazing-World</hi>. </head>
Note These Guidelines make no binding recommendations for the values of the rend attribute; the characteristics of visual presentation vary too much from text to text and the decision to record or ignore individual characteristics varies too much from project to project. Some potentially useful conventions are noted from time to time at appropriate points in the Guidelines.
renditionpoints to a description of the rendering or presentation used for this element in the source text.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values one or more URIs, separated by whitespace.
<head   rendition="#ac #sc">  <lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her <lb/>  <hi    rendition="#no">New Blazing-World</hi>. </head> <rendition   scheme="css"   xml:id="sc">font-variant: small-caps</rendition> <rendition   scheme="css"   xml:id="no">font-variant: normal</rendition> <rendition   scheme="css"   xml:id="ac">text-align: center</rendition>
Note The rendition attribute is used in a very similar way to the class attribute defined for XHTML but with the important distinction that its function is to describe the appearance of the source text, not necessarily to determine how that text should be presented on screen or paper. Where both rendition and rend are supplied, the latter is understood to override or complement the former. Each URI provided should indicate a <rendition> element defining the intended rendition in terms of some appropriate style language, as indicated by the scheme attribute.
xml:baseprovides a base URI reference with which applications can resolve relative URI references into absolute URI references.
Status Optional
Datatype
data.pointer
Values any syntactically valid URI reference.
<div   type="bibl">  <head>Bibliography</head>  <listBibl    xml:base="http://www.lib.ucdavis.edu/BWRP/Works/">   <bibl     n="1">    <author>     <name>Landon, Letitia Elizabeth</name>    </author>    <ref      target="LandLVowOf.sgm">     <title>The Vow of the Peacock</title>    </ref>   </bibl>   <bibl     n="2">    <author>     <name>Compton, Margaret Clephane</name>    </author>    <ref      target="NortMIrene.sgm">     <title>Irene, a Poem in Six Cantos</title>    </ref>   </bibl>   <bibl     n="3">    <author>     <name>Taylor, Jane</name>    </author>    <ref      target="TaylJEssay.sgm">     <title>Essays in Rhyme on Morals and Manners</title>    </ref>   </bibl>  </listBibl> </div>
xml:spacesignals an intention about how white space should be managed by applications.
Status Optional
Legal values are:
default
the processor should treat white space according to the default XML white space handling rules
preserve
the processor should preserve unchanged any and all white space in the source
Note The XML specification provides further guidance on the use of this attribute.
Note The global attributes described here are made part of the attribute definition list declaration of each element by including a reference to the pattern att.global.attributes in each such declaration.

3.15. att.global.analytic

att.global.analytic provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text.
Moduleanalysis
Membersatt.global [p emph hi quote q desc term choice add del name email address addrLine street postCode postBox num date time abbr expan ptr ref list item label head headLabel headItem note graphic gb pb lb cb analytic monogr series author editor title meeting imprint publisher biblScope pubPlace bibl biblStruct listBibl textLang teiHeader fileDesc titleStmt publicationStmt idno availability licence seriesStmt notesStmt sourceDesc biblFull encodingDesc projectDesc samplingDecl editorialDecl normalization quotation hyphenation segmentation tagsDecl tagUsage namespace rendition refsDecl cRefPattern refState appInfo application revisionDesc change listChange TEI text body group div docTitle docAuthor docEdition docImprint docDate front back table row cell formula notatedMusic figure persName surname forename affiliation listRelation s cl phr w m c pc span spanGrp interp interpGrp]
AttributesAttributes
ana(analysis) indicates one or more elements containing interpretations of the element on which the ana attribute appears.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values one or more valid identifiers of one or more interpretive elements (usually <fs> or <interp>), separated by white space.
Note When multiple values are given, they may reflect either multiple divergent interpretations of an ambiguous text, or multiple mutually consistent interpretations of the same passage in different contexts.

3.16. att.internetMedia

att.internetMedia provides attributes for specifying the type of a computer resource using a standard taxonomy.
Moduletei
Membersptr ref graphic
AttributesAttributes
mimeType(MIME media type) specifies the applicable multimedia internet mail extension (MIME) media type
Status Optional
Datatype 1–∞ occurrences of 
data.word
separated by whitespace
Values The value should be a valid MIME media type
Note This attribute class provides attributes for describing a computer resource, typically available over the internet, according to standard taxonomies. At present only a single taxonomy is supported, the Multipurpose Internet Mail Extensions Media Type system. This system of typology of media types is defined by the Internet Engineering Task Force in RFC 2046. The list of types is maintained by the Internet Assigned Numbers Authority.

3.17. att.interpLike

att.interpLike provides attributes for elements which represent a formal analysis or interpretation.
Moduletei
Membersspan spanGrp interp interpGrp
AttributesAttributes att.responsibility (@cert, @resp)
typeindicates what kind of phenomenon is being noted in the passage.
Status Recommended
Datatype
data.enumerated
Sample values include:
image
identifies an image in the passage.
character
identifies a character associated with the passage.
theme
identifies a theme in the passage.
allusion
identifies an allusion to another text.
inst(instances) points to instances of the analysis or interpretation represented by the current element.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values One or more valid identifiers, separated by whitespace.
Note The current element should be an analytic one. The element pointed at should be a textual one.

3.18. att.naming

att.naming provides attributes common to elements which refer to named persons, places, organizations etc.
Moduletei
Membersatt.personal [persName surname forename] name author editor pubPlace affiliation
AttributesAttributes att.canonical (@key, @ref)
rolemay be used to specify further information about the entity referenced by this name, for example the occupation of a person, or the status of a place.
Status Optional
Datatype
data.enumerated
nymRef(reference to the canonical name) provides a means of locating the canonical form (nym) of the names associated with the object named by the element bearing it.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values One or more valid identifiers, separated by whitespace.
Note The value must point directly to one or more XML elements by means of one or more URIs, separated by whitespace. If more than one is supplied, the implication is that the name is associated with several distinct canonical names.

3.19. att.personal

att.personal (attributes for components of personal names) common attributes for those elements which form part of a personal name.
Moduletei
MemberspersName surname forename
AttributesAttributes att.naming (@role, @nymRef) (att.canonical (@key, @ref))
fullindicates whether the name component is given in full, as an abbreviation or simply as an initial.
Status Optional
Legal values are:
yes
the name component is spelled out in full. [Default]
abb
(abbreviated) the name component is given in an abbreviated form.
init
(initial letter) the name component is indicated only by one initial.
sortspecifies the sort order of the name component in relation to others within the personal name.
Status Optional
Datatype
data.count
Values A positive number indicating the sort order.

3.20. att.placement

att.placement provides attributes for describing where on the source page or object a textual element appears.
Moduletei
Membersadd note notatedMusic figure
AttributesAttributes
place
Status Recommended
Datatype 1–∞ occurrences of 
data.enumerated
separated by whitespace
Suggested values include:
below
below the line
bottom
at the foot of the page
margin
in the margin (left, right, or both)
top
at the top of the page
opposite
on the opposite, i.e. facing, page
overleaf
on the other side of the leaf
above
above the line
end
at the end of e.g. chapter or volume.
inline
within the body of the text.
inspace
in a predefined space, for example left by an earlier scribe.
<add   place="margin">[An addition written in the margin]</add> <add   place="bottom opposite">[An addition written at the foot of the current page and also on the facing page]</add>
<note   place="bottom">Ibid, p.7</note>

3.21. att.pointing

att.pointing defines a set of attributes used by all elements which point to other elements by means of one or more URI references.
Moduletei
Membersterm ptr ref note licence
AttributesAttributes
targetspecifies the destination of the reference by supplying one or more URI References
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values One or more syntactically valid URI references, separated by whitespace. Because whitespace is used to separate URIs, no whitespace is permitted inside a single URI. If a whitespace character is required in a URI, it should be escaped with the normal mechanism, e.g. TEI%20Consortium.
evaluatespecifies the intended meaning when the target of a pointer is itself a pointer.
Status Optional
Legal values are:
all
if the element pointed to is itself a pointer, then the target of that pointer will be taken, and so on, until an element is found which is not a pointer.
one
if the element pointed to is itself a pointer, then its target (whether a pointer or not) is taken as the target of this pointer.
none
no further evaluation of targets is carried out beyond that needed to find the element specified in the pointer's target.
Note If no value is given, the application program is responsible for deciding (possibly on the basis of user input) how far to trace a chain of pointers.

3.22. att.ranging

att.ranging provides attributes for describing numerical ranges.
Moduletei
Membersatt.dimensions [att.editLike [att.transcriptional [add del] date time expan persName affiliation] ] num
AttributesAttributes
atLeastgives a minimum estimated value for the approximate measurement.
Status Optional
Datatype
data.numeric
atMostgives a maximum estimated value for the approximate measurement.
Status Optional
Datatype
data.numeric
minwhere the measurement summarizes more than one observation or a range, supplies the minimum value observed.
Status Optional
Datatype
data.numeric
maxwhere the measurement summarizes more than one observation or a range, supplies the maximum value observed.
Status Optional
Datatype
data.numeric
confidenceThe degree of statistical confidence (between zero and one) that a value falls within the range specified by min and max, or the proportion of observed values that fall within that range.
Status Optional
Datatype
data.probability

3.23. att.responsibility

att.responsibility provides attributes indicating who is responsible for something asserted by the markup and the degree of certainty associated with it.
Moduletei
Membersatt.editLike [att.transcriptional [add del] date time expan persName affiliation] att.interpLike [span spanGrp interp interpGrp] abbr note
AttributesAttributes
cert(certainty) signifies the degree of certainty associated with the intervention or interpretation.
Status Optional
Datatype
data.certainty
resp(responsible party) indicates the agency responsible for the intervention or interpretation, for example an editor or transcriber.
Status Optional
Datatype 1–∞ occurrences of 
data.pointer
separated by whitespace
Values A pointer to an element in the document header that is associated with a person asserted as responsible for some aspect of the text's creation, transcription, editing, or encoding.

3.24. att.segLike

att.segLike provides attributes for elements used for arbitrary segmentation.
Moduletei
Memberss cl phr w m c pc
AttributesAttributes
functioncharacterizes the function of the segment.
Status Optional
Datatype
data.enumerated
Values For a <cl>, may take values such as coordinate, subject, adverbial etc. For a <phr>, such values as subject, predicate etc. may be more appropriate.
partspecifies whether or not the segment is fragmented by some other structural element, for example a clause which is divided between two or more sentences.
Status Optional
Legal values are:
Y
(yes) the segment is incomplete in some respect
N
(no) either the segment is complete, or no claim is made as to its completeness [Default]
I
(initial) the initial part of an incomplete segment
M
(medial) a medial part of an incomplete segment
F
(final) the final part of an incomplete segment
Note The values I, M, or F should be used only where it is clear how the division is to be reconstituted.

3.25. att.sortable

att.sortable provides attributes for elements in lists or groups that are sortable, but whose sorting key cannot be derived mechanically from the element content.
Moduletei
Membersterm list item bibl biblStruct listBibl idno biblFull listChange listRelation
AttributesAttributes
sortKeysupplies the sort key for this element in an index, list or group which contains it.
Status Optional
Datatype
data.word
Values a sequence of characters which, when sorted with the other values, will produced the desired order; specifics of sort key construction are application-dependent.
David's other principal backer, Josiah ha-Kohen <index   indexName="NAMES">  <term    sortKey="Azarya_Josiah_Kohen">Josiah ha-Kohen b. Azarya</term> </index> b. Azarya, son of one of the last gaons of Sura was David's own first cousin.
Note The sort key is used to determine the sequence and grouping of entries in an index. Dictionary order often differs from the collation sequence of machine-readable character sets; in English-language dictionaries, an entry for 4-H will often appear alphabetized under ‘fourh’, and McCoy may be alphabetized under‘maccoy’, while A1, A4, and A5 may all appear in numeric order ‘alphabetized’ between ‘a-’ and ‘AA’. The sort key is required if the orthography of the dictionary entry does not suffice to determine its location.

3.26. att.sourced

att.sourced provides attributes identifying the source edition from which some encoded feature derives.
Moduletei
Memberspb lb cb refState
AttributesAttributes
ed(edition) supplies an arbitrary identifier for the source edition in which the associated feature (for example, a page, column, or line break) occurs at this point in the text.
Status Optional
Datatype 1–∞ occurrences of 
data.code
separated by whitespace
Values Any string of characters; usually a siglum conventionally used for the edition.
Example
<l>Of Mans First Disobedience,<lb ed="1674"/> and<lb ed="1667"/> the Fruit</l> <l>Of that Forbidden Tree, whose<lb ed="1667 1674"/> mortal tast</l> <l>Brought Death into the World,<lb ed="1667"/> and all<lb ed="1674"/> our woe,</l>

3.27. att.spanning

att.spanning provides attributes for elements which delimit a span of text by pointing mechanisms rather than by enclosing it.
Moduletei
Membersgb pb lb cb
AttributesAttributes
spanToindicates the end of a span initiated by the element bearing this attribute.
Status Optional
Datatype
data.pointer
Values points to an element following this one in the current document.
Note The span is defined as running in document order from the start of the content of the pointing element (if any) to the end of the content of the element pointed to by the spanTo attribute (if any). If no value is supplied for the attribute, the assumption is that the span is coextensive with the pointing element.

3.28. att.tableDecoration

att.tableDecoration provides attributes used to decorate rows or cells of a table.
Moduletei
Membersrow cell
AttributesAttributes
roleindicates the kind of information held in this cell or in each cell of this row.
Status Optional
Datatype
data.enumerated
Suggested values include:
label
labelling or descriptive information only.
data
data values. [Default]
Note When this attribute is specified on a row, its value is the default for all cells in this row. When specified on a cell, its value overrides any default specified by the role attribute of the parent <row> element.
rowsindicates the number of rows occupied by this cell or row.
Status Optional
Datatype
data.count
Values A number; a value greater than one indicates that this cell (or row) spans several rows.
Note Where several cells span several rows, it may be more convenient to use nested tables.
cols(columns) indicates the number of columns occupied by this cell or row.
Status Optional
Datatype
data.count
Values A number; a value greater than one indicates that this cell or row spans several columns.
Note Where an initial cell spans an entire row, it may be better treated as a heading.

3.29. att.transcriptional

att.transcriptional provides attributes specific to elements encoding authorial or scribal intervention in a text when transcribing manuscript or similar sources.
Moduletei
Membersadd del
AttributesAttributes att.editLike (@evidence, @source, @instant) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.responsibility (@cert, @resp))
handsignifies the hand of the agent which made the intervention.
Status Optional
Datatype
data.pointer
Values must refer to a <handNote> element, typically declared in the document header (see section 11.3.2.1. ).
statusindicates the effect of the intervention, for example in the case of a deletion, strikeouts which include too much or too little text, or in the case of an addition, an insertion which duplicates some of the text already present.
Status Optional
Datatype
data.enumerated
Sample values include:
duplicate
all of the text indicated as an addition duplicates some text that is in the original, whether the duplication is word-for-word or less exact.
duplicate-partial
part of the text indicated as an addition duplicates some text that is in the original
excessStart
some text at the beginning of the deletion is marked as deleted even though it clearly should not be deleted.
excessEnd
some text at the end of the deletion is marked as deleted even though it clearly should not be deleted.
shortStart
some text at the beginning of the deletion is not marked as deleted even though it clearly should be.
shortEnd
some text at the end of the deletion is not marked as deleted even though it clearly should be.
partial
some text in the deletion is not marked as deleted even though it clearly should be.
unremarkable
the deletion is not faulty. [Default]
Note Status information on each deletion is needed rather rarely except in critical editions from authorial manuscripts; status information on additions is even less common. Marking a deletion or addition as faulty is inescapably an interpretive act; the usual test applied in practice is the linguistic acceptability of the text with and without the letters or words in question.
causedocuments the presumed cause for the intervention.
Status Optional
Datatype
data.enumerated
Legal values are:
fix
repeated for the purpose of fixation
unclear
repeated to clarify a previously illegible or badly written text or mark
seq(sequence) assigns a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred.
Status Mandatory when applicable
Datatype
data.count

3.30. att.translatable

att.translatable provides attributes used to indicate the status of a translatable portion of an ODD document.
Moduletei
Membersdesc
AttributesAttributes
versionspecifies the version name or number of the source from which the translated version was derived
Status Optional
Datatype
data.word
Note The version may be a number, a letter, or a date

3.31. att.typed

att.typed provides attributes which can be used to classify or subclassify elements in any way.
Moduletei
Membersquote term add del name date time ptr ref head note gb pb lb cb bibl biblStruct listBibl application change text div notatedMusic figure persName surname forename listRelation s cl phr w m c pc
AttributesAttributes
typecharacterizes the element in some sense, using any convenient classification scheme or typology.
Status Optional
Datatype
data.enumerated
Note The type attribute is present on a number of elements, not all of which are members of att.typed.
subtypeprovides a sub-categorization of the element, if needed
Status Optional
Datatype
data.enumerated
Note The subtype attribute may be used to provide any sub-classification for the element, additional to that provided by its type attribute.
Note When appropriate, use values from an established typology. Otherwise, define a typology using the <classification> element of the <encodingDesc> within the associated TEI header, or as a list within one of the components of the <encodingDesc> element, or informally as descriptive prose within the <encodingDesc> element.

4. Macros

4.1. data.certainty

data.certainty defines the range of attribute values expressing a degree of certainty.
Moduletei
Used by
Declaration
data.certainty = "high" | "medium" | "low" | "unknown"
Note Certainty may be expressed by one of the predefined symbolic values high, medium, or low. The value unknown should be used in cases where the encoder does not wish to assert an opinion about the matter. For more precise indication, data.probability may be used instead or in addition.

4.2. data.code

data.code defines the range of attribute values expressing a coded value by means of a pointer to some other element which contains a definition for it.
Moduletei
Used by
Declaration
data.code = xsd:anyURI
Note It will usually be the case that the item pointed to is to be found somewhere else in the current TEI document, typically in the header, but this is not mandatory.

4.3. data.count

data.count defines the range of attribute values used for a non-negative integer value used as a count.
Moduletei
Used by
Element:
  • refState/@length
  • table/@rows
  • table/@cols
  • tagUsage/@occurs
  • tagUsage/@withId
Declaration
data.count = xsd:nonNegativeInteger
Note Only positive integer values (including zero) are permitted

4.4. data.duration.iso

data.duration.iso defines the range of attribute values available for representation of a duration in time using ISO 8601 standard formats
Moduletei
Used by
Declaration
data.duration.iso = token { pattern = "[0-9.,DHMPRSTWYZ/:+\-]+" }
Example
<time dur-iso="PT0,75H">three-quarters of an hour</time>
Example
<date dur-iso="P1,5D">a day and a half</date>
Example
<date dur-iso="P14D">a fortnight</date>
Example
<time dur-iso="PT0.02S">20 ms</time>
Note A duration is expressed as a sequence of number-letter pairs, preceded by the letter P; the letter gives the unit and may be Y (year), M (month), D (day), H (hour), M (minute), or S (second), in that order. The numbers are all unsigned integers, except for the last, which may have a decimal component (using either . or , as the decimal point; the latter is preferred). If any number is 0, then that number-letter pair may be omitted. If any of the H (hour), M (minute), or S (second) number-letter pairs are present, then the separator T must precede the first ‘time’ number-letter pair. For complete details, see ISO 8601 Data elements and interchange formats — Information interchange — Representation of dates and times.

4.5. data.duration.w3c

data.duration.w3c defines the range of attribute values available for representation of a duration in time using W3C datatypes.
Moduletei
Used by
Declaration
data.duration.w3c = xsd:duration
Example
<time dur="PT45M">forty-five minutes</time>
Example
<date dur="P1DT12H">a day and a half</date>
Example
<date dur="P7D">a week</date>
Example
<time dur="PT0.02S">20 ms</time>
Note A duration is expressed as a sequence of number-letter pairs, preceded by the letter P; the letter gives the unit and may be Y (year), M (month), D (day), H (hour), M (minute), or S (second), in that order. The numbers are all unsigned integers, except for the S number, which may have a decimal component (using . as the decimal point). If any number is 0, then that number-letter pair may be omitted. If any of the H (hour), M (minute), or S (second) number-letter pairs are present, then the separator T must precede the first ‘time’ number-letter pair. For complete details, see the W3C specification.

4.6. data.enumerated

data.enumerated defines the range of attribute values expressed as a single XML name taken from a list of documented possibilities.
Moduletei
Used by
Element:
  • abbr/@type
  • biblScope/@type
  • formula/@notation
  • idno/@type
  • list/@type
  • num/@type
  • pc/@force
  • pc/@unit
  • q/@type
  • refState/@unit
  • teiHeader/@type
  • title/@type
Declaration
data.enumerated = data.name
Note Attributes using this datatype must contain a word which follows the rules defining a legal XML name (see http://www.w3.org/TR/REC-xml/#dt-name): for example they cannot include whitespace or begin with digits. Typically, the list of documented possibilities will be provided (or exemplified) by a value list in the associated attribute specification, expressed with a <valList> element.

4.7. data.key

data.key defines the range of attribute values expressing a coded value by means of an arbitrary identifier, typically taken from a set of externally-defined possibilities.
Moduletei
Used by
Element:
  • w/@lemma
Declaration
data.key = string
Note Information about the set of possible values for an attribute using this datatype may (but need not) be documented in the document header. Externally defined constraints, for example that values should be legal keys in an external database system, cannot usually be enforced by a TEI system. Similarly, because the key is externally defined, no constraint other than a requirement that it consist of Unicode characters is possible.

4.8. data.language

data.language defines the range of attribute values used to identify a particular combination of human language and writing system.
Moduletei
Used by
Element:
  • textLang/@mainLang
  • textLang/@otherLangs
Declaration
data.language = xsd:language
Note The values for this attribute are language ‘tags’ as defined in BCP 47. Currently BCP 47 comprises RFC 4646 and RFC 4647; over time, other IETF documents may succeed these as the best current practice. A ‘language tag’, per BCP 47, is assembled from a sequence of components or subtags separated by the hyphen character (-, U+002D). The tag is made of the following subtags, in the following order. Every subtag except the first is optional. If present, each occurs only once, except the fourth and fifth components (variant and extension), which are repeatable.
language
The IANA-registered code for the language. This is almost always the same as the ISO 639 2-letter language code if there is one. The list of available registered language subtags can be found at http://www.iana.org/assignments/language-subtag-registry. It is recommended that this code be written in lower case.
script
The ISO 15924 code for the script. These codes consist of 4 letters, and it is recommended they be written with an initial capital, the other three letters in lower case. The canonical list of codes is maintained by the Unicode Consortium, and is available at http://unicode.org/iso15924/iso15924-codes.html. The IETF recommends this code be omitted unless it is necessary to make a distinction you need.
region
Either an ISO 3166 country code or a UN M.49 region code that is registered with IANA (not all such codes are registered, e.g. UN codes for economic groupings or codes for countries for which there is already an ISO 3166 2-letter code are not registered). The former consist of 2 letters, and it is recommended they be written in upper case. The list of codes can be found at http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/index.html. The latter consist of 3 digits; the list of codes can be found at http://unstats.un.org/unsd/methods/m49/m49.htm.
variant
An IANA-registered variation. These codes ‘are used to indicate additional, well-recognized variations that define a language or its dialects that are not covered by other available subtags’.
extension
An extension has the format of a single letter followed by a hyphen followed by additional subtags. These exist to allow for future extension to BCP 47, but as of this writing no such extensions are in use.
private use
An extension that uses the initial subtag of the single letter x (i.e., starts with x-) has no meaning except as negotiated among the parties involved. These should be used with great care, since they interfere with the interoperability that use of RFC 4646 is intended to promote. In order for a document that makes use of these subtags to be TEI conformant, a corresponding <language> element must be present in the TEI header.
There are two exceptions to the above format. First, there are language tags in the IANA registry that do not match the above syntax, but are present because they have been ‘grandfathered’ from previous specifications. Second, an entire language tag can consist of only a private use subtag. These tags start with x-, and do not need to follow any further rules established by the IETF and endorsed by these Guidelines. Like all language tags that make use of private use subtags, the language in question must be documented in a corresponding <language> element in the TEI header. Examples include
sn
Shona
zh-TW
Taiwanese
zh-Hant-HK
Chinese written in traditional script as used in Hong Kong
en-SL
English as spoken in Sierra Leone
pl
Polish
es-MX
Spanish as spoken in Mexico
es-419
Spanish as spoken in Latin America
The W3C Internationalization Activity has published a useful introduction to BCP 47, Language tags in HTML and XML.

4.9. data.name

data.name defines the range of attribute values expressed as an XML Name.
Moduletei
Used by
data.enumeratedElement:
  • application/@ident
  • tagUsage/@gi
Declaration
data.name = xsd:Name
Note Attributes using this datatype must contain a single word which follows the rules defining a legal XML name (see http://www.w3.org/TR/REC-xml/#dt-name): for example they cannot include whitespace or begin with digits.

4.10. data.namespace

data.namespace defines the range of attribute values used to indicate XML namespaces as defined by the W3C Namespaces in XML Technical Recommendation.
Moduletei
Used by
Element:
  • namespace/@name
Declaration
data.namespace = xsd:anyURI
Note The range of syntactically valid values is defined by RFC 3986 Uniform Resource Identifier (URI): Generic Syntax

4.11. data.numeric

data.numeric defines the range of attribute values used for numeric values.
Moduletei
Used by
Element:
  • graphic/@scale
  • num/@value
Declaration
data.numeric = xsd:double | token { pattern = "(\-?[\d]+/\-?[\d]+)" } | xsd:decimal
Note Any numeric value, represented as a decimal number, in floating point format, or as a ratio. To represent a floating point number, expressed in scientific notation, ‘E notation’, a variant of ‘exponential notation’, may be used. In this format, the value is expressed as two numbers separated by the letter E. The first number, the significand (sometimes called the mantissa) is given in decimal format, while the second is an integer. The value is obtained by multiplying the mantissa by 10 the number of times indicated by the integer. Thus the value represented in decimal notation as 1000.0 might be represented in scientific notation as 10E3. A value expressed as a ratio is represented by two integer values separated by a solidus (/) character. Thus, the value represented in decimal notation as 0.5 might be represented as a ratio by the string 1/2.

4.12. data.outputMeasurement

data.outputMeasurement defines a range of values for use in specifying the size of an object that is intended for display on the web.
Moduletei
Used by
Element:
  • graphic/@width
  • graphic/@height
Declaration
data.outputMeasurement = token { pattern = "[\-+]?\d+(\.\d+)?(%|cm|mm|in|pt|pc|px|em|ex|gd|rem|vw|vh|vm)" }
Example
<figure>  <head>The TEI Logo</head>  <figDesc>Stylized yellow angle brackets with the letters <mentioned>TEI</mentioned> in    between and <mentioned>text encoding initiative</mentioned> underneath, all on a white    background.</figDesc>  <graphic    height="600px"    url="http://www.tei-c.org/logos/TEI-600.jpg"    width="600px"/> </figure>
Note These values map directly onto the values used by XSL-FO and CSS. For definitions of the units see those specifications; at the time of this writing the most complete list is in the CSS3 working draft.

4.13. data.pattern

data.pattern (regular expression pattern) defines attribute values which are expressed as a regular expression.
Moduletei
Used by
Element:
  • cRefPattern/@matchPattern
Declaration
data.pattern = token
Note
A regular expression, often called a pattern, is an expression that describes a set of strings. They are usually used to give a concise description of a set, without having to list all elements. For example, the set containing the three strings Handel, Händel, and Haendel can be described by the pattern H(ä|ae?)ndel (or alternatively, it is said that the pattern H(ä|ae?)ndel matches each of the three strings)
wikipedia

4.14. data.pointer

data.pointer defines the range of attribute values used to provide a single URI pointer to any other resource, either within the current document or elsewhere.
Moduletei
Used by
Element:
  • change/@target
  • graphic/@url
  • normalization/@source
  • note/@targetEnd
  • span/@from
  • span/@to
  • tagUsage/@render
  • term/@cRef
  • w/@lemmaRef
Declaration
data.pointer = xsd:anyURI
Note The range of syntactically valid values is defined by RFC 3986 Uniform Resource Identifier (URI): Generic Syntax. Note that the values themselves are encoded using RFC 3987 Internationalized Resource Identifiers (IRIs) mapping to URIs. For example, https://secure.wikimedia.org/wikipedia/en/wiki/% is encoded as https://secure.wikimedia.org/wikipedia/en/wiki/%25 while http://موقع.وزارة-الاتصالات.مصر/ is encoded as http://xn--4gbrim.xn----rmckbbajlc6dj7bxne2c.xn--wgbh1c/

4.15. data.probability

data.probability defines the range of attribute values expressing a probability.
Moduletei
Used by
Declaration
data.probability = xsd:double { minInclusive = "0" maxInclusive = "1" }
Note Probability is expressed as a real number between 0 and 1; 0 representing certainly false and 1 representing certainly true.

4.16. data.temporal.iso

data.temporal.iso defines the range of attribute values expressing a temporal expression such as a date, a time, or a combination of them, that conform to the international standard Data elements and interchange formats – Information interchange – Representation of dates and times.
Moduletei
Used by
Declaration
data.temporal.iso = xsd:date | xsd:gYear | xsd:gMonth | xsd:gDay | xsd:gYearMonth | xsd:gMonthDay | xsd:time | xsd:dateTime | token { pattern = "[0-9.,DHMPRSTWYZ/:+\-]+" }
Note If it is likely that the value used is to be compared with another, then a time zone indicator should always be included, and only the dateTime representation should be used. For all representations for which ISO 8601 describes both a basic and an extended format, these Guidelines recommend use of the extended format. While ISO 8601 permits the use of both 00:00 and 24:00 to represent midnight, these Guidelines strongly recommend against the use of 24:00.

4.17. data.temporal.w3c

data.temporal.w3c defines the range of attribute values expressing a temporal expression such as a date, a time, or a combination of them, that conform to the W3C XML Schema Part 2: Datatypes specification.
Moduletei
Used by
Element:
  • docDate/@when
Declaration
data.temporal.w3c = xsd:date | xsd:gYear | xsd:gMonth | xsd:gDay | xsd:gYearMonth | xsd:gMonthDay | xsd:time | xsd:dateTime
Note If it is likely that the value used is to be compared with another, then a time zone indicator should always be included, and only the dateTime representation should be used.

4.18. data.truthValue

data.truthValue defines the range of attribute values used to express a truth value.
Moduletei
Used by
Element:
  • listChange/@ordered
  • note/@anchored
  • pc/@pre
Declaration
data.truthValue = xsd:boolean
Note The possible values of this datatype are 1 or true, or 0 or false.
Note This datatype applies only for cases where uncertainty is inappropriate; if the attribute concerned may have a value other than true or false, e.g. unknown, or inapplicable, it should have the extended version of this datatype: data.xTruthValue.

4.19. data.version

data.version defines the range of attribute values which may be used to specify a TEI version number.
Moduletei
Used by
Element:
  • TEI/@version
Declaration
data.version = token { pattern = "[\d]+(\.[\d]+){0,2}" }
Note The pattern specified matches values defined by the Unicode consortium for its version number (reference). The version number contains digits and fullstop characters only. The first number supplied identifies the major version number. A second and third number, for minor and sub-minor version numbers, may also be supplied.

4.20. data.word

data.word defines the range of attribute values expressed as a single word or token.
Moduletei
Used by
Element:
  • biblScope/@from
  • biblScope/@to
  • m/@baseForm
  • ptr/@cRef
  • ref/@cRef
Declaration
data.word = token { pattern = "(\p{L}|\p{N}|\p{P}|\p{S})+" }
Note Attributes using this datatype must contain a single ‘word’ which contains only letters, digits, punctuation characters, or symbols: thus it cannot include whitespace.

4.21. data.xTruthValue

data.xTruthValue (extended truth value) defines the range of attribute values used to express a truth value which may be unknown.
Moduletei
Used by
Declaration
data.xTruthValue = xsd:boolean | "unknown" | "inapplicable"
Note In cases where where uncertainty is inappropriate, use the datatype data.TruthValue.

4.22. macro.limitedContent

macro.limitedContent (paragraph content) defines the content of prose elements that are not used for transcription of extant materials.
Moduletei
Used by
desc meeting rendition tagUsage
Declaration
macro.limitedContent = ( text | model.limitedPhrase | model.inter )*

4.23. macro.paraContent

macro.paraContent (paragraph content) defines the content of paragraphs and similar elements.
Moduletei
Used by
add cell del docEdition emph hi p ref title
Declaration
macro.paraContent = ( text | model.gLike | model.phrase | model.inter | model.global )*

4.24. macro.phraseSeq

macro.phraseSeq (phrase sequence) defines a sequence of character data and phrase-level elements.
Moduletei
Used by
abbr addrLine affiliation author biblScope cl docAuthor docDate editor email expan forename headItem headLabel label name num persName phr pubPlace publisher s street surname term textLang
Declaration
macro.phraseSeq = ( text | model.gLike | model.phrase | model.global )*

4.25. macro.phraseSeq.limited

macro.phraseSeq.limited (limited phrase sequence) defines a sequence of character data and those phrase-level elements that are not typically used for transcribing extant documents.
Moduletei
Used by
span
Declaration
macro.phraseSeq.limited = ( text | model.limitedPhrase | model.global )*

4.26. macro.specialPara

macro.specialPara ('special' paragraph content) defines the content model of elements such as notes or list items, which either contain a series of component-level elements or else have the same structure as a paragraph, containing a series of phrase-level and inter-level elements.
Moduletei
Used by
change item licence note q quote
Declaration
macro.specialPara = ( text | model.gLike | model.phrase | model.inter | model.divPart | model.global )*

4.27. macro.xtext

macro.xtext (extended text) defines a sequence of character data and gaiji elements.
Moduletei
Used by
c idno
Declaration
macro.xtext = ( text | model.gLike )*
Jonathon Read, generated by Roma 4.7. Date: 2012-02-01
This page is copyrighted