Macintosh Project ODD and Diplomatic Transcription of a New World Epistolary Corpus

Table of contents

1. Documentation of an encoding for the Macintosh Project's letter transcription markup work.

This guide aims to detail how the different letters of the corpus can be encoded for linguistic analysis and the production of lasting, interoperable and consultable data.

Each letter of the corpus is transcribed and tagged in a file in XML-TEI format and is validated by a RelaxNG file.

1.1. Identification and organization of data

Each letter must have an independent file containing:

  • all digital reproductions (photo files) of the letter.
  • the transcription of the letter in an XML-TEI file.


Each file must have a unique identifier including the following information (all linked by a hyphen):

  • lconsultation rating (if the rating includes a "/", do not include the "/" in the name of the folder and the file (it will however be included inside the tags of the TEI files).
  • surname of the sender.
  • the year of issue of the letter.

 ⚓

An example of a folder name:
For a letter with a rating of HCA 32/390, the sender is a Dupaty and whose issue date is 1758, the name of the transcription folder will therefore be HCA-32390-Dupaty-1758. This identifier must also be used to name the transcription .xml file. If there are several letters from the same sender, add -1, -2 to the end of the identifier. Example:
HCA-32390-Dupaty-1758-1, HCA-32390-Dupaty-1758-2, etc.

To the photo files, we add the initials "R" for front, "V" for back.
Ex. HCA-32390-Dupaty-1758-1R ; HCA-32390-Dupaty-1758-1V.


If the letter has more than one folio = HCA-3290-Dupaty-1758-2R ; HCA-3290-Dupaty-1758-2V, etc.

N.B. If we have several letters from the same transmitter, this gives:
HCA-32390-Dupaty-1758-1-1R, HCA-32390-Dupaty-1758-1-1V ; HCA-32390-Dupaty-1758-2-1R, HCA-32390-Dupaty-1758-2-1V, etc.

If an image corresponds to an envelope, it is named as follows:HCA-32390-Dupaty-1758-envelope
(and possibly if the envelope has two sides: HCA-32390-Dupaty-1758-envelope-R et HCA-32390-Dupaty-1758-envelope-V. In these cases, enter the address in the <front> tag, starting the paragraph with a reference to the corresponding envelope (or face of the envelope).
<front>  <pb n="r"   facs="# HCA-32390-Dupaty-1758-envelope-R"/>. <p>   <address>    <addrLine> <!--Transcribe the text of the letter with the address -->    </addrLine>   </address>  </p> </front>

1.2. Structure of the XML file

The XML document is entirely contained in a root element <TEI>, itself divided into three parts:

1.2.1. teiHeader

The <teiHeader> gathers the tags providing information on the metadata of the original letters (example: <sourceDesc> gathers the ratings and identifiers, content of the document, the material description of the work), the edition in XML format (example: the elements <titleStmt>, <editionStmt>, <publicationStmt> group together title, statements of responsibility, distribution terms, etc.) as well as on the elements concerning the paratext (example: content of the <profileDesc> : lists of places and people mentioned).

1.2.2. facsimile

The <facsimile> element contains all the data concerning the images allowing the facsimile visualization of the edition. The information concerning each image is contained in <surface> tags that reference the path to the image in question as well as whether it is the front or back of the letter.

1.2.3. text

Finally, the <text> element encompasses the entire transcription of a letter. The transcription is marked up first in a <front> element that contains the transcription of the addresses of the recipients and senders of the mail. The transcribed message of the letter is marked up in an <body> element and then in an <p> tag.

1.2.4. Structure of the teiHeader

The <teiHeader> has two main sections:

  • fileDesc (file description) contains a full bibliographic description of an electronic file.
  • profileDesc (text-profile description) provides a detailed description of non-bibliographic aspects of a text, specifically the languages ​​and sublanguages ​​used, the situation in which it was produced, the participants and their setting.

The <fileDesc> contains information about the document itself and the <profileDesc> describes the content of the document (places and people mentioned)

1.2.4.1. The fileDesc

The <fileDesc> has the following tags:

  • titleStmt (title statement) groups information about the title of a work and those responsible for its content.
  • editionStmt (edition statement) groups information relating to one edition of a text.
  • publicationStmt (publication statement) groups information concerning the publication or distribution of an electronic or other text.
  • sourceDesc (source description) describes the source(s) 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.

<titleStmt>, <editionStmt> and <publicationStmt> provide information regarding the present letter studied. <sourceDesc> provides information regarding the original document on which the encoding is based.

1.2.4.1.1. The tags titleStmt, editionStmt, publicationStmt

<titleStmt> contains only the mention of the subject of the project. <editionStmt> provides information on the work of the transcription phase (<edition>) thus the person responsible for this one (<respStmt>).

<editionStmt> <edition>Version 1.0<date>June 2023</date> </edition> <respStmt> <resp>Transcription</resp> <persName>Yan Greub</persName>  </respStmt>  <respStmt>   <resp>Encoding and proofreading</resp> <persName>Beatrice Dal Bo</persName> <persName>Laura-Maï Dourdy</persName> </respStmt> </editionStmt>

The tag <publicationStmt> provides information about the publication and distribution of the document. The <publisher> refers to the institution responsible for this markup work. The tag <availability> provides information about the type of license that applies here.

1.2.4.1.2. La balise sourceDesc

<sourceDesc> describes the source from which the encoding comes.

The tag <msIdentifier> provides the means of identifying the document: place of conservation and the rating through the tag <idno> .

The element <physDesc> contains all the information on the appearance and material condition of the document source: the description of the object (<objectDesc>) including the total number of written surfaces of the correspondence (<extent>) and information on the hands involved in writing the letter (<handDesc>). In the latter case, there may be several writers for a letter (it is possible that a third party writes on the envelope, another the content of the letter and a last one signs). Also, inside <handDesc>, as many <handNote> tags are open as there are writers.

1.2.4.1.2.1. handNote
The tag <handNote> designates the singular hand of a writer of the letter. Also, there are as many <handNote> tags as there are writers and each tag thus has an attribute xml:id with the value hand_n, 'n' being the number of a writer
<handNote xml:id="hand_1"> Scripteur de l'enveloppe: <persName ref="#Martin_Dubois">   <forename>Martin</forename>   <surname>Dubois</surname>   <name/>  </persName> </handNote> <handNote xml:id="hand_2"> Scripteur de la lettre : <persName ref="#Fabien_Laurent">   <forename>Fabien</forename>   <surname>Laurent</surname>   <name/>  </persName> </handNote>
<handNote xml:id="hand_1"> Scripteur: <persName ref="#Louis_Leclerc">   <forename>Louis</forename>   <surname>Leclerc</surname>   <name/>  </persName> </handNote>

1.2.4.2. profileDesc

Le <profileDesc> contains notices and information about the people or organizations in the letter who play the following roles:

  • the sender.
  • the recipient.
  • the secretary (if someone other than the sender is writing the letter).
  • the intermediary (if the letter states that the letter is to be sent to a third party, the intermediary, to deliver it to the recipient).


Le <profileDesc> also provides information on the places where the letter was written, sent, received and arrived. Each of the notices has a unique identifier to point to each time they appear in the text.

Thus, in a <settingDesc> tag, we can open a <listPlace> tag that lists and gives an identifier to all the places mentioned in the textual content. This tag thus provides a directory of the places in the text, by entering them inside a tag <place>associated with a xml:id: the <placeName> element is used to identify a place. It can be completed with the type attribute, to provide information on the nature of the place (city, island, district, province, region).
<listPlace>  <place xml:id="Brest" type="city">   <placeName>Brest</placeName>  </place> </listPlace>

The tag <langUsage> describes the language used in the document studied (in the case of our corpus, the language used is only French).

<langUsage>  <language ident="fr">français</language> </langUsage>
1.2.4.2.1. correspDesc ​​and description of correspondence movements
The tag <correspDesc> contains the description of the circumstances and parameters related to the correspondence. It thus includes the element <correspAction> which contains a structured description of the place, the name of the person or organization and the date related to the sending or receiving of the message.
<correspDesc>  <correspAction type="sent">   <persName ref="#Elizabeth_Bienvenu"> Elizabeth Bienvenu   </persName>   <date when="1670-03-06">06-03-1670</date>   <placeName ref="#Tremblade"    type="composition">Tremblade</placeName>   <placeName ref="#Tremblade"    type="provenance">Tremblade</placeName>  </correspAction>  <correspAction type="received">   <persName ref="#Elizabeth_Bienvenu">Bienvenu</persName>   <placeName ref="#Rochelle" type="address">Rochelle</placeName>   <placeName ref="#Rochelle"    type="destination">Rochelle</placeName>  </correspAction> </correspDesc>
1.2.4.2.2. particDesc and the recipients/addressees

The tag <particDesc> describes the speakers or other identifiable participants in a linguistic interaction. We can therefore identify the author of the letter and the recipient using this tag and its sub-elements. If they are natural persons, we will use the tag <listPerson> and if they are legal persons, the tag <listOrg>.
The <listPerson> concerns, as has been said, the physical persons who occupy the roles of sender, recipient, secretary, intermediary.
It contains tags <person> which allow to group together all the information concerning the individuals.

<listPerson>  <person xml:id="Elizabeth_Bienvenu">   <sex value="F"> feminin   </sex>   <occupation/>   <persName>    <forename> Elisabeth    </forename>    <surname> Bienvenu    </surname>   </persName>  </person>  <person xml:id="xxx_Bienvenu">   <sex value="M">masculin   </sex>   <occupation> Capitaine de marine, Commandant   </occupation>   <persName>    <forename/>    <surname/>   </persName>  </person> </listPerson>
We can complete what we have previously tagged with a tag <listRelation> which gives information on the relationships that exist between people or legal entities. These relationships are encoded in elements <relation> and can be completed with a short description (<desc>). In the tag <relation>, we can categorize the relation with the attribute type which takes the values ​​"personal" (private, personal relation) or "social" (professional relation, formalities, etc...) and with the attribute name which defines a name for the relation. If we do not have enough information to give a name to the relation, we can give the value "unknow^n". If the information is sufficient, for relations of type "personal", we expect as a minimum value of name "friends" (friendly relation) and "family" (family relation), and for that of type "social", we expect at least "professional". However, if the information is sufficient, it is possible to develop the name of the relation:
  • acquaintances
  • aunt
  • child
  • cousins
  • employee
  • engaged
  • family
  • father
  • friends
  • family
  • grandchild
  • grandparent
  • lover
  • mother
  • nephew
  • parent
  • partners
  • professional
  • siblings
  • sisters-in-law
  • stepdaughter
  • supervisor
  • spouse
  • uncle
  • unknown
In addition, the members of the relationship have either an active or passive attribute (in the case where it is a suffered relationship, e.g. P1 is the father or employer of P2 but the reverse is not true, P2 is neither the father nor the employer of P1).
<listRelation>  <relation type="personnal" name="parent"   active="#X_Bienvenu" passive="#Elizabeth_Bienvenu">   <desc> Le captiaine Bienvenu est le parent de d'Elisabeth   </desc>  </relation>  <relation type="personnal" name="child"   active="Elizabeth_Bienvenu" passive="#X_Bienvenu">   <desc> Elizabeth est l'enfant du capitiaine Bienvenu   </desc>  </relation>  <relation type="social" nom="supervisor"   active="#X_Bienvenu" passive="le_mousse">   <desc> Le capitaine Bienvenu est le supérieur du mousse.   </desc>  </relation> </listRelation>
soit mutual si la relation est mutuelle (P1 et P2 sont mutuellement frères ou époux).
<listRelation>  <relation type="personnal" name="siblings"   mutual="#Elizabeth_Bienvenu #Jean_Bienvenu">   <desc> Elizabeth et Jean sont frère et soeur.   </desc>  </relation> </listRelation>

1.2.5. Text structure

The letters are structured with the help of the following tags:

  • 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.
  • front (front matter) contains any prefatory matter (headers, abstracts, title page, prefaces, dedications, etc.) found at the start of a document, before the main body.
  • p (Contenu textuel) contient le contenu textuel de la lettre.
  • UNKNOWN ELEMENT adress
  • UNKNOWN ELEMENT adressline
  • body (text body) contains the whole body of a single unitary text, excluding any front or back matter.

1.2.5.1. Reproduction of the structure of the letter

To represent the formatting of the original letter, the following tags can be used:

  • <pb>, a self-closing tag that marks the beginning of a page.
  • <lb>, a self-closing tag that marks a line break.

Each new page is numbered using the n attribute.

1.3. Transcription of letters

The aim of this edition is to offer a visualization of the transcription, associated with the digitization of the letters. Transcription choices have been made.

1.3.1. Segmentation of lexical units

Use of the tag <w> to indicate lexical units that are welded or over-segmented in the original text.
Example:mafamme « ma femme » = <w>ma</w> <w>famme</w> en fans « enfant » = <w>en fans</w>.
If the word has a line break, also use the tag <w>: <w> in <lb> fans. If the liaison is noted in writing, the liaison consonant is considered to belong to the right segment.
<p> petis <w>zan fan</w>. </p>

1.3.2. Crossed-out passages, underlined passages

Crossed-out passages are indicated using the tag <del> with the attribute rend and the value overstrike. It is possible to use this tag to indicate an illegible crossed-out passage. Underlined passages are indicated using the <hi> tag with the rend attribute and the underline value.

1.3.3. Reporting illegible or uncertain passages

Missing passages (holes, tears, etc.) are reported using the tag <gap> Passages for which the interpretation is uncertain are reported using the tag <unclear>.

1.3.4. Punctuation

Do not add any punctuation marks. Reproduce punctuation as it appears in the document, only if it is present.

1.3.5. Diacritics

For the apostrophe: if it is absent, introduce the tag<w>
con « qu’on » = <w>c</w> <w>on</w>.
If the apostrophe is in the original, reproduce it as is: ’ (whether or not there is agglutination). For accents: reproduce the accents, if any, where they appear and as they appear (as far as possible), without adding any that do not appear in the original.

1.3.6. Lowercase/uppercase distinction

To the extent that it is possible to distinguish uppercase from lowercase, preserve their distribution (particular attention should be paid to capitals placed at the initials of letters, in addresses, titles, proper names and places). Do not reinstate according to modern common usage.

1.3.7. Abréviations

Abbreviations are not resolved. They are indicated by the <abbr> tag. Interlinear additions can be included within the <abbr> tag by using the <add> tag with a place attribute whose values ​​indicate the position of the additions.
Ex. : "Mr", Monsieur written in abbreviated form with a superscript "r" = <abbr>M<add place="superscript">r</add> </abbr>.

1.3.8. Overhead or Marginal Text

The tag <add> can be used to indicate text additions. To indicate the location of the additions, the tag is completed with the place attribute and the following values:

  • above, for interlinear additions above
  • below, for interlinear additions below
  • margin, for additions in the margin

To indicate overloaded texts, the <del> element is used with the rend attribute and the overtyped

To indicate obvious graphic errors (graphic overload, for example) or a partial destruction of the text of a letter, rendered with difficulty readable but still decipherable (burned area, for example), it is recommended to use the tag <choice> (groups possible alternative markups). In this tag <choice>, inside we use the element <sic> which contains the original text with incorrect spelling and the element <corr> which contains a correction of said original text.
if we encounter an error of the type "... le lpauvre..." in the text, we mark it as follows: le <choice>  <sic>lpauvre</sic>  <corr>pauvre</corr> </choice>

1.3.9. Physiognomy of the text

Tag <front>: text before the body of the letter (always the address, sometimes on an envelope) Tag <back>: text after the body of the letter (rare, address at the end) Tag <body>: body of the letter Tag <pb>: marks the start of a new folio Tag <p> : paragraph The line break corresponds to a new line of the original and is indicated by the tag <lb>.

1.3.10. Foliotation

Some pages sometimes remain blank: do not put a reference to the surface in the transcription (it is possible to go from 2R to 2V if 1V is blank, for example). Try to start the foliation with the surface containing the address. In the very rare case where a letter contains many leaves, follow a linear foliation (1R-1V-2R-2V etc.).

1.3.11. Proper nouns: toponyms, surnames and organizations

Generally speaking, personal proper nouns are not standardized. If possible, place names are normalized in the metadata part of the file (tag <teiHeader>) and not in the transcription of the letter (tag <text>).

The tag <placeName> indicates a toponym. Only tag the proper name, without a determinant.
Ex. : Le Havre = Le <placeName>Havre</placeName>.
Similarly, in case of contraction, mark only the second element.
Ex. : « le port du Havre » = le port du <placeName>Havre</placeName>.
The tag <persName> indicates a proper name. Insert the first and last name of the person and their reference in the metadata inside the tag.
Ex. : « Quatrinne de laballe » = <persName ref="Quatrine_de_Laballe">Quatrinne de laballe</persName>.
If it is a compound last name, tag the entire name.
« Mme de laballe » = Mme <persName ref="Quatrine_de_Laballe">de laballe</persName>.
The tag <orgName> indicates the name of an organization, institution (it can also be used to tag ship names).
<orgName ref="Compagnie_des_Indes_occidentales">Compagnie des Indes occidentales</orgName>
Do not tag the determinant.

2. Tag Table/

2.1. Elements

2.1.1. <TEI>

<TEI> (TEI document) contains a single TEI-conformant document, combining a single TEI header with one or more members of the model.resource class. Multiple <TEI> elements may be combined within a <TEI> (or <teiCorpus>) element. [4. Default Text Structure 15.1. Varieties of Composite Text]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
textstructure: TEI
May contain
header: teiHeader
textstructure: TEI text
transcr: facsimile
Note

This element is required. It is customary to specify the TEI namespace http://www.tei-c.org/ns/1.0 on it, for example: <TEI version="4.4.0" xml:lang="it" xmlns="http://www.tei-c.org/ns/1.0">.
Example
<TEI version="3.3.0" xmlns="http://www.tei-c.org/ns/1.0">  <teiHeader>   <fileDesc>    <titleStmt>     <title>The shortest TEI Document Imaginable</title>    </titleStmt>    <publicationStmt>     <p>First published as part of TEI P2, this is the P5          version using a namespace.</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>
Example
<TEI version="2.9.1" xmlns="http://www.tei-c.org/ns/1.0">  <teiHeader>   <fileDesc>    <titleStmt>     <title>A TEI Document containing four page images </title>    </titleStmt>    <publicationStmt>     <p>Unpublished demonstration file.</p>    </publicationStmt>    <sourceDesc>     <p>No source: this is an original work.</p>    </sourceDesc>   </fileDesc>  </teiHeader>  <facsimile>   <graphic url="page1.png"/>   <graphic url="page2.png"/>   <graphic url="page3.png"/>   <graphic url="page4.png"/>  </facsimile> </TEI>
Schematron
<sch:ns prefix="tei"  uri="http://www.tei-c.org/ns/1.0"/> <sch:ns prefix="xs"  uri="http://www.w3.org/2001/XMLSchema"/>
Schematron
<sch:ns prefix="rng"  uri="http://relaxng.org/ns/structure/1.0"/>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="teiHeader"/>
  <alternate minOccurs="1" maxOccurs="1">
   <sequence minOccurs="1" maxOccurs="1">
    <classRef key="model.resource"
     minOccurs="1" maxOccurs="unbounded"/>
    <elementRef key="TEI" minOccurs="0"
     maxOccurs="unbounded"/>
   </sequence>
   <elementRef key="TEI" minOccurs="1"
    maxOccurs="unbounded"/>
  </alternate>
 </sequence>
</content>
    ⚓
Schema Declaration 
element TEI
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( teiHeader, ( ( model.resource+, TEI* ) | TEI+ ) )
}⚓

2.1.2. <abbr>

<abbr> (abbreviation) contains an abbreviation of any sort. [3.6.5. Abbreviations and Their Expansions]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.pPart.editorial
Contained by
analysis: w
core: abbr add addrLine choice corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Note

If abbreviations are expanded silently, this practice should be documented in the <editorialDecl>, either with a <normalization> element or a <p>.
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>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element abbr
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   macro.phraseSeq
}⚓

2.1.3. <add>

<add> (rajout) contient des lettres, des mots ou des phrases rajoutés dans la lettre pour le destinateur et leur place par rapport au texte principal [3.5.3. Additions, Deletions, and Omissions]
Module core
Attributes att.dimensions (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.editLike (@instant) att.written (@hand)
status indicates 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.
Derived from att.transcriptional
Status Optional
Datatype teidata.enumerated
Legal values are:
unremarkable
[Default]
place specifies where this item is placed.
Derived from att.placement
Status Recommended
Datatype 1–∞ occurrences of teidata.enumerated separated by whitespace
Legal values are:
above
below
margin
left
right
supralinear
subralinear
interlinear
intra-text
superscript
subscript
Member of
model.pPart.transcriptional
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Note

In a diplomatic edition attempting to represent an original source, the <add> element should not be used for additions to the current TEI electronic edition made by editors or encoders. In these cases, either the <corr> or <supplied> element are recommended.

In a TEI edition of a historical text with previous editorial emendations in which such additions or reconstructions are considered part of the source text, the use of <add> may be appropriate, dependent on the editorial philosophy of the project.
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.
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element add
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.editLike.attribute.instant,
   att.written.attribute.hand,
   att.dimensions.attributes,
   attribute status { "unremarkable" }?,
   attribute place
   {
      list
      {
         (
            "above"
          | "below"
          | "margin"
          | "left"
          | "right"
          | "supralinear"
          | "subralinear"
          | "interlinear"
          | "intra-text"
          | "superscript"
          | "subscript"
         )+
      }
   }?,
   macro.paraContent
}⚓

2.1.4. <addrLine>

<addrLine> (address line) contains one line of a postal address. [3.6.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.12.2.4. Imprint, Size of a Document, and Reprint Information]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
core: address
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
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.
Example
<address>  <addrLine>Computing Center, MC 135</addrLine>  <addrLine>P.O. Box 6998</addrLine>  <addrLine>Chicago, IL</addrLine>  <addrLine>60680 USA</addrLine> </address>
Example
<addrLine>  <ref target="tel:+1-201-555-0123">(201) 555 0123</ref> </addrLine>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element addrLine
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   macro.phraseSeq
}⚓

2.1.5. <address>

<address> (address) contains a postal address, for example of a publisher, an organization, or an individual. [3.6.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.12.2.4. Imprint, Size of a Document, and Reprint Information]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.addressLike model.publicationStmtPart.detail
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p pubPlace ref resp rs sic title unclear
header: correspAction edition extent language licence publicationStmt
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
core: addrLine
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.
Example Using just the elements defined by the core module, an address could be represented as follows:
<address>  <street>via Marsala 24</street>  <postCode>40126</postCode>  <name>Bologna</name>  <name>Italy</name> </address>
Example When a schema includes the names and dates module more specific elements such as country or settlement would be preferable over generic <name>:
<address>  <street>via Marsala 24</street>  <postCode>40126</postCode>  <settlement>Bologna</settlement>  <country>Italy</country> </address>
Example
<address>  <addrLine>Computing Center, MC 135</addrLine>  <addrLine>P.O. Box 6998</addrLine>  <addrLine>Chicago, IL 60680</addrLine>  <addrLine>USA</addrLine> </address>
Example
<address>  <country key="FR"/>  <settlement type="city">Lyon</settlement>  <postCode>69002</postCode>  <district type="arrondissement">IIème</district>  <district type="quartier">Perrache</district>  <street>   <num>30</num>, Cours de Verdun</street> </address>
Content model 
<content>
 <elementRef key="addrLine" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element address
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   addrLine+
}⚓

2.1.6. <att>

<att> (attribute) contains the name of an attribute appearing within running text. [22. Documentation Elements]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
scheme (scheme) supplies an identifier for the scheme in which this name is defined.
Status Optional
Datatype teidata.enumerated
Legal values are:
TEI
[Default]
Member of
model.phrase.xml
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
XSD Name
Note

As an alternative to using the scheme attribute a namespace prefix may be used. Where both scheme and a prefix are used, the prefix takes precedence.
Example
<p>The TEI defines several <soCalled>global</soCalled> attributes; their names include <att>xml:id</att>, <att>rend</att>, <att>xml:lang</att>, <att>n</att>, <att>xml:space</att>, and <att>xml:base</att>; <att scheme="XX">type</att> is not amongst them.</p>
Content model 
<content>
 <dataRef key="teidata.name"/>
</content>
    ⚓
Schema Declaration 
element att
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute scheme { "TEI" }?,
   teidata.name
}⚓

2.1.7. <attDef>

<attDef> (attribute definition) contains the definition of a single attribute. [22.5.3. Attribute List Specification]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.identified (@ident) att.deprecated (@validUntil)
mode specifies the effect of this declaration on its parent object.
Derived from att.combinable
Status Optional
Datatype teidata.enumerated
Legal values are:
change
delete
Contained by
tagdocs: attList
May contain
core: desc
tagdocs: valList
Example
<attDef usage="rec" ident="type">  <desc>specifies a name conventionally used for this level of subdivision, e.g.  <val>act</val>, <val>volume</val>, <val>book</val>, <val>section</val>, <val>canto</val>,    etc.</desc>  <datatype>   <dataRef key="teidata.word"/>  </datatype> </attDef>
Schematron
<s:ns prefix="teix"  uri="http://www.tei-c.org/ns/Examples"/> <s:assert test="ancestor::teix:egXML[@valid='feasible'] or @mode eq 'change' or @mode eq 'delete' or tei:datatype or tei:valList[@type='closed']">Attribute: the definition of the @<s:value-of select="@ident"/> attribute in the <s:value-of select="ancestor::*[@ident][1]/@ident"/> <s:value-of select="' '"/> <s:value-of select="local-name(ancestor::*[@ident][1])"/> should have a closed valList or a datatype</s:assert>
Schematron
<sch:rule context="tei:attDef[@usage eq 'req']"> <sch:report test="tei:defaultVal">Since the @<sch:value-of select="@ident"/> attribute is required, it will always be specified. Thus the default value (of "<sch:value-of select="normalize-space(tei:defaultVal)"/>") will never be used. Either change the definition of the attribute so it is not required ("rec" or "opt"), or remove the defaultVal element.</sch:report> </sch:rule>
Schematron
<sch:rule context="tei:attDef[ tei:defaultVal and tei:valList[@type eq 'closed'] and tei:datatype[ @maxOccurs > 1 or @minOccurs > 1 or @maxOccurs = 'unbounded' ] ]"> <sch:assert test=" tokenize(normalize-space(tei:defaultVal),' ') = tei:valList/tei:valItem/@ident">In the <sch:value-of select="local-name(ancestor::*[@ident][1])"/> defining <sch:value-of select="ancestor::*[@ident][1]/@ident"/> the default value of the @<sch:value-of select="@ident"/> attribute is not among the closed list of possible values</sch:assert> </sch:rule>
Schematron
<sch:rule context="tei:attDef[ tei:defaultVal and tei:valList[@type eq 'closed'] and tei:datatype[ not(@maxOccurs) or ( if ( @maxOccurs castable as xs:integer ) then ( @maxOccurs cast as xs:integer eq 1 ) else false() )] ]"> <sch:assert test="string(tei:defaultVal) = tei:valList/tei:valItem/@ident">In the <sch:value-of select="local-name(ancestor::*[@ident][1])"/> defining <sch:value-of select="ancestor::*[@ident][1]/@ident"/> the default value of the @<sch:value-of select="@ident"/> attribute is not among the closed list of possible values</sch:assert> </sch:rule>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="datatype" minOccurs="0"/>
  <elementRef key="constraintSpec"
   minOccurs="0" maxOccurs="unbounded"/>
  <elementRef key="defaultVal"
   minOccurs="0"/>
  <alternate minOccurs="0" maxOccurs="1">
   <elementRef key="valList"/>
   <elementRef key="valDesc" minOccurs="1"
    maxOccurs="unbounded"/>
  </alternate>
  <elementRef key="exemplum" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="remarks" minOccurs="0"
   maxOccurs="unbounded"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element attDef
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.identified.attribute.ident,
   att.deprecated.attribute.validUntil,
   attribute mode { "change" | "delete" }?,
   (
      ( model.glossLike | model.descLike )*,
      datatype?,
      constraintSpec*,
      defaultVal?,
      ( valList | valDesc+ )?,
      exemplum*,
      remarks*
   )
}⚓

2.1.8. <attList>

<attList> (attribute list) contains documentation for all the attributes associated with this element, as a series of <attDef> elements. [22.5. Element Specifications 22.6. Class Specifications]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
tagdocs: attList classSpec elementSpec
May contain
tagdocs: attDef attList
Example
<attList>  <attDef ident="type" usage="opt">   <desc>type of schema</desc>   <datatype>    <dataRef key="teidata.enumerated"/>   </datatype>  </attDef> </attList>
Example
<attList org="choice">  <attDef ident="active">   <desc versionDate="2005-07-24"    xml:lang="en">identifies the <soCalled>active</soCalled> participants in a non-mutual relationship, or all the participants in a mutual      one.</desc>   <datatype maxOccurs="unbounded">    <dataRef key="teidata.pointer"/>   </datatype>  </attDef>  <attDef ident="mutual" usage="opt">   <desc versionDate="2005-07-24"    xml:lang="en">supplies a list of participants amongst all of whom the relationship holds equally.</desc>   <datatype maxOccurs="unbounded">    <dataRef key="teidata.pointer"/>   </datatype>  </attDef> </attList>
Content model 
<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <elementRef key="attRef"/>
  <elementRef key="attDef"/>
  <elementRef key="attList"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element attList
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( attRef | attDef | attList )+
}⚓

2.1.9. <availability>

<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. Publication, Distribution, Licensing, etc.]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
status (status) supplies a code identifying the current availability of the text.
Status Optional
Datatype teidata.enumerated
Legal values are:
restricted
Member of
model.publicationStmtPart.detail
Contained by
header: publicationStmt
May contain
core: p
header: licence
Note

A consistent format should be adopted
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>
Content model 
<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <classRef key="model.availabilityPart"/>
  <classRef key="model.pLike"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element availability
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   attribute status { "restricted" }?,
   ( model.availabilityPart | model.pLike )+
}⚓

2.1.10. <back>

<back> (back matter) contains any appendixes, etc. following the main part of a text. [4.7. Back Matter 4. Default Text Structure]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls)
Contained by
textstructure: text
May contain
core: cb gap lb list note p pb
namesdates: listOrg listPerson listPlace listRelation
tagdocs: schemaSpec
textstructure: div div1
Note

Because cultural conventions differ as to which elements are grouped as back matter and which as front matter, the content models for the <back> and <front> elements are identical.
Example
<back>  <div type="appendix">   <head>The Golden Dream or, the Ingenuous Confession</head>   <p>TO shew the Depravity of human Nature, and how apt the Mind is to be misled by Trinkets      and false Appearances, Mrs. Two-Shoes does acknowledge, that after she became rich, she      had like to have been, too fond of Money <!-- .... -->   </p>  </div> <!-- ... -->  <div 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>  </div>  <div 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>  </div>  <div type="advert">   <head>By the KING's Royal Patent, 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>  </div> </back>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.frontPart"/>
   <classRef key="model.pLike.front"/>
   <classRef key="model.pLike"/>
   <classRef key="model.listLike"/>
   <classRef key="model.global"/>
  </alternate>
  <alternate minOccurs="0">
   <sequence>
    <classRef key="model.div1Like"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.frontPart"/>
     <classRef key="model.div1Like"/>
     <classRef key="model.global"/>
    </alternate>
   </sequence>
   <sequence>
    <classRef key="model.divLike"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.frontPart"/>
     <classRef key="model.divLike"/>
     <classRef key="model.global"/>
    </alternate>
   </sequence>
  </alternate>
  <sequence minOccurs="0">
   <classRef key="model.divBottomPart"/>
   <alternate minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottomPart"/>
    <classRef key="model.global"/>
   </alternate>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element back
{
   att.global.attributes,
   att.declaring.attributes,
   (
      (
         model.frontPart
       | model.pLike.front
       | model.pLike
       | model.listLike
       | model.global
      )*,
      (
         (
            model.div1Like,
            ( model.frontPart | model.div1Like | model.global )*
         )
       | ( model.divLike, ( model.frontPart | model.divLike | model.global )* )
      )?,
      ( model.divBottomPart, ( model.divBottomPart | model.global )* )?
   )
}⚓

2.1.11. <body>

<body> (text body) contains the whole body of a single unitary text, excluding any front or back matter. [4. Default Text Structure]
Module textstructure
Attributes att.declaring (@decls) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
textstructure: text
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
textstructure: div div1
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>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <classRef key="model.global"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0" maxOccurs="1">
   <classRef key="model.divTop"/>
   <alternate minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"/>
    <classRef key="model.divTop"/>
   </alternate>
  </sequence>
  <sequence minOccurs="0" maxOccurs="1">
   <classRef key="model.divGenLike"/>
   <alternate minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"/>
    <classRef key="model.divGenLike"/>
   </alternate>
  </sequence>
  <alternate minOccurs="1" maxOccurs="1">
   <sequence minOccurs="1"
    maxOccurs="unbounded">
    <classRef key="model.divLike"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.global"/>
     <classRef key="model.divGenLike"/>
    </alternate>
   </sequence>
   <sequence minOccurs="1"
    maxOccurs="unbounded">
    <classRef key="model.div1Like"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.global"/>
     <classRef key="model.divGenLike"/>
    </alternate>
   </sequence>
   <sequence minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <elementRef key="schemaSpec"/>
      <classRef key="model.common"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <alternate minOccurs="0" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.divLike"/>
      <alternate minOccurs="0"
       maxOccurs="unbounded">
       <classRef key="model.global"/>
       <classRef key="model.divGenLike"/>
      </alternate>
     </sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.div1Like"/>
      <alternate minOccurs="0"
       maxOccurs="unbounded">
       <classRef key="model.global"/>
       <classRef key="model.divGenLike"/>
      </alternate>
     </sequence>
    </alternate>
   </sequence>
  </alternate>
  <sequence minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divBottom"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element body
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   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 )* )+
       | (
            ( ( schemaSpec | model.common ), model.global* )+,
            (
               ( model.divLike, ( model.global | model.divGenLike )* )+
             | ( model.div1Like, ( model.global | model.divGenLike )* )+
            )?
         )
      ),
      ( model.divBottom, model.global* )*
   )
}⚓

2.1.12. <cb>

<cb> (column beginning) marks the beginning of a new column of a text on a multi-column page. [3.11.3. Milestone Elements]
Module core
Attributes att.edition (@ed, @edRef) att.spanning (@spanTo) att.breaking (@break) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.milestoneLike
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item list name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
textstructure: back body div div1 div2 div3 div4 div5 front text
transcr: surface
May contain Empty element
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. The <cb> element is placed at the head of the column to which it refers.
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> <!-- remainder of column --> <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>
Content model 
<content>
 <empty/>
</content>
    ⚓
Schema Declaration 
element cb
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.edition.attributes,
   att.spanning.attributes,
   att.breaking.attributes,
   empty
}⚓

2.1.13. <choice>

<choice> (choice) groups a number of alternative encodings for the same point in a text. [3.5. Simple Editorial Changes]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
model.pPart.editorial
Contained by
analysis: w
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr corr expan sic unclear
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. The Apparatus Entry, Readings, and Witnesses should be preferred.
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>
Content model 
<content>
 <elementRef key="w" minOccurs="0"/>
 <elementRef key="sic" minOccurs="0"/>
 <elementRef key="corr" minOccurs="0"/>
 <elementRef key="abbr" minOccurs="0"/>
 <elementRef key="expan" minOccurs="0"/>
 <elementRef key="unclear" minOccurs="0"/>
 <elementRef key="reg" minOccurs="0"/>
 <elementRef key="orig" minOccurs="0"/>
</content>
    ⚓
Schema Declaration 
element choice
{
   att.global.attributes,
   w?,
   sic?,
   corr?,
   abbr?,
   expan?,
   unclear?,
   reg?,
   orig?
}⚓

2.1.14. <classRef>

<classRef> points to the specification for an attribute or model class which is to be included in a schema [22.6. Class Specifications]
Module tagdocs
Attributes att.repeatable (@minOccurs, @maxOccurs) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
include
Status Optional
except
Status Optional
key the identifier used for the required class within the source indicated.
Status Required
Datatype teidata.xmlName
Member of
model.oddRef
Contained by
tagdocs: schemaSpec
May contain Empty element
Note

Attribute and model classes are identified by the name supplied as value for the ident attribute on the <classSpec> element in which they are declared. All TEI class names are unique; attribute class names conventionally begin with the letters att..
Example
<schemaSpec ident="myTEIe" start="TEI">  <moduleRef key="tei"/>  <moduleRef key="core"   include="abbr add core addrLine address author bibl biblScope choice cit corr date del desc divGen editor emph expan foreign gap gloss graphic head hi index item l label lb lg list listBibl mentioned milestone name note num orig p pb ptr pubPlace publisher q ref reg relatedItem resp respStmt rs sic soCalled sp speaker stage teiCorpus term time title unclear"/>  <moduleRef key="header"   include="authority availability catRef category change classCode classDecl creation distributor edition editionStmt editorialDecl encodingDesc extent fileDesc funder idno keywords langUsage language licence notesStmt principal profileDesc projectDesc publicationStmt refsDecl revisionDesc samplingDecl seriesStmt sourceDesc sponsor taxonomy teiHeader textClass titleStmt"/>  <moduleRef key="textstructure"   include="TEI argument back body byline closer dateline div docAuthor docDate docEdition docImprint docTitle epigraph front group opener postscript salute signed text titlePage titlePart trailer"/>  <classRef key="att.global.facs"/> </schemaSpec>
Content model 
<content>
 <empty/>
</content>
    ⚓
Schema Declaration 
element classRef
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.repeatable.attributes,
   ( attribute include { text }? | attribute except { text }? ),
   attribute key { text },
   empty
}⚓

2.1.15. <classSpec>

<classSpec> (class specification) contains reference information for a TEI element class; that is a group of elements which appear together in content models, or which share some common attribute, or both. [22.3. Specification Elements 22.6. Class Specifications]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.identified (@ident) att.deprecated (@validUntil)
mode specifies the effect of this declaration on its parent object.
Derived from att.combinable
Status Optional
Datatype teidata.enumerated
Legal values are:
change
type indicates whether this is a model class or an attribute class
Derived from att.typed
Status Required
Datatype teidata.enumerated
Legal values are:
atts
Member of
model.oddDecl
Contained by
core: add corr del desc hi item note p ref sic title unclear
header: licence
namesdates: occupation
tagdocs: schemaSpec
textstructure: body div div1 div2 div3 div4 div5
May contain
core: desc
tagdocs: attList
Example
<classSpec module="tei" type="model"  ident="model.segLike">  <desc>groups elements used for arbitrary segmentation.</desc>  <classes>   <memberOf key="model.phrase"/>  </classes>  <remarks>   <p>The principles on which segmentation is carried out, and      any special codes or attribute values used, should be defined explicitly      in the <gi>segmentation</gi> element of the <gi>encodingDesc</gi> within      the associated TEI header.</p>  </remarks> </classSpec>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="classes" minOccurs="0"/>
  <elementRef key="constraintSpec"
   minOccurs="0" maxOccurs="unbounded"/>
  <elementRef key="attList" minOccurs="0"/>
  <elementRef key="exemplum" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="remarks" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="listRef" minOccurs="0"
   maxOccurs="unbounded"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element classSpec
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.identified.attribute.ident,
   att.deprecated.attribute.validUntil,
   attribute mode { "change" }?,
   attribute type { "atts" },
   (
      ( model.glossLike | model.descLike )*,
      classes?,
      constraintSpec*,
      attList?,
      exemplum*,
      remarks*,
      listRef*
   )
}⚓

2.1.16. <corr>

<corr> (correction) contains the correct form of a passage apparently erroneous in the copy text. [3.5.1. Apparent Errors]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@instant) att.typed (@type)
Member of
model.pPart.transcriptional
Contained by
analysis: w
core: abbr add addrLine choice corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Example If all that is desired is to call attention to the fact that the copy text has been corrected, <corr> may be used alone:
I don't know, Juan. It's so far in the past now — how <corr>can we</corr> prove or disprove anyone's theories?
Example It is also possible, using the <choice> and <sic> elements, to provide an uncorrected reading:
I don't know, Juan. It's so far in the past now — how <choice>  <sic>we can</sic>  <corr>can we</corr> </choice> prove or disprove anyone's theories?
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element corr
{
   att.global.attributes,
   att.editLike.attributes,
   att.typed.attributes,
   macro.paraContent
}⚓

2.1.17. <correspAction>

<correspAction> (correspondence action) contains a structured description of the place, the name of a person/organization and the date related to the sending/receiving of a message or any other action related to the correspondence. [2.4.6. Correspondence Description]
Module header
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
type describes the nature of the action.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
received
sent
intermediate
Contained by
header: correspDesc
May contain
core: address date name note p rs
header: idno
namesdates: country forename orgName persName placeName settlement surname
Example
<correspAction type="sent">  <persName>Adelbert von Chamisso</persName>  <settlement>Vertus</settlement>  <date when="1807-01-29"/> </correspAction>
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.correspActionPart"
   minOccurs="1" maxOccurs="unbounded"/>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element correspAction
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   attribute type { "received" | "sent" | "intermediate" }?,
   ( model.correspActionPart+ | model.pLike+ )
}⚓

2.1.18. <correspDesc>

<correspDesc> (correspondence description) contains a description of the actions related to one act of correspondence. [2.4.6. Correspondence Description]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.profileDescPart
Contained by
header: profileDesc
May contain
header: correspAction
Example
<correspDesc>  <correspAction type="sent">   <persName>Carl Maria von Weber</persName>   <settlement>Dresden</settlement>   <date when="1817-06-23">23 June 1817</date>  </correspAction>  <correspAction type="received">   <persName>Caroline Brandt</persName>   <settlement>Prag</settlement>  </correspAction>  <correspContext>   <ref type="prev"    target="http://www.weber-gesamtausgabe.de/A041209">Previous letter of   <persName>Carl Maria von Weber</persName>      to <persName>Caroline Brandt</persName>:   <date from="1817-06-19" to="1817-06-20">June 19/20, 1817</date>   </ref>   <ref type="next"    target="http://www.weber-gesamtausgabe.de/A041217">Next letter of   <persName>Carl Maria von Weber</persName> to   <persName>Caroline Brandt</persName>:   <date when="1817-06-27">June 27, 1817</date>   </ref>  </correspContext> </correspDesc>
Content model 
<content>
 <elementRef key="correspAction"
  minOccurs="2" maxOccurs="3"/>
</content>
    ⚓
Schema Declaration 
element correspDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   ( correspAction, correspAction, correspAction? )
}⚓

2.1.19. <country>

<country> (country) contains the name of a geo-political unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc. [13.2.3. Place Names]
Module namesdates
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
Member of
model.placeNamePart
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: msIdentifier repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Note

The recommended source for codes to represent coded country names is ISO 3166.
Example
<country key="DK">Denmark</country>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element country
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   macro.phraseSeq
}⚓

2.1.20. <date>

<date> (date) contains a date in any format. [3.6.4. Dates and Times 2.2.4. Publication, Distribution, Licensing, etc. 2.6. The Revision Description 3.12.2.4. Imprint, Size of a Document, and Reprint Information 15.2.3. The Setting Description 13.4. Dates]
Module core
Attributes att.editLike (@instant) att.dimensions (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
when
Status Optional
Datatype teidata.temporal.w3c
when
Status Optional
Datatype teidata.temporal.w3c
year
Status Optional
Datatype teidata.numeric
Member of
model.dateLike model.publicationStmtPart.detail
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence publicationStmt
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
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>
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.phrase"/>
  <classRef key="model.global"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element date
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   att.editLike.attributes,
   att.dimensions.attributes,
   attribute when { text }?,
   attribute when { text }?,
   attribute year { text }?,
   ( text | model.gLike | model.phrase | model.global )*
}⚓

2.1.21. <del>

<del> (Suppression) contient une lettre, un mot ou un passage supprimé, raturé dans le texte de la lettre [3.5.3. Additions, Deletions, and Omissions]
Module core
Attributes att.dimensions (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.editLike (@instant) att.written (@hand)
rend (rendition) indicates how the element in question was rendered or presented in the source text.
Derived from att.global.rendition
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
Sample values include:
overstrike
status indicates 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.
Derived from att.transcriptional
Status Optional
Datatype teidata.enumerated
Legal values are:
unremarkable
[Default]
Member of
model.pPart.transcriptional
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Note

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.

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. Certainty, Precision, and Responsibility).

There is a clear distinction in the TEI between <del> and <surplus> on the one hand and <gap> or <unclear> on the other. <del> indicates a deletion present in the source being transcribed, which states the author's or a later scribe's intent to cancel or remove text. <surplus> indicates material present in the source being transcribed which should have been so deleted, but which is not in fact. <gap> or <unclear>, by contrast, signal an editor's or encoder's decision to omit something or their inability to read the source text. See sections 11.3.1.7. Text Omitted from or Supplied in the Transcription and 11.3.3.2. Use of the gap, del, damage, unclear, and supplied Elements in Combination for the relationship between these and other related elements used in detailed transcription.
Example
<l>  <del rend="overtyped">Mein</del> Frisch <del rend="overstrike" type="primary">schwebt</del> weht der Wind </l>
Example
<del rend="overstrike">  <gap reason="illegible" quantity="5"   unit="character"/> </del>
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element del
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.editLike.attribute.instant,
   att.written.attribute.hand,
   att.dimensions.attributes,
   attribute rend { list { + } }?,
   attribute status { "unremarkable" }?,
   macro.paraContent
}⚓

2.1.22. <desc>

<desc> (description) contains a short description of the purpose, function, or use of its parent element, or when the parent is a documentation element, describes or defines the object being documented. [22.4.1. Description of Components]
Module core
Attributes att.translatable (@versionDate) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.descLike model.labelLike
Contained by
core: add corr del desc gap graphic hi item list note p ref sic title unclear
header: licence
namesdates: occupation org relation
tagdocs: attDef classSpec elementSpec schemaSpec valItem
textstructure: body div div1 div2 div3 div4 div5
transcr: surface
May contain
core: abbr address choice date desc expan hi list name ref rs title
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Note

When used in a specification element such as <elementSpec>, TEI convention requires that this be expressed as a finite clause, begining with an active verb.
Example Example of a <desc> element inside a documentation element.
<dataSpec module="tei"  ident="teidata.point">  <desc versionDate="2010-10-17"   xml:lang="en">defines the data type used to express a point in cartesian space.</desc>  <content>   <dataRef name="token"    restriction="(-?[0-9]+(\.[0-9]+)?,-?[0-9]+(\.[0-9]+)?)"/>  </content> <!-- ... --> </dataSpec>
Example Example of a <desc> element in a non-documentation element.
<place xml:id="KERG2">  <placeName>Kerguelen Islands</placeName> <!-- ... -->  <terrain>   <desc>antarctic tundra</desc>  </terrain> <!-- ... --> </place>
Schematron A <desc> with a type of deprecationInfo should only occur when its parent element is being deprecated. Furthermore, it should always occur in an element that is being deprecated when <desc> is a valid child of that element.
<sch:rule context="tei:desc[ @type eq 'deprecationInfo']"> <sch:assert test="../@validUntil">Information about a deprecation should only be present in a specification element that is being deprecated: that is, only an element that has a @validUntil attribute should have a child <desc type="deprecationInfo">.</sch:assert> </sch:rule>
Content model 
<content>
 <macroRef key="macro.limitedContent"/>
</content>
    ⚓
Schema Declaration 
element desc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.translatable.attributes,
   macro.limitedContent
}⚓

2.1.23. <div>

<div> (text division) contains a subdivision of the front, body, or back of a text. [4.1. Divisions of the Body]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (att.fragmentable (@part)) att.typed (@type) att.declaring (@decls) att.written (@hand)
Member of
model.divLike
Contained by
textstructure: back body div front
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
textstructure: div
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>
Schematron
<sch:report test="(ancestor::tei:l or ancestor::tei:lg) and not(ancestor::tei:floatingText)"> Abstract model violation: Lines may not contain higher-level structural elements such as div, unless div is a descendant of floatingText. </sch:report>
Schematron
<sch:report test="(ancestor::tei:p or ancestor::tei:ab) and not(ancestor::tei:floatingText)"> Abstract model violation: p and ab may not contain higher-level structural elements such as div, unless div is a descendant of floatingText. </sch:report>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0">
   <alternate>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate>
      <classRef key="model.divLike"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <elementRef key="schemaSpec"/>
       <classRef key="model.common"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate>
       <classRef key="model.divLike"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element div
{
   att.global.attributes,
   att.divLike.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   att.written.attributes,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( model.divLike | model.divGenLike ), model.global* )+
          | (
               ( ( schemaSpec | model.common ), model.global* )+,
               ( ( model.divLike | model.divGenLike ), model.global* )*
            )
         ),
         ( model.divBottom, model.global* )*
      )?
   )
}⚓

2.1.24. <div1>

<div1> (level-1 text division) contains a first-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (att.fragmentable (@part)) att.typed (@type) att.declaring (@decls)
Member of
model.div1Like
Contained by
textstructure: back body front
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
textstructure: div2
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.
Example
<div1 xml:id="levi" n="I" type="part">  <head>Part I: Of Man </head>  <div2 xml:id="levi1" n="1" type="chapter">   <head>Chap. I. Of Sense </head>   <p>Concerning the Thoughts of man... </p>  </div2> </div1> <div1 xml:id="levii" n="II" type="part">  <head>Part II: Of Common-Wealth</head> </div1>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0">
   <alternate>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate>
      <classRef key="model.div2Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <elementRef key="schemaSpec"/>
       <classRef key="model.common"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate>
       <classRef key="model.div2Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element div1
{
   att.global.attributes,
   att.divLike.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( model.div2Like | model.divGenLike ), model.global* )+
          | (
               ( ( schemaSpec | model.common ), model.global* )+,
               ( ( model.div2Like | model.divGenLike ), model.global* )*
            )
         ),
         ( model.divBottom, model.global* )*
      )?
   )
}⚓

2.1.25. <div2>

<div2> (level-2 text division) contains a second-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (att.fragmentable (@part)) att.typed (@type) att.declaring (@decls)
Member of
model.div2Like
Contained by
textstructure: div1
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
textstructure: div3
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.
Example
<div1 n="2" type="part">  <head>The Second Partition:    The Cure of Melancholy</head>  <div2 n="2.1" type="section">   <div3 n="2.1.1" type="member">    <div4 n="2.1.1.1" type="subsection">     <head>Unlawful Cures rejected.</head>     <p>Inveterate melancholy, howsoever it may seem to          be a continuate, inexorable disease, hard to be          cured, accompanying them to their graves most part          (as <ref target="#a">Montanus</ref> observes), yet many          times it may be helped...     </p>    </div4>   </div3>  </div2>  <div2 n="2.2" type="section">   <div3 n="2.2.1" type="member">    <head>Sect. II. Memb. I</head>    <p/>   </div3>  </div2>  <div2 n="2.3" type="section">   <div3 n="2.3.1" type="member">    <head>Sect. III. Memb. I</head>    <p/>   </div3>  </div2> </div1>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0">
   <alternate>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate>
      <classRef key="model.div3Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <elementRef key="schemaSpec"/>
       <classRef key="model.common"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate>
       <classRef key="model.div3Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element div2
{
   att.global.attributes,
   att.divLike.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( model.div3Like | model.divGenLike ), model.global* )+
          | (
               ( ( schemaSpec | model.common ), model.global* )+,
               ( ( model.div3Like | model.divGenLike ), model.global* )*
            )
         ),
         ( model.divBottom, model.global* )*
      )?
   )
}⚓

2.1.26. <div3>

<div3> (level-3 text division) contains a third-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (att.fragmentable (@part)) att.typed (@type) att.declaring (@decls)
Member of
model.div3Like
Contained by
textstructure: div2
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
textstructure: div4
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.
Example
<div2 n="2.2" type="section">  <div3 n="2.2.1" type="member">   <head>Sect. II. Memb. I</head>   <p/>  </div3>  <div3 n="2.2.2" type="member">   <head>Memb. II Retention and Evacuation rectified.</head>   <p/>  </div3>  <div3 n="2.2.3" type="member">   <head>Memb. III Ayr rectified. With a digression of the Ayr.</head>   <p/>  </div3> </div2>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0">
   <alternate>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate>
      <classRef key="model.div4Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <elementRef key="schemaSpec"/>
       <classRef key="model.common"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate>
       <classRef key="model.div4Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element div3
{
   att.global.attributes,
   att.divLike.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( model.div4Like | model.divGenLike ), model.global* )+
          | (
               ( ( schemaSpec | model.common ), model.global* )+,
               ( ( model.div4Like | model.divGenLike ), model.global* )*
            )
         ),
         ( model.divBottom, model.global* )*
      )?
   )
}⚓

2.1.27. <div4>

<div4> (level-4 text division) contains a fourth-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (att.fragmentable (@part)) att.typed (@type) att.declaring (@decls)
Member of
model.div4Like
Contained by
textstructure: div3
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
textstructure: div5
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.
Example
<div3 n="2.2.1" type="member">  <head>Sect. II. Memb. I</head>  <div4 n="2.2.1.1" type="subsection">   <head>Subsect I. — Dyet rectified in substance.</head>   <p>Diet, <term xml:lang="grc">diaitotiku</term>, <term xml:lang="la">victus</term> or      living </p>  </div4>  <div4 n="2.2.2.1" type="subsection">   <head>Subsect II. — Dyet rectified in quantity.</head>   <p>Man alone, saith Cardan, eates and drinks without appetite, and useth all his pleasures      without necessity </p>  </div4> </div3>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0">
   <alternate>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate>
      <classRef key="model.div5Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <elementRef key="schemaSpec"/>
       <classRef key="model.common"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate>
       <classRef key="model.div5Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element div4
{
   att.global.attributes,
   att.divLike.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( model.div5Like | model.divGenLike ), model.global* )+
          | (
               ( ( schemaSpec | model.common ), model.global* )+,
               ( ( model.div5Like | model.divGenLike ), model.global* )*
            )
         ),
         ( model.divBottom, model.global* )*
      )?
   )
}⚓

2.1.28. <div5>

<div5> (level-5 text division) contains a fifth-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Module textstructure
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (att.fragmentable (@part)) att.typed (@type) att.declaring (@decls)
Member of
model.div5Like
Contained by
textstructure: div4
May contain
core: cb desc gap lb list note p pb
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
tagdocs: classSpec elementSpec schemaSpec
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.
Example
<div2 type="chapter">  <head>Recipes</head>  <head>Chapter VI.</head>  <div3>   <head>Fruit and vegetable soups</head>   <p>...</p>   <div4>    <head>Stocks for all kinds of soups</head>    <div5 type="recipe">     <head>Rich strong stock</head> <!-- ... -->    </div5>    <div5 type="recipe">     <head>Medium Stock</head> <!-- ... -->    </div5>   </div4>   <div4 type="recipe">    <head>Apple soup</head>    <div5>     <head>Ingredients</head>     <list>      <item>2 lbs. of good boiling apples,</item>      <item>3/4 teaspoonful of white pepper,</item>      <item>6 cloves,</item>      <item>cayenne or ginger to taste,</item>      <item>3 quarts of medium stock</item>     </list>    </div5>    <div5>     <head>Mode</head>     <p>Peel and quarter the apples taking out their cores; put them into          the stock, stew them gently till tender, Rub the whole through a          strainer, add the seasoning. give it one boil up, and serve.</p>    </div5>    <div5>     <head>Time</head>     <p>1 hour.</p>    </div5>    <div5>     <head>Average cost</head>     <p>per quart, 1s.</p>    </div5>    <div5>     <head>Seasonable</head>     <p>from September to December.</p>    </div5>    <div5>     <head>Sufficient</head>     <p> for 10 persons</p>    </div5>    <div5>     <head>The apple</head>     <p>This useful fruit is mentioned in Holy Writ; and Homer describes it          as valuable in his time... As a food, the apple cannot be considered          to rank high, as more than the half of it consists of water, and          the rest of its properties are not the most nourishing. It is          however a useful adjunct to other kinds of food, and, when cooked, is          esteemed as slightly laxative.</p>    </div5>   </div4>   <div4 type="recipe">    <head>Artichoke (Jerusalem) soup</head>    <p>...</p>   </div4> <!-- other recipes here -->  </div3> </div2>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0">
   <alternate>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate>
      <classRef key="model.div6Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence>
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <elementRef key="schemaSpec"/>
       <classRef key="model.common"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate>
       <classRef key="model.div6Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element div5
{
   att.global.attributes,
   att.divLike.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( model.div6Like | model.divGenLike ), model.global* )+
          | (
               ( ( schemaSpec | model.common ), model.global* )+,
               ( ( model.div6Like | model.divGenLike ), model.global* )*
            )
         ),
         ( model.divBottom, model.global* )*
      )?
   )
}⚓

2.1.29. <edition>

<edition> (edition) describes the particularities of one edition of a text. [2.2.2. The Edition Statement]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
header: editionStmt
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<edition>First edition <date>Oct 1990</date> </edition> <edition n="S2">Students' edition</edition>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element edition
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   macro.phraseSeq
}⚓

2.1.30. <editionStmt>

<editionStmt> (edition statement) groups information relating to one edition of a text. [2.2.2. The Edition Statement 2.2. The File Description]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
header: fileDesc
May contain
core: p respStmt
header: edition
Example
<editionStmt>  <edition n="S2">Students' edition</edition>  <respStmt>   <resp>Adapted by </resp>   <name>Elizabeth Kirk</name>  </respStmt> </editionStmt>
Example
<editionStmt>  <p>First edition, <date>Michaelmas Term, 1991.</date>  </p> </editionStmt>
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <sequence minOccurs="1" maxOccurs="1">
   <elementRef key="edition"/>
   <classRef key="model.respLike"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </alternate>
</content>
    ⚓
Schema Declaration 
element editionStmt
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( model.pLike+ | ( edition, model.respLike* ) )
}⚓

2.1.31. <editorialDecl>

<editorialDecl> (editorial practice declaration) provides details of editorial principles and practices applied during the encoding of a text. [2.3.3. The Editorial Practices Declaration 2.3. The Encoding Description 15.3.2. Declarable Elements]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.encodingDescPart
Contained by
header: encodingDesc
May contain
core: p
header: segmentation
Example
<editorialDecl>  <normalization>   <p>All words converted to Modern American spelling using      Websters 9th Collegiate dictionary   </p>  </normalization>  <quotation marks="all">   <p>All opening quotation marks converted to “ all closing      quotation marks converted to &amp;cdq;.</p>  </quotation> </editorialDecl>
Content model 
<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <classRef key="model.pLike"/>
  <classRef key="model.editorialDeclPart"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element editorialDecl
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   ( model.pLike | model.editorialDeclPart )+
}⚓

2.1.32. <elementSpec>

<elementSpec> (element specification) documents the structure, content, and purpose of a single element type. [22.5. Element Specifications 22. Documentation Elements]
Module tagdocs
Attributes att.namespaceable (@ns) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.identified (@ident) att.deprecated (@validUntil)
mode specifies the effect of this declaration on its parent object.
Derived from att.combinable
Status Optional
Datatype teidata.enumerated
Legal values are:
add
[Default]
change
Member of
model.oddDecl
Contained by
core: add corr del desc hi item note p ref sic title unclear
header: licence
namesdates: occupation
tagdocs: schemaSpec
textstructure: body div div1 div2 div3 div4 div5
May contain
core: desc
tagdocs: attList valList
Example
<elementSpec module="tagdocs" ident="code">  <gloss/>  <desc>contains literal code</desc>  <classes>   <memberOf key="model.emphLike"/>  </classes>  <content>   <textNode/>  </content>  <attList>   <attDef ident="type" usage="opt">    <desc>the language of the code</desc>    <datatype>     <dataRef key="teidata.enumerated"/>    </datatype>   </attDef>  </attList> </elementSpec>
Schematron
<sch:rule context="tei:elementSpec[ @mode eq 'delete' ]"> <sch:report test="child::*">This elementSpec element has a mode= of "delete" even though it has child elements. Change the mode= to "add", "change", or "replace", or remove the child elements.</sch:report> </sch:rule> <sch:rule context="tei:elementSpec[ @mode = ('add','change','replace') ]"> <sch:assert test="child::* | (@* except (@mode, @ident))">This elementSpec element has a mode= of "<sch:value-of select="@mode"/>", but does not have any child elements or schema-changing attributes. Specify child elements, use validUntil=, predeclare=, ns=, or prefix=, or change the mode= to "delete".</sch:assert> </sch:rule>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="classes" minOccurs="0"/>
  <elementRef key="content" minOccurs="0"/>
  <elementRef key="valList" minOccurs="0"/>
  <elementRef key="constraintSpec"
   minOccurs="0" maxOccurs="unbounded"/>
  <elementRef key="attList" minOccurs="0"/>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <elementRef key="model"/>
   <elementRef key="modelGrp"/>
   <elementRef key="modelSequence"/>
  </alternate>
  <elementRef key="exemplum" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="remarks" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="listRef" minOccurs="0"
   maxOccurs="unbounded"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element elementSpec
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.identified.attribute.ident,
   att.deprecated.attribute.validUntil,
   att.namespaceable.attributes,
   attribute mode { "add" | "change" }?,
   (
      ( model.glossLike | model.descLike )*,
      classes?,
      content?,
      valList?,
      constraintSpec*,
      attList?,
      ( model | modelGrp | modelSequence )*,
      exemplum*,
      remarks*,
      listRef*
   )
}⚓

2.1.33. <encodingDesc>

<encodingDesc> (encoding description) documents the relationship between an electronic text and the source or sources from which it was derived. [2.3. The Encoding Description 2.1.1. The TEI Header and Its Components]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.teiHeaderPart
Contained by
header: teiHeader
May contain
core: p
header: editorialDecl projectDesc
tagdocs: schemaSpec
Example
<encodingDesc>  <p>Basic encoding, capturing lexical information only. All    hyphenation, punctuation, and variant spellings normalized. No    formatting or layout information preserved.</p> </encodingDesc>
Content model 
<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <classRef key="model.encodingDescPart"/>
  <classRef key="model.pLike"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element encodingDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( model.encodingDescPart | model.pLike )+
}⚓

2.1.34. <expan>

<expan> (expansion) contains the expansion of an abbreviation. [3.6.5. Abbreviations and Their Expansions]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@instant)
Member of
model.pPart.editorial
Contained by
analysis: w
core: abbr add addrLine choice corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Note

The content of this element should be the expanded abbreviation, usually (but not always) 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.

If abbreviations are expanded silently, this practice should be documented in the <editorialDecl>, either with a <normalization> element or a <p>.
Example
The address is Southmoor <choice>  <expan>Road</expan>  <abbr>Rd</abbr> </choice>
Example
<choice xml:lang="la">  <abbr>Imp</abbr>  <expan>Imp<ex>erator</ex>  </expan> </choice>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element expan
{
   att.global.attributes,
   att.editLike.attributes,
   macro.phraseSeq
}⚓

2.1.35. <extent>

<extent> (extent) describes the approximate size of a text stored on some carrier medium or of some other object, digital or non-digital, specified in any convenient units. [2.2.3. Type and Extent of File 2.2. The File Description 3.12.2.4. Imprint, Size of a Document, and Reprint Information 10.7.1. Object Description]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
header: fileDesc
msdescription: supportDesc
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<extent>3200 sentences</extent> <extent>between 10 and 20 Mb</extent> <extent>ten 3.5 inch high density diskettes</extent>
Example The <measure> element may be used to supply normalised or machine tractable versions of the size or sizes concerned.
<extent>  <measure unit="MiB" quantity="4.2">About four megabytes</measure>  <measure unit="pages" quantity="245">245 pages of source    material</measure> </extent>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element extent
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   macro.phraseSeq
}⚓

2.1.36. <facsimile>

<facsimile> contains a representation of some written source in the form of a set of images rather than as transcribed or encoded text. [11.1. Digital Facsimiles]
Module transcr
Attributes att.declaring (@decls) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.resource
Contained by
textstructure: TEI
May contain
transcr: surfaceGrp
Example
<facsimile>  <graphic url="page1.png"/>  <surface>   <graphic url="page2-highRes.png"/>   <graphic url="page2-lowRes.png"/>  </surface>  <graphic url="page3.png"/>  <graphic url="page4.png"/> </facsimile>
Example
<facsimile>  <surface ulx="0" uly="0" lrx="200" lry="300">   <graphic url="Bovelles-49r.png"/>  </surface> </facsimile>
Content model 
<content>
 <elementRef key="surfaceGrp"/>
</content>
    ⚓
Schema Declaration 
element facsimile
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.declaring.attributes,
   surfaceGrp
}⚓

2.1.37. <fileDesc>

<fileDesc> (file description) contains a full bibliographic description of an electronic file. [2.2. The File Description 2.1.1. The TEI Header and Its Components]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
header: teiHeader
May contain
header: editionStmt extent publicationStmt sourceDesc titleStmt
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.
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>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <sequence minOccurs="1" maxOccurs="1">
   <elementRef key="titleStmt"/>
   <elementRef key="editionStmt"
    minOccurs="0"/>
   <elementRef key="extent" minOccurs="0"/>
   <elementRef key="publicationStmt"/>
   <elementRef key="seriesStmt"
    minOccurs="0" maxOccurs="unbounded"/>
   <elementRef key="notesStmt"
    minOccurs="0"/>
  </sequence>
  <elementRef key="sourceDesc"
   minOccurs="1" maxOccurs="unbounded"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element fileDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   (
      (
         titleStmt,
         editionStmt?,
         extent?,
         publicationStmt,
         seriesStmt*,
         notesStmt?
      ),
      sourceDesc+
   )
}⚓

2.1.38. <forename>

<forename> (Prénom d'une personne) permet de relever le prénom d'une personne. [13.2.1. Personal Names]
Module namesdates
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
full indicates whether the name component is given in full, as an abbreviation or simply as an initial.
Derived from att.personal
Status Optional
Datatype teidata.enumerated
Legal values are:
yes
[Default]
ref (reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.
Derived from att.canonical
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Member of
model.persNamePart
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<persName>  <roleName>Ex-President</roleName>  <forename>George</forename>  <surname>Bush</surname> </persName>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element forename
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute full { "yes" }?,
   attribute ref { list { + } }?,
   macro.phraseSeq
}⚓

2.1.39. <front>

<front> (front matter) contains any prefatory matter (headers, abstracts, title page, prefaces, dedications, etc.) found at the start of a document, before the main body. [4.6. Title Pages 4. Default Text Structure]
Module textstructure
Attributes att.declaring (@decls) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
textstructure: text
May contain
core: cb gap lb note p pb
tagdocs: schemaSpec
textstructure: div div1
Note

Because cultural conventions differ as to which elements are grouped as front matter and which as back matter, the content models for the <front> and <back> elements are identical.
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">Σίβυλλα τί        θέλεις</q>; respondebat illa: <q xml:lang="grc">ὰποθανεῖν θέλω.</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>
Example
<front>  <div type="abstract">   <div>    <head> BACKGROUND:</head>    <p>Food insecurity can put children at greater risk of obesity because        of altered food choices and nonuniform consumption patterns.</p>   </div>   <div>    <head> OBJECTIVE:</head>    <p>We examined the association between obesity and both child-level        food insecurity and personal food insecurity in US children.</p>   </div>   <div>    <head> DESIGN:</head>    <p>Data from 9,701 participants in the National Health and Nutrition        Examination Survey, 2001-2010, aged 2 to 11 years were analyzed.        Child-level food insecurity was assessed with the US Department of        Agriculture's Food Security Survey Module based on eight        child-specific questions. Personal food insecurity was assessed with        five additional questions. Obesity was defined, using physical        measurements, as body mass index (calculated as kg/m2) greater than        or equal to the age- and sex-specific 95th percentile of the Centers        for Disease Control and Prevention growth charts. Logistic        regressions adjusted for sex, race/ethnic group, poverty level, and        survey year were conducted to describe associations between obesity        and food insecurity.</p>   </div>   <div>    <head> RESULTS:</head>    <p>Obesity was significantly associated with personal food insecurity        for children aged 6 to 11 years (odds ratio=1.81; 95% CI 1.33 to        2.48), but not in children aged 2 to 5 years (odds ratio=0.88; 95%        CI 0.51 to 1.51). Child-level food insecurity was not associated        with obesity among 2- to 5-year-olds or 6- to 11-year-olds.</p>   </div>   <div>    <head> CONCLUSIONS:</head>    <p>Personal food insecurity is associated with an increased risk of        obesity only in children aged 6 to 11 years. Personal        food-insecurity measures may give different results than aggregate        food-insecurity measures in children.</p>   </div>  </div> </front>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.frontPart"/>
   <classRef key="model.pLike"/>
   <classRef key="model.pLike.front"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1" maxOccurs="1">
     <classRef key="model.div1Like"/>
     <alternate minOccurs="0"
      maxOccurs="unbounded">
      <classRef key="model.div1Like"/>
      <classRef key="model.frontPart"/>
      <classRef key="model.global"/>
     </alternate>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <classRef key="model.divLike"/>
     <alternate minOccurs="0"
      maxOccurs="unbounded">
      <classRef key="model.divLike"/>
      <classRef key="model.frontPart"/>
      <classRef key="model.global"/>
     </alternate>
    </sequence>
   </alternate>
   <sequence minOccurs="0" maxOccurs="1">
    <classRef key="model.divBottom"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.divBottom"/>
     <classRef key="model.global"/>
    </alternate>
   </sequence>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element front
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.declaring.attributes,
   (
      ( model.frontPart | model.pLike | model.pLike.front | model.global )*,
      (
         (
            (
               model.div1Like,
               ( model.div1Like | model.frontPart | model.global )*
            )
          | (
               model.divLike,
               ( model.divLike | model.frontPart | model.global )*
            )
         ),
         ( model.divBottom, ( model.divBottom | model.global )* )?
      )?
   )
}⚓

2.1.40. <gap>

<gap> (gap) indicates a point where material has been omitted in a transcription, whether for editorial reasons described in the TEI header, as part of sampling practice, or because the material is illegible, invisible, or inaudible. [3.5.3. Additions, Deletions, and Omissions]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.timedatt.editLike (@instant) att.dimensions (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
reason (reason) gives the reason for omission
Status Optional
Datatype 1–∞ occurrences of teidata.enumerated separated by whitespace
Suggested values include:
cancelled
(cancelled)
deleted
(deleted)
editorial
(editorial) for features omitted from transcription due to editorial policy
illegible
(illegible)
inaudible
(inaudible)
irrelevant
(irrelevant)
sampling
(sampling)
agent (agent) in the case of text omitted because of damage, categorizes the cause of the damage, if it can be identified.
Status Optional
Datatype teidata.enumerated
Sample values include:
rubbing
(rubbing) damage results from rubbing of the leaf edges
mildew
(mildew) damage results from mildew on the leaf surface
smoke
(smoke) damage results from smoke
Member of
model.global.edit
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item list name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
textstructure: back body div div1 div2 div3 div4 div5 front text
transcr: surface
May contain
core: desc
Note

The <gap>, <unclear>, and <del> core tag elements may be closely allied in use with the <damage> and <supplied> elements, available when using the additional tagset for transcription of primary sources. See section 11.3.3.2. Use of the gap, del, damage, unclear, and supplied Elements in Combination for discussion of which element is appropriate for which circumstance.

The <gap> tag simply signals the editors decision to omit or inability to transcribe a span of text. Other information, such as the interpretation that text was deliberately erased or covered, should be indicated using the relevant tags, such as <del> in the case of deliberate deletion.
Example
<gap quantity="4" unit="chars"  reason="illegible"/>
Example
<gap quantity="1" unit="essay"  reason="sampling"/>
Example
<del>  <gap atLeast="4" atMost="8" unit="chars"   reason="illegible"/> </del>
Example
<gap extent="several lines" reason="lost"/>
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element gap
{
   att.global.attributes,
   att.timed.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   attribute reason
   {
      list
      {
         (
            "cancelled"
          | "deleted"
          | "editorial"
          | "illegible"
          | "inaudible"
          | "irrelevant"
          | "sampling"
         )+
      }
   }?,
   attribute agent { text }?,
   ( model.descLike | model.certLike )*
}⚓

2.1.41. <gi>

<gi> (element name) contains the name (generic identifier) of an element. [22. Documentation Elements 22.5. Element Specifications]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
scheme supplies the name of the scheme in which this name is defined.
Status Optional
Datatype teidata.enumerated
Legal values are:
TEI
[Default]
Member of
model.phrase.xml
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
XSD Name
Example
<p>The <gi>xhtml:li</gi> element is roughly analogous to the <gi>item</gi> element, as is the <gi scheme="DBK">listItem</gi> element.</p>
This example shows the use of both a namespace prefix and the scheme attribute as alternative ways of indicating that the <gi> in question is not a TEI element name: in practice only one method should be adopted.
Content model 
<content>
 <dataRef key="teidata.name"/>
</content>
    ⚓
Schema Declaration 
element gi
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute scheme { "TEI" }?,
   teidata.name
}⚓

2.1.42. <graphic>

<graphic> (graphic) indicates the location of a graphic or illustration, either forming part of a text, or providing an image of it. [3.10. Graphics and Other Non-textual Components 11.1. Digital Facsimiles]
Module core
Attributes att.media (att.internetMedia (@mimeType)) att.resourced (@url) att.declaring (@decls) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.graphicLike
Contained by
core: abbr add addrLine corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
transcr: surface
May contain
core: desc
Note

The mimeType attribute should be used to supply the MIME media type of the image specified by the url attribute.

Within the body of a text, a <graphic> element indicates the presence of a graphic component in the source itself. Within the context of a <facsimile> or <sourceDoc> element, however, a <graphic> element provides an additional digital representation of some part of the source being encoded.
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>
Example
<facsimile>  <surfaceGrp n="leaf1">   <surface>    <graphic url="page1.png"/>   </surface>   <surface>    <graphic url="page2-highRes.png"/>    <graphic url="page2-lowRes.png"/>   </surface>  </surfaceGrp> </facsimile>
Example
<facsimile>  <surfaceGrp n="leaf1" xml:id="spi001">   <surface xml:id="spi001r">    <graphic type="normal"     subtype="thumbnail" url="spi/thumb/001r.jpg"/>    <graphic type="normal" subtype="low-res"     url="spi/normal/lowRes/001r.jpg"/>    <graphic type="normal"     subtype="high-res" url="spi/normal/highRes/001r.jpg"/>    <graphic type="high-contrast"     subtype="low-res" url="spi/contrast/lowRes/001r.jpg"/>    <graphic type="high-contrast"     subtype="high-res" url="spi/contrast/highRes/001r.jpg"/>   </surface>   <surface xml:id="spi001v">    <graphic type="normal"     subtype="thumbnail" url="spi/thumb/001v.jpg"/>    <graphic type="normal" subtype="low-res"     url="spi/normal/lowRes/001v.jpg"/>    <graphic type="normal"     subtype="high-res" url="spi/normal/highRes/001v.jpg"/>    <graphic type="high-contrast"     subtype="low-res" url="spi/contrast/lowRes/001v.jpg"/>    <graphic type="high-contrast"     subtype="high-res" url="spi/contrast/highRes/001v.jpg"/>    <zone xml:id="spi001v_detail01">     <graphic type="normal"      subtype="thumbnail" url="spi/thumb/001v-detail01.jpg"/>     <graphic type="normal"      subtype="low-res"      url="spi/normal/lowRes/001v-detail01.jpg"/>     <graphic type="normal"      subtype="high-res"      url="spi/normal/highRes/001v-detail01.jpg"/>     <graphic type="high-contrast"      subtype="low-res"      url="spi/contrast/lowRes/001v-detail01.jpg"/>     <graphic type="high-contrast"      subtype="high-res"      url="spi/contrast/highRes/001v-detail01.jpg"/>    </zone>   </surface>  </surfaceGrp> </facsimile>
Content model 
<content>
 <classRef key="model.descLike"
  minOccurs="0" maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element graphic
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.media.attributes,
   att.resourced.attributes,
   att.declaring.attributes,
   model.descLike*
}⚓

2.1.43. <handDesc>

<handDesc> (description of hands) contains a description of all the different hands used in a manuscript or other object. [10.7.2. Writing, Decoration, and Other Notations]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
hands (hands) specifies the number of distinct hands identified within the manuscript
Status Optional
Datatype teidata.count
Legal values are:
1
2
3
4
5
6
Contained by
msdescription: physDesc
May contain
header: handNote
Example
<handDesc>  <handNote scope="major">Written throughout in <term>angelicana formata</term>.</handNote> </handDesc>
Example
<handDesc hands="2">  <p>The manuscript is written in two contemporary hands, otherwise    unknown, but clearly those of practised scribes. Hand I writes    ff. 1r-22v and hand II ff. 23 and 24. Some scholars, notably    Verner Dahlerup and Hreinn Benediktsson, have argued for a third hand    on f. 24, but the evidence for this is insubstantial.</p> </handDesc>
Content model 
<content>
 <elementRef key="handNote" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element handDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute hands { "1" | "2" | "3" | "4" | "5" | "6" }?,
   handNote+
}⚓

2.1.44. <handNote>

<handNote> (note on hand) describes a particular style or hand distinguished within a manuscript. [10.7.2. Writing, Decoration, and Other Notations]
Module header
Attributes att.handFeatures (@scribe, @scribeRef, @script, @scriptRef, @medium, @scope) att.global (xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:id (identifier) provides a unique identifier for the element bearing the attribute.
Derived from att.global
Status Required
Datatype ID
Legal values are:
hand_1
hand_2
hand_3
hand_4
hand_5
Contained by
msdescription: handDesc
May contain
namesdates: persName
character data
Example
<handNote scope="sole">  <p>Written in insular    phase II half-uncial with interlinear Old English gloss in an Anglo-Saxon pointed    minuscule.</p> </handNote>
Content model 
<content>
 <textNode/>
 <elementRef key="persName" minOccurs="0"/>
</content>
    ⚓
Schema Declaration 
element handNote
{
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.handFeatures.attributes,
   attribute xml:id { "hand_1" | "hand_2" | "hand_3" | "hand_4" | "hand_5" },
   text,
   persName?
}⚓

2.1.45. <hi>

<hi> (mis en évidence) balise qui distingue un mot ou une expression comme graphiquement distincte du texte environnant (souligné, en exposant, encadré, etc...). [3.3.2.2. Emphatic Words and Phrases 3.3.2. Emphasis, Foreign Words, and Unusual Language]
Module core
Attributes att.written (@hand) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
rend (rendition) indicates how the element in question was rendered or presented in the source text.
Derived from att.global.rendition
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
Legal values are:
underline
double-underline
superscript
uppercase
sup
Member of
model.hiLike
Contained by
analysis: w
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
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 ...
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element hi
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.written.attributes,
   attribute rend
   {
      list
      {
         (
            "underline"
          | "double-underline"
          | "superscript"
          | "uppercase"
          | "sup"
         )+
      }
   }?,
   macro.paraContent
}⚓

2.1.46. <history>

<history> (history) groups elements describing the full history of a manuscript, manuscript part, or other object. [10.8. History]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
msdescription: msDesc
May contain
msdescription: provenance
Example
<history>  <origin>   <p>Written in Durham during the mid twelfth      century.</p>  </origin>  <provenance>   <p>Recorded in two medieval      catalogues of the books belonging to Durham Priory, made in 1391 and      1405.</p>  </provenance>  <provenance>   <p>Given to W. Olleyf by William Ebchester, Prior (1446-56)      and later belonged to Henry Dalton, Prior of Holy Island (Lindisfarne)      according to inscriptions on ff. 4v and 5.</p>  </provenance>  <acquisition>   <p>Presented to Trinity College in 1738 by      Thomas Gale and his son Roger.</p>  </acquisition> </history>
Content model 
<content>
 <elementRef key="provenance" minOccurs="1"/>
</content>
    ⚓
Schema Declaration 
element history
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   provenance
}⚓

2.1.47. <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. [13.3.1. Basic Principles 2.2.4. Publication, Distribution, Licensing, etc. 2.2.5. The Series Statement 3.12.2.4. Imprint, Size of a Document, and Reprint Information]
Module header
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
type categorizes the identifier, for example as an ISBN, Social Security number, etc.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
reference
Member of
model.nameLike model.personPart model.publicationStmtPart.detail
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent idno language licence publicationStmt
msdescription: msIdentifier repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
May contain
header: idno
character data
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. Some suggested values for type on <idno> are ISBN, ISSN, DOI, and URI.
Example
<idno type="ISBN">978-1-906964-22-1</idno> <idno type="ISSN">0143-3385</idno> <idno type="DOI">10.1000/123</idno> <idno type="URI">http://www.worldcat.org/oclc/185922478</idno> <idno type="URI">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.
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <elementRef key="idno"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element idno
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   attribute type { "reference" }?,
   ( text | model.gLike | idno )*
}⚓

2.1.48. <item>

<item> (item) contains one component of a list. [3.8. Lists 2.6. The Revision Description]
Module core
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
core: list
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note p pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
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.
Example
<list rend="numbered">  <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>
Content model 
<content>
 <macroRef key="macro.specialPara"/>
</content>
    ⚓
Schema Declaration 
element item
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   macro.specialPara
}⚓

2.1.49. <langUsage>

<langUsage> (language usage) describes the languages, sublanguages, registers, dialects, etc. represented within a text. [2.4.2. Language Usage 2.4. The Profile Description 15.3.2. Declarable Elements]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.profileDescPart
Contained by
header: profileDesc
May contain
core: p
header: language
Example
<langUsage>  <language ident="fr-CA" usage="60">Québecois</language>  <language ident="en-CA" usage="20">Canadian business English</language>  <language ident="en-GB" usage="20">British English</language> </langUsage>
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <elementRef key="language" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element langUsage
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   ( model.pLike+ | language+ )
}⚓

2.1.50. <language>

<language> (language) characterizes a single language or sublanguage used within a text. [2.4.2. Language Usage]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
ident (identifier) Supplies a language code constructed as defined in BCP 47 which is used to identify the language documented by this element, and which is referenced by the global xml:lang attribute.
Status Required
Datatype teidata.language
Legal values are:
fr
Contained by
header: langUsage
May contain
core: abbr address cb choice date expan gap hi lb name note pb ref rs title
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Note

Particularly for sublanguages, an informal prose characterization should be supplied as content for the element.
Example
<langUsage>  <language ident="en-US" usage="75">modern American English</language>  <language ident="i-az-Arab" usage="20">Azerbaijani in Arabic script</language>  <language ident="x-lap" usage="05">Pig Latin</language> </langUsage>
Content model 
<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>
    ⚓
Schema Declaration 
element language
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute ident { "fr" },
   macro.phraseSeq.limited
}⚓

2.1.51. <lb>

<lb> (line beginning) marks the beginning of a new (typographic) line in some edition or version of a text. [3.11.3. Milestone Elements 7.2.5. Speech Contents]
Module core
Attributes att.edition (@ed, @edRef) att.spanning (@spanTo) att.breaking (@break) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.milestoneLike
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item list name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
textstructure: back body div div1 div2 div3 div4 div5 front text
transcr: surface
May contain Empty element
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 specialized attributes break, ed, or edRef 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.
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>  <lb/>With Additions, ne-<lb break="no"/>ver before Printed. </titlePart>
Content model 
<content>
 <empty/>
</content>
    ⚓
Schema Declaration 
element lb
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.edition.attributes,
   att.spanning.attributes,
   att.breaking.attributes,
   empty
}⚓

2.1.52. <licence>

<licence> contains information about a licence or other legal agreement applicable to the text. [2.2.4. Publication, Distribution, Licensing, etc.]
Module header
Attributes att.pointing (@target) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
Member of
model.availabilityPart
Contained by
header: availability
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note p pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
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.
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 target="http://creativecommons.org/licenses/by/3.0/"   notBefore="2013-01-01">   <p>The Creative Commons Attribution 3.0 Unported (CC BY 3.0) Licence      applies to this document.</p>   <p>The licence was added on January 1, 2013.</p>  </licence> </availability>
Content model 
<content>
 <macroRef key="macro.specialPara"/>
</content>
    ⚓
Schema Declaration 
element licence
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.pointing.attributes,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   macro.specialPara
}⚓

2.1.53. <list>

<list> (list) contains any sequence of items organized as a list. [3.8. Lists]
Module core
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.listLike
Contained by
core: add corr del desc hi item note p ref sic title unclear
header: licence sourceDesc
namesdates: occupation
textstructure: back body div div1 div2 div3 div4 div5
May contain
core: cb desc gap item lb note pb
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.
Example
<list rend="numbered">  <item>a butcher</item>  <item>a baker</item>  <item>a candlestick maker, with  <list rend="bulleted">    <item>rings on his fingers</item>    <item>bells on his toes</item>   </list>  </item> </list>
Example
<list type="syllogism" rend="bulleted">  <item>All Cretans are liars.</item>  <item>Epimenides is a Cretan.</item>  <item>ERGO Epimenides is a liar.</item> </list>
Example
<list type="litany" rend="simple">  <item>God save us from drought.</item>  <item>God save us from pestilence.</item>  <item>God save us from wickedness in high places.</item>  <item>Praise be to God.</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 rend="numbered">   <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 rend="numbered">     <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 rend="numbered">     <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 rend="numbered">     <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 rend="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>
Schematron
<sch:rule context="tei:list[@type='gloss']"> <sch:assert test="tei:label">The content of a "gloss" list should include a sequence of one or more pairs of a label element followed by an item element</sch:assert> </sch:rule>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
   <elementRef key="desc" minOccurs="0"
    maxOccurs="unbounded"/>
  </alternate>
  <alternate minOccurs="1" maxOccurs="1">
   <sequence minOccurs="1"
    maxOccurs="unbounded">
    <elementRef key="item"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
   <sequence minOccurs="1" maxOccurs="1">
    <elementRef key="headLabel"
     minOccurs="0"/>
    <elementRef key="headItem"
     minOccurs="0"/>
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <elementRef key="label"/>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
     <elementRef key="item"/>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
   </sequence>
  </alternate>
  <sequence minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divBottom"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element list
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   (
      ( model.divTop | model.global | desc* )*,
      (
         ( item, model.global* )+
       | (
            headLabel?,
            headItem?,
            ( label, model.global*, item, model.global* )+
         )
      ),
      ( model.divBottom, model.global* )*
   )
}⚓

2.1.54. <listOrg>

<listOrg> (list of organizations) contains a list of elements, each of which provides information about an identifiable organization. [13.2.2. Organizational Names]
Module namesdates
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.listLike
Contained by
core: add corr del desc hi item note p ref sic title unclear
corpus: particDesc
header: licence sourceDesc
namesdates: occupation
textstructure: back body div div1 div2 div3 div4 div5
May contain
namesdates: org
Note

The type attribute may be used to distinguish lists of organizations of a particular type if convenient.
Example
<listOrg>  <head>Libyans</head>  <org>   <orgName>Adyrmachidae</orgName>   <desc>These people have, in most points, the same customs as the Egyptians, but      use the costume of the Libyans. Their women wear on each leg a ring made of      bronze [...]</desc>  </org>  <org>   <orgName>Nasamonians</orgName>   <desc>In summer they leave their flocks and herds upon the sea-shore, and go up      the country to a place called Augila, where they gather the dates from the      palms [...]</desc>  </org>  <org>   <orgName>Garamantians</orgName>   <desc>[...] avoid all society or intercourse with their fellow-men, have no      weapon of war, and do not know how to defend themselves. [...]</desc> <!-- ... -->  </org> </listOrg>
Content model 
<content>
 <elementRef key="org" minOccurs="0"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element listOrg
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   attribute default { "false" }?,
   org*
}⚓

2.1.55. <listPerson>

<listPerson> (Liste de personnes) permet de dresser une liste des noms de personnes (ici on relève uniquement les destinateurs, destinataires, scripteurs, intermédiaires de la lettre). [13.3.2. The Person Element 15.2. Contextual Information 2.4. The Profile Description 15.3.2. Declarable Elements]
Module namesdates
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.listLike
Contained by
core: add corr del desc hi item note p ref sic title unclear
corpus: particDesc
header: licence sourceDesc
namesdates: occupation
textstructure: back body div div1 div2 div3 div4 div5
May contain
namesdates: listRelation person
Note

The type attribute may be used to distinguish lists of people of a particular type if convenient.
Example
<listPerson type="respondents">  <personGrp xml:id="PXXX"/>  <person xml:id="P1234" sex="2" age="mid"/>  <person xml:id="P4332" sex="1" age="mid"/>  <listRelation>   <relation type="personal" name="spouse"    mutual="#P1234 #P4332"/>  </listRelation> </listPerson>
Content model 
<content>
 <elementRef key="person" minOccurs="0"
  maxOccurs="unbounded"/>
 <elementRef key="listRelation"/>
</content>
    ⚓
Schema Declaration 
element listPerson
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   attribute default { "false" }?,
   person*,
   listRelation
}⚓

2.1.56. <listPlace>

<listPlace> (Liste de lieux) permet de dresser une liste des lieux mentionnées (ici on relève uniquement que les lieux d'envoi, de transit et d'arrivée du courrier). [2.2.7. The Source Description 13.3.4. Places]
Module namesdates
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.listLike
Contained by
core: add corr del desc hi item note p ref sic title unclear
corpus: settingDesc
header: licence sourceDesc
namesdates: occupation
textstructure: back body div div1 div2 div3 div4 div5
May contain
namesdates: place
Example
<listPlace type="offshoreIslands">  <place>   <placeName>La roche qui pleure</placeName>  </place>  <place>   <placeName>Ile aux cerfs</placeName>  </place> </listPlace>
Content model 
<content>
 <elementRef key="place" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element listPlace
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   attribute default { "false" }?,
   place+
}⚓

2.1.57. <listRelation>

<listRelation> (Liste des relations) permet de dresser les relations qui existent entre les personnes mentionnées dans la listPerson [13.3.2.3. Personal Relationships]
Module namesdates
Attributes att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.listLike
Contained by
core: add corr del desc hi item note p ref sic title unclear
header: licence sourceDesc
namesdates: listPerson occupation
textstructure: back body div div1 div2 div3 div4 div5
May contain
namesdates: relation
Note

May contain a prose description organized as paragraphs, or a sequence of <relation> elements.
Example
<listPerson>  <person xml:id="pp1"> <!-- data about person pp1 -->  </person>  <person xml:id="pp2"> <!-- data about person pp1 -->  </person> <!-- more person (pp3, pp4) elements here -->  <listRelation type="personal">   <relation name="parent"    active="#pp1 #pp2" passive="#pp3 #pp4"/>   <relation name="spouse"    mutual="#pp1 #pp2"/>  </listRelation>  <listRelation type="social">   <relation name="employer" active="#pp1"    passive="#pp3 #pp5 #pp6 #pp7"/>  </listRelation> </listPerson>
The persons with identifiers pp1 and pp2 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
<listPerson>  <person xml:id="en_pp1"> <!-- data about person en_pp1 -->  </person>  <person xml:id="en_pp2"> <!-- data about person en_pp2 -->  </person> <!-- more person (en_pp3, en_pp4) elements here --> </listPerson> <listPlace>  <place xml:id="en_pl1"> <!-- data about place en_pl1 -->  </place> <!-- more place (en_pl2, en_pl3) elements here --> </listPlace> <listRelation>  <relation name="residence"   active="#en_pp1 #en_pp2" passive="#en_pl1"/> </listRelation>
The persons with identifiers en_pp1 and en_pp2 live in en_pl1.
Example
<listRelation>  <p>All speakers are members of the Ceruli family, born in Naples.</p> </listRelation>
Content model 
<content>
 <elementRef key="relation" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element listRelation
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   relation+
}⚓

2.1.58. <moduleRef>

<moduleRef> (module reference) references a module which is to be incorporated into a schema. [22.2. Modules and Schemas]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
include supplies a list of the elements which are to be copied from the specified module into the schema being defined.
Status Optional
Datatype 0–∞ occurrences of teidata.xmlName separated by whitespace
except
Status Optional
key the name of a TEI module
Status Optional
Datatype teidata.xmlName
url
Status Optional
Member of
model.oddRef
Contained by
tagdocs: schemaSpec
May contain Empty element
Note

If neither include nor except is supplied, the effect of this element is to make all the declarations contained by the referenced module available to the schema being compiled. If both attributes are supplied, an ODD processor should signal an error.

A TEI module is identified by the name supplied as value for the ident attribute on a <moduleSpec> element. The source attribute may be used to specify an online source from which the specification of that module may be read. A URI may alternatively be supplied in the case of a non-TEI module, and this is expected to be written as a RELAX NG schema.

If the url attribute is used, the <content> element may also be supplied as a child of this element. Its content (which is assumed to be a fragment of RELAX NG code) will be copied along with the content of the resource indicated by the url attribute into the target RELAX NG schema.
Example
<moduleRef key="linking"/>
This includes all objects available from the linking module.
Example
<moduleRef key="linking"  except="linkGrp link"/>
This includes all elements available from the linking module except for the <link> and <linkGrp> elements.
Example
<moduleRef key="linking"  include="linkGrp link"/>
This includes only the <link> and <linkGrp> elements from the linking module.
Schematron
<s:rule context="tei:moduleRef"> <s:report test="* and @key">Child elements of <s:name/> are only allowed when an external module is being loaded </s:report> </s:rule>
Content model 
<content>
 <elementRef key="content" minOccurs="0"/>
</content>
    ⚓
Schema Declaration 
element moduleRef
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( attribute include { list { * } }? | attribute except { text }? ),
   ( attribute key { text }? | attribute url { text }? ),
   content?
}⚓

2.1.59. <msDesc>

<msDesc> (manuscript description) contains a description of a single identifiable manuscript or other text-bearing object such as an early printed book. [10.1. Overview]
Module msdescription
Attributes att.sortable (@sortKey) att.declaring (@decls) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
letter
status describes the status of a document either currently or, when associated with a dated element, at the time indicated.
Derived from att.docStatus
Status Optional
Datatype teidata.enumerated
Legal values are:
draft
[Default]
Member of
model.biblLike
Contained by
core: add corr del desc hi item note p ref sic title unclear
header: licence sourceDesc
namesdates: occupation person
textstructure: body div div1 div2 div3 div4 div5
May contain
core: p
msdescription: history msIdentifier physDesc
Note

Although the <msDesc> has primarily been designed with a view to encoding manuscript descriptions, it may also be used for other objects such as early printed books, fascicles, epigraphs, or any text-bearing objects that require substantial description. If an object is not text-bearing or the reasons for describing the object is not primarily the textual content, the more general <object> may be more suitable.
Example
<msDesc>  <msIdentifier>   <settlement>Oxford</settlement>   <repository>Bodleian Library</repository>   <idno type="Bod">MS Poet. Rawl. D. 169.</idno>  </msIdentifier>  <msContents>   <msItem>    <author>Geoffrey Chaucer</author>    <title>The Canterbury Tales</title>   </msItem>  </msContents>  <physDesc>   <objectDesc>    <p>A parchment codex of 136 folios, measuring approx        28 by 19 inches, and containing 24 quires.</p>    <p>The pages are margined and ruled throughout.</p>    <p>Four hands have been identified in the manuscript: the first 44        folios being written in two cursive anglicana scripts, while the        remainder is for the most part in a mixed secretary hand.</p>   </objectDesc>  </physDesc> </msDesc>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="msIdentifier"/>
  <classRef key="model.headLike"
   minOccurs="0" maxOccurs="unbounded"/>
  <alternate minOccurs="1" maxOccurs="1">
   <classRef key="model.pLike"
    minOccurs="1" maxOccurs="unbounded"/>
   <sequence minOccurs="1" maxOccurs="1">
    <elementRef key="msContents"
     minOccurs="0"/>
    <elementRef key="physDesc"
     minOccurs="0"/>
    <elementRef key="history" minOccurs="0"/>
    <elementRef key="additional"
     minOccurs="0"/>
    <alternate minOccurs="1" maxOccurs="1">
     <elementRef key="msPart" minOccurs="0"
      maxOccurs="unbounded"/>
     <elementRef key="msFrag" minOccurs="0"
      maxOccurs="unbounded"/>
    </alternate>
   </sequence>
  </alternate>
 </sequence>
</content>
    ⚓
Schema Declaration 
element msDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.sortable.attributes,
   att.declaring.attributes,
   attribute type { "letter" }?,
   attribute status { "draft" }?,
   (
      msIdentifier,
      model.headLike*,
      (
         model.pLike+
       | (
            msContents?,
            physDesc?,
            history?,
            additional?,
            ( msPart* | msFrag* )
         )
      )
   )
}⚓

2.1.60. <msIdentifier>

<msIdentifier> (manuscript identifier) contains the information required to identify the manuscript or similar object being described. [10.4. The Manuscript Identifier]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
msdescription: msDesc
May contain
header: idno
msdescription: repository
namesdates: country settlement
Example
<msIdentifier>  <settlement>San Marino</settlement>  <repository>Huntington Library</repository>  <idno>MS.El.26.C.9</idno> </msIdentifier>
Schematron
<s:report test="not(parent::tei:msPart) and (local-name(*[1])='idno' or local-name(*[1])='altIdentifier' or normalize-space(.)='')">An msIdentifier must contain either a repository or location.</s:report>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="country"/>
  <elementRef key="settlement"/>
  <elementRef key="repository"/>
  <elementRef key="idno"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element msIdentifier
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( country, settlement, repository, idno )
}⚓

2.1.61. <name>

<name> (Contient le nom d'une personne) permet de relever le nom d'une personne, si on a pas su différencier le prénom du nom de famille. [3.6.1. Referring Strings]
Module core
Attributes att.datable (att.datable.w3c (@when)) (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 (@instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
full indicates whether the name component is given in full, as an abbreviation or simply as an initial.
Derived from att.personal
Status Optional
Datatype teidata.enumerated
Legal values are:
yes
[Default]
ref (reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.
Derived from att.canonical
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Member of
model.nameLike.agent model.personPart
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p publisher ref resp respStmt rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
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.
Example
<name type="person">Thomas Hoccleve</name> <name type="place">Villingaholt</name> <name type="org">Vetus Latina Institut</name> <name type="person" ref="#HOC001">Occleve</name>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element name
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.attributes,
   att.editLike.attributes,
   attribute full { "yes" }?,
   attribute ref { list { + } }?,
   attribute type { text }?,
   macro.phraseSeq
}⚓

2.1.62. <note>

<note> (note) contains a note or annotation. [3.9.1. Notes and Simple Annotation 2.2.6. The Notes Statement 3.12.2.8. Notes and Statement of Language 9.3.5.4. Notes within Entries]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.placement (@place) att.pointing (@target) att.typed (@type) att.written (@hand) att.anchoring (@anchored, @targetEnd)
Member of
model.correspActionPart model.noteLike
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item list name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
textstructure: back body div div1 div2 div3 div4 div5 front text
transcr: surface
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note p pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
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" type="gloss"  resp="#MDMH">  <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. <!-- elsewhere in the document --> <respStmt xml:id="MDMH">  <resp>translation from German to English</resp>  <name>Hottinger, Marie Donald Mackie</name> </respStmt>
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.
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 n="126" anchored="true"> 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.
Content model 
<content>
 <macroRef key="macro.specialPara"/>
</content>
    ⚓
Schema Declaration 
element note
{
   att.global.attributes,
   att.placement.attributes,
   att.pointing.attributes,
   att.typed.attributes,
   att.written.attributes,
   att.anchoring.attributes,
   macro.specialPara
}⚓

2.1.63. <objectDesc>

<objectDesc> (object description) contains a description of the physical components making up the object which is being described. [10.7.1. Object Description]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
msdescription: physDesc
May contain
msdescription: supportDesc
Example
<objectDesc form="codex">  <supportDesc material="mixed">   <p>Early modern   <material>parchment</material> and   <material>paper</material>.</p>  </supportDesc>  <layoutDesc>   <layout ruledLines="25 32"/>  </layoutDesc> </objectDesc>
Content model 
<content>
 <elementRef key="supportDesc"/>
</content>
    ⚓
Schema Declaration 
element objectDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   supportDesc
}⚓

2.1.64. <occupation>

<occupation> (Occupation) contient une description de la profession d'une personne [15.2.2. The Participant Description]
Module namesdates
Attributes att.editLike (@instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
Member of
model.persStateLike
Contained by
namesdates: person
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note p pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Note

The content of this element may be used as an alternative to the more formal specification made possible by its attributes; it may also be used to supplement the formal specification with commentary or clarification.
Example
<occupation>accountant</occupation>
Example
<occupation scheme="#occupationtaxonomy"  code="#acc">accountant</occupation>
Content model 
<content>
 <macroRef key="macro.specialPara"/>
</content>
    ⚓
Schema Declaration 
element occupation
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   att.editLike.attributes,
   macro.specialPara
}⚓

2.1.65. <org>

<org> (Organisation) fournit des informations sur une personne morale, groupement de personnes, entreprise ou institution civile ou religieuse. [13.3.3. Organizational Data]
Module namesdates
Attributes att.editLike (@instant) att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Sample values include:
Member of
model.personLike
Contained by
corpus: particDesc
namesdates: listOrg
May contain
core: desc
namesdates: orgName
Example
<org xml:id="JAMs">  <orgName>Justified Ancients of Mummu</orgName>  <desc>An underground anarchist collective spearheaded by  <persName>Hagbard Celine</persName>, who fight the Illuminati    from a golden submarine, the <name>Leif Ericson</name>  </desc>  <bibl>   <author>Robert Shea</author>   <author>Robert Anton Wilson</author>   <title>The Illuminatus! Trilogy</title>  </bibl> </org>
Content model 
<content>
 <elementRef key="orgName"/>
 <elementRef key="desc"/>
</content>
    ⚓
Schema Declaration 
element org
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute type { text }?,
   orgName,
   desc
}⚓

2.1.66. <orgName>

<orgName> (organization name) contains an organizational name. [13.2.2. Organizational Names]
Module namesdates
Attributes att.editLike (@instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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.canonical (@ref)
full indicates whether the name component is given in full, as an abbreviation or simply as an initial.
Derived from att.personal
Status Optional
Datatype teidata.enumerated
Legal values are:
yes
[Default]
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Suggested values include:
ship
Member of
model.nameLike.agent
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation org orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
About a year back, a question of considerable interest was agitated in the <orgName key="PAS1" type="voluntary">  <placeName key="PEN">Pennsyla.</placeName> Abolition Society </orgName> [...]
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element orgName
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   att.editLike.attributes,
   att.canonical.attribute.ref,
   attribute full { "yes" }?,
   attribute type { "ship" }?,
   macro.phraseSeq
}⚓

2.1.67. <p>

<p> (Contenu textuel) contient le contenu textuel de la lettre. [3.1. Paragraphs 7.2.5. Speech Contents]
Module core
Attributes att.declaring (@decls) att.written (@hand) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
part specifies whether or not its parent element is fragmented in some way, typically by some other overlapping structure: for example a speech which is divided between two or more verse stanzas, a paragraph which is split across a page division, a verse line which is divided between two speakers.
Derived from att.fragmentable
Status Optional
Datatype teidata.enumerated
Legal values are:
N
[Default]
Member of
model.pLike
Contained by
core: item note
corpus: particDesc
header: availability correspAction editionStmt editorialDecl encodingDesc langUsage licence projectDesc publicationStmt segmentation sourceDesc
msdescription: msDesc provenance
namesdates: occupation person
textstructure: back body div div1 div2 div3 div4 div5 front
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
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>
Schematron
<sch:report test=" (ancestor::tei:ab or ancestor::tei:p) and not( ancestor::tei:floatingText |parent::tei:exemplum |parent::tei:item |parent::tei:note |parent::tei:q |parent::tei:quote |parent::tei:remarks |parent::tei:said |parent::tei:sp |parent::tei:stage |parent::tei:cell |parent::tei:figure )"> Abstract model violation: Paragraphs may not occur inside other paragraphs or ab elements. </sch:report>
Schematron
<sch:report test=" (ancestor::tei:l or ancestor::tei:lg) and not( ancestor::tei:floatingText |parent::tei:figure |parent::tei:note )"> Abstract model violation: Lines may not contain higher-level structural elements such as div, p, or ab, unless p is a child of figure or note, or is a descendant of floatingText. </sch:report>
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element p
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.declaring.attributes,
   att.written.attributes,
   attribute part { "N" }?,
   macro.paraContent
}⚓

2.1.68. <particDesc>

<particDesc> (participation description) describes the identifiable speakers, voices, or other participants in any kind of text or other persons named or otherwise referred to in a text, edition, or metadata. [15.2. Contextual Information]
Module corpus
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.profileDescPart
Contained by
header: profileDesc
May contain
core: p
namesdates: listOrg listPerson org person
Note

May contain a prose description organized as paragraphs, or a structured list of persons and person groups, with an optional formal specification of any relationships amongst them.
Example
<particDesc>  <listPerson>   <person xml:id="P-1234" sex="2" age="mid">    <p>Female informant, well-educated, born in        Shropshire UK, 12 Jan 1950, of unknown occupation. Speaks French fluently.        Socio-Economic status B2.</p>   </person>   <person xml:id="P-4332" sex="1">    <persName>     <surname>Hancock</surname>     <forename>Antony</forename>     <forename>Aloysius</forename>     <forename>St John</forename>    </persName>    <residence notAfter="1959">     <address>      <street>Railway Cuttings</street>      <settlement>East Cheam</settlement>     </address>    </residence>    <occupation>comedian</occupation>   </person>   <listRelation>    <relation type="personal" name="spouse"     mutual="#P-1234 #P-4332"/>   </listRelation>  </listPerson> </particDesc>
This example shows both a very simple person description, and a very detailed one, using some of the more specialized elements from the module for Names and Dates.
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.personLike"/>
   <elementRef key="listPerson"/>
   <elementRef key="listOrg"/>
  </alternate>
 </alternate>
</content>
    ⚓
Schema Declaration 
element particDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   ( model.pLike+ | ( model.personLike | listPerson | listOrg )+ )
}⚓

2.1.69. <pb>

<pb> (page beginning) marks the beginning of a new page in a paginated document. [3.11.3. Milestone Elements]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.edition (@ed, @edRef) att.spanning (@spanTo) att.breaking (@break)
Member of
model.milestoneLike
Contained by
analysis: w
core: abbr add addrLine corr date del expan hi item list name note p ref resp rs sic title unclear
header: edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
textstructure: back body div div1 div2 div3 div4 div5 front text
transcr: surface
May contain Empty element
Note

A <pb> element should appear at the start of the page which it identifies. The global n attribute indicates the number or other value associated with this page. 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. The more specialized attributes break, ed, or edRef should be preferred when the intent is to indicate whether or not the page break is word-breaking, or to note the source from which it derives.
Example Page numbers may vary in different editions of a text.
<p> ... <pb n="145" ed="ed2"/> <!-- Page 145 in edition "ed2" starts here --> ... <pb n="283" ed="ed1"/> <!-- Page 283 in edition "ed1" starts here--> ... </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 n="1" facs="page1.png"/> <!-- page1.png contains an image of the page; the text it contains is encoded here -->  <p> <!-- ... -->  </p>  <pb n="2" facs="page2.png"/> <!-- similarly, for page 2 -->  <p> <!-- ... -->  </p> </body>
Content model 
<content>
 <empty/>
</content>
    ⚓
Schema Declaration 
element pb
{
   att.global.attributes,
   att.edition.attributes,
   att.spanning.attributes,
   att.breaking.attributes,
   empty
}⚓

2.1.70. <persName>

<persName> (Nom de personne) permet de signaler le nom d'une personne. [13.2.1. Personal Names]
Module namesdates
Attributes att.editLike (@instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
full indicates whether the name component is given in full, as an abbreviation or simply as an initial.
Derived from att.personal
Status Optional
Datatype teidata.enumerated
Legal values are:
yes
[Default]
ref (reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.
Derived from att.canonical
Status Recommended
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Member of
model.nameLike.agent model.persStateLike
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent handNote language licence
msdescription: repository
namesdates: country forename occupation orgName persName person placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<persName>  <forename>Edward</forename>  <forename>George</forename>  <surname type="linked">Bulwer-Lytton</surname>, <roleName>Baron Lytton of  <placeName>Knebworth</placeName>  </roleName> </persName>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element persName
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   att.editLike.attributes,
   attribute full { "yes" }?,
   attribute ref { list { + } }?,
   macro.phraseSeq
}⚓

2.1.71. <person>

<person> (Personne) permet de renseigner des informations sur une personne (identifiant, nom, prénom, sexe, profession). [13.3.2. The Person Element 15.2.2. The Participant Description]
Module namesdates
Attributes att.editLike (@instant) att.sortable (@sortKey) att.global (xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:id (identifier) provides a unique identifier for the element bearing the attribute.
Derived from att.global
Status Required
Datatype ID
sex specifies the sex of the person.
Status Optional
Datatype 1–∞ occurrences of teidata.sex separated by whitespace
Note

Values for this attribute may be locally defined by a project, or may refer to an external standard, such as vCard's sex property http://microformats.org/wiki/gender-formats (in which M indicates male, F female, O other, N none or not applicable, U unknown), or the often used ISO 5218:2004 Representation of Human Sexes http://standards.iso.org/ittf/PubliclyAvailableStandards/c036266_ISO_IEC_5218_2004(E_F).zip (in which 0 indicates unknown; 1 male; 2 female; and 9 not applicable, although the ISO standard is widely considered inadequate); cf. CETH's Recommendations for Inclusive Data Collection of Trans People http://transhealth.ucsf.edu/trans?page=lib-data-collection.
Member of
model.personLike
Contained by
corpus: particDesc
namesdates: listPerson
May contain
core: cb gap lb name note p pb
header: idno
msdescription: msDesc
namesdates: occupation persName sex
Note

May contain either a prose description organized as paragraphs, or a sequence of more specific demographic elements drawn from the model.personPart class.
Example
<person sex="F" age="adult">  <p>Female respondent, well-educated, born in Shropshire UK, 12 Jan 1950, of unknown occupation. Speaks French fluently. Socio-Economic    status B2.</p> </person>
Example
<person sex="intersex" role="god"  age="immortal">  <persName>Hermaphroditos</persName>  <persName xml:lang="grc">Ἑρμαφρόδιτος</persName> </person>
Example
<person xml:id="Ovi01" sex="1" role="poet">  <persName xml:lang="en">Ovid</persName>  <persName xml:lang="la">Publius Ovidius Naso</persName>  <birth when="-0044-03-20"> 20 March 43 BC <placeName>    <settlement type="city">Sulmona</settlement>    <country key="IT">Italy</country>   </placeName>  </birth>  <death notBefore="0017" notAfter="0018">17 or 18 AD <placeName>    <settlement type="city">Tomis (Constanta)</settlement>    <country key="RO">Romania</country>   </placeName>  </death> </person>
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.personPart"/>
   <classRef key="model.global"/>
   <elementRef key="ptr"/>
  </alternate>
 </alternate>
</content>
    ⚓
Schema Declaration 
element person
{
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute xml:id { text },
   attribute sex { list { + } }?,
   ( model.pLike+ | ( model.personPart | model.global | ptr )* )
}⚓

2.1.72. <physDesc>

<physDesc> (physical description) contains a full physical description of a manuscript, manuscript part, or other object optionally subdivided using more specialized elements from the model.physDescPart class. [10.7. Physical Description]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
msdescription: msDesc
May contain
msdescription: handDesc objectDesc
Example
<physDesc>  <objectDesc form="codex">   <supportDesc material="perg">    <support>Parchment.</support>    <extent>i + 55 leaves    <dimensions scope="all" type="leaf"      unit="inch">      <height>7¼</height>      <width>5⅜</width>     </dimensions>    </extent>   </supportDesc>   <layoutDesc>    <layout columns="2">In double columns.</layout>   </layoutDesc>  </objectDesc>  <handDesc>   <p>Written in more than one hand.</p>  </handDesc>  <decoDesc>   <p>With a few coloured capitals.</p>  </decoDesc> </physDesc>
Content model 
<content>
 <elementRef key="objectDesc"/>
 <elementRef key="handDesc"/>
</content>
    ⚓
Schema Declaration 
element physDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   objectDesc,
   handDesc
}⚓

2.1.73. <place>

<place> (Lieu) permet d'encoder des informations sur un lieu (identifiant, nom et type de lieu). [13.3.4. Places]
Module namesdates
Attributes att.editLike (@instant) att.sortable (@sortKey) att.global (xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:id (identifier) provides a unique identifier for the element bearing the attribute.
Derived from att.global
Status Required
Datatype ID
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
district
city
island
province
region
country
Contained by
namesdates: listPlace
May contain
namesdates: placeName
Example
<place>  <country>Lithuania</country>  <country xml:lang="lt">Lietuva</country>  <place>   <settlement>Vilnius</settlement>  </place>  <place>   <settlement>Kaunas</settlement>  </place> </place>
Content model 
<content>
 <elementRef key="placeName"/>
</content>
    ⚓
Schema Declaration 
element place
{
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute xml:id { text },
   attribute type
   {
      "district" | "city" | "island" | "province" | "region" | "country"
   }?,
   placeName
}⚓

2.1.74. <placeName>

<placeName> (Nom de lieu) permet de signaler le nom d'un lieu (absolu ou relatif). [13.2.3. Place Names]
Module namesdates
Attributes att.editLike (@instant) 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.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
full indicates whether the name component is given in full, as an abbreviation or simply as an initial.
Derived from att.personal
Status Optional
Datatype teidata.enumerated
Legal values are:
yes
[Default]
ref (reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.
Derived from att.canonical
Status Recommended
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
address
composition
destination
provenance
Member of
model.placeNamePart
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName place placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<placeName>  <settlement>Rochester</settlement>  <region>New York</region> </placeName>
Example
<placeName>  <geogName>Arrochar Alps</geogName>  <region>Argylshire</region> </placeName>
Example
<placeName>  <measure>10 miles</measure>  <offset>Northeast of</offset>  <settlement>Attica</settlement> </placeName>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element placeName
{
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   att.editLike.attributes,
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute full { "yes" }?,
   attribute ref { list { + } }?,
   attribute type { "address" | "composition" | "destination" | "provenance" }?,
   macro.phraseSeq
}⚓

2.1.75. <profileDesc>

<profileDesc> (text-profile description) provides a detailed description of non-bibliographic aspects of a text, specifically the languages and sublanguages used, the situation in which it was produced, the participants and their setting. [2.4. The Profile Description 2.1.1. The TEI Header and Its Components]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.teiHeaderPart
Contained by
header: teiHeader
May contain
corpus: particDesc settingDesc
header: correspDesc langUsage
Note

Although the content model permits it, it is rarely meaningful to supply multiple occurrences for any of the child elements of <profileDesc> unless these are documenting multiple texts.
Example
<profileDesc>  <langUsage>   <language ident="fr">French</language>  </langUsage>  <textDesc n="novel">   <channel mode="w">print; part issues</channel>   <constitution type="single"/>   <derivation type="original"/>   <domain type="art"/>   <factuality type="fiction"/>   <interaction type="none"/>   <preparedness type="prepared"/>   <purpose type="entertain" degree="high"/>   <purpose type="inform" degree="medium"/>  </textDesc>  <settingDesc>   <setting>    <name>Paris, France</name>    <time>Late 19th century</time>   </setting>  </settingDesc> </profileDesc>
Content model 
<content>
 <classRef key="model.profileDescPart"
  minOccurs="0" maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element profileDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   model.profileDescPart*
}⚓

2.1.76. <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. The Project Description 2.3. The Encoding Description 15.3.2. Declarable Elements]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.encodingDescPart
Contained by
header: encodingDesc
May contain
core: p
Example
<projectDesc>  <p>Texts collected for use in the Claremont Shakespeare Clinic, June 1990</p> </projectDesc>
Content model 
<content>
 <classRef key="model.pLike" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element projectDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   model.pLike+
}⚓

2.1.77. <provenance>

<provenance> (provenance) contains any descriptive or other information concerning a single identifiable episode during the history of a manuscript, manuscript part, or other object after its creation but before its acquisition. [10.8. History]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
Contained by
msdescription: history
May contain
core: p
Example
<provenance>Listed as the property of Lawrence Sterne in 1788.</provenance> <provenance>Sold at Sothebys in 1899.</provenance>
Content model 
<content>
 <elementRef key="p" minOccurs="1"
  maxOccurs="2"/>
</content>
    ⚓
Schema Declaration 
element provenance
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   ( p, p? )
}⚓

2.1.78. <pubPlace>

<pubPlace> (publication place) contains the name of the place where a bibliographic item was published. [3.12.2.4. Imprint, Size of a Document, and Reprint Information]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.publicationStmtPart.detail
Contained by
header: publicationStmt
May contain
core: address
Example
<publicationStmt>  <publisher>Oxford University Press</publisher>  <pubPlace>Oxford</pubPlace>  <date>1989</date> </publicationStmt>
Content model 
<content>
 <elementRef key="address"/>
</content>
    ⚓
Schema Declaration 
element pubPlace
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   address
}⚓

2.1.79. <publicationStmt>

<publicationStmt> (publication statement) groups information concerning the publication or distribution of an electronic or other text. [2.2.4. Publication, Distribution, Licensing, etc. 2.2. The File Description]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
header: fileDesc
May contain
core: address date p pubPlace publisher ref
header: availability idno
Note

Where a publication statement contains several members of the model.publicationStmtPart.agency or model.publicationStmtPart.detail classes rather than one or more paragraphs or anonymous blocks, care should be taken to ensure that the repeated elements are presented in a meaningful order. It is a conformance requirement that elements supplying information about publication place, address, identifier, availability, and date be given following the name of the publisher, distributor, or authority concerned, and preferably in that order.
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>
Example
<publicationStmt>  <publisher>Zea Books</publisher>  <pubPlace>Lincoln, NE</pubPlace>  <date>2017</date>  <availability>   <p>This is an open access work licensed under a Creative Commons Attribution 4.0 International license.</p>  </availability>  <ptr target="http://digitalcommons.unl.edu/zeabook/55"/> </publicationStmt>
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <sequence minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.publicationStmtPart.agency"/>
   <classRef key="model.publicationStmtPart.detail"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element publicationStmt
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   (
      ( model.publicationStmtPart.agency, model.publicationStmtPart.detail* )+
    | model.pLike+
   )
}⚓

2.1.80. <publisher>

<publisher> (publisher) provides the name of the organization responsible for the publication or distribution of a bibliographic item. [3.12.2.4. Imprint, Size of a Document, and Reprint Information 2.2.4. Publication, Distribution, Licensing, etc.]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.publicationStmtPart.agency
Contained by
header: publicationStmt
May contain
core: name
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
Example
<imprint>  <pubPlace>Oxford</pubPlace>  <publisher>Clarendon Press</publisher>  <date>1987</date> </imprint>
Content model 
<content>
 <elementRef key="name"/>
</content>
    ⚓
Schema Declaration 
element publisher
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   name
}⚓

2.1.81. <ref>

<ref> (reference) defines a reference to another location, possibly modified by additional text or comment. [3.7. Simple Links and Cross-References 16.1. Links]
Module core
Attributes att.cReferencing (@cRef) att.declaring (@decls) att.internetMedia (@mimeType) att.pointing (@target) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.ptrLike
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence publicationStmt
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Note

The target and cRef attributes are mutually exclusive.
Example
See especially <ref target="http://www.natcorp.ox.ac.uk/Texts/A02.xml#s2">the second sentence</ref>
Example
See also <ref target="#locution">s.v. <term>locution</term> </ref>.
Schematron
<s:report test="@target and @cRef">Only one of the attributes @target' and @cRef' may be supplied on <s:name/> </s:report>
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element ref
{
   att.cReferencing.attributes,
   att.declaring.attributes,
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.internetMedia.attributes,
   att.pointing.attributes,
   macro.paraContent
}⚓

2.1.82. <relation>

<relation> (relationship) describes any kind of relationship or linkage amongst a specified group of places, events, persons, objects or other items. [13.3.2.3. Personal Relationships]
Module namesdates
Attributes att.editLike (@instant) att.sortable (@sortKey) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
social
personal
active identifies the ‘active’ participants in a non-mutual relationship, or all the participants in a mutual one.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
mutual
Status Optional
name supplies a name for the kind of relationship of which this is an instance.
Status Optional
Datatype teidata.enumerated
Legal values are:
acquaintances
aunt
child
cousins
employee
engaged
family
father
friends
family
grandchild
grandparent
lover
mother
nephew
parent
partners
professional
siblings
sisters-in-law
stepdaughter
supervisor
spouse
uncle
unknown
passive identifies the ‘passive’ participants in a non-mutual relationship.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Contained by
namesdates: listRelation
May contain
core: desc
Note

Only one of the attributes active and mutual may be supplied; the attribute passive may be supplied only if the attribute active is supplied. Not all of these constraints can be enforced in all schema languages.
Example
<relation type="social" name="supervisor"  active="#p1" passive="#p2 #p3 #p4"/>
This indicates that the person with identifier p1 is supervisor of persons p2, p3, and p4.
Example
<relation type="personal" name="friends"  mutual="#p2 #p3 #p4"/>
This indicates that p2, p3, and p4 are all friends.
Example
<relation type="CRM"  name="P89_falls_within"  active="http://id.clarosnet.org/places/metamorphoses/place/italy-orvieto"  passive="http://id.clarosnet.org/places/metamorphoses/country/IT"/>
This indicates that there is a relation, defined by CIDOC CRM, between two resources identified by URLs.
Example
<relation resp="http://viaf.org/viaf/44335536/"  ref="http://purl.org/saws/ontology#isVariantOf"  active="http://www.ancientwisdoms.ac.uk/cts/urn:cts:greekLit:tlg3017.Syno298.sawsGrc01:divedition.divsection1.o14.a107"  passive="http://data.perseus.org/citations/urn:cts:greekLit:tlg0031.tlg002.perseus-grc1:9.35"/>
This example records a relationship, defined by the SAWS ontology, between a passage of text identified by a CTS URN, and a variant passage of text in the Perseus Digital Library, and assigns the identification of the relationship to a particular editor (all using resolvable URIs).
Schematron
<s:assert test="@ref or @key or @name">One of the attributes 'name', 'ref' or 'key' must be supplied</s:assert>
Schematron
<s:report test="@active and @mutual">Only one of the attributes @active and @mutual may be supplied</s:report>
Schematron
<s:report test="@passive and not(@active)">the attribute 'passive' may be supplied only if the attribute 'active' is supplied</s:report>
Content model 
<content>
 <elementRef key="desc" minOccurs="0"/>
</content>
    ⚓
Schema Declaration 
element relation
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute type { "social" | "personal" }?,
   ( attribute active { list { + } }? | attribute mutual { text }? ),
   attribute name
   {
      "acquaintances"
    | "aunt"
    | "child"
    | "cousins"
    | "employee"
    | "engaged"
    | "family"
    | "father"
    | "friends"
    | "family"
    | "grandchild"
    | "grandparent"
    | "lover"
    | "mother"
    | "nephew"
    | "parent"
    | "partners"
    | "professional"
    | "siblings"
    | "sisters-in-law"
    | "stepdaughter"
    | "supervisor"
    | "spouse"
    | "uncle"
    | "unknown"
   }?,
   attribute passive { list { + } }?,
   desc?
}⚓

2.1.83. <repository>

<repository> (repository) contains the name of a repository within which manuscripts or other objects are stored, possibly forming part of an institution. [10.4. The Manuscript Identifier]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
msdescription: msIdentifier
May contain
core: abbr address cb choice date expan gap hi lb name note pb ref rs title
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<msIdentifier>  <settlement>Oxford</settlement>  <institution>University of Oxford</institution>  <repository>Bodleian Library</repository>  <idno>MS. Bodley 406</idno> </msIdentifier>
Content model 
<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>
    ⚓
Schema Declaration 
element repository
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   macro.phraseSeq.limited
}⚓

2.1.84. <resp>

<resp> (responsibility) contains a phrase describing the nature of a person's intellectual responsibility, or an organization's role in the production or distribution of a work. [3.12.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.2. The Edition Statement 2.2.5. The Series Statement]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
Contained by
core: respStmt
May contain
core: abbr address cb choice date expan gap hi lb name note pb ref rs title
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Note

The attribute ref, inherited from the class att.canonical may be used to indicate the kind of responsibility in a normalized form by referring directly to a standardized list of responsibility types, such as that maintained by a naming authority, for example the list maintained at http://www.loc.gov/marc/relators/relacode.html for bibliographic usage.
Example
<respStmt>  <resp ref="http://id.loc.gov/vocabulary/relators/com.html">compiler</resp>  <name>Edward Child</name> </respStmt>
Content model 
<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>
    ⚓
Schema Declaration 
element resp
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   macro.phraseSeq.limited
}⚓

2.1.85. <respStmt>

<respStmt> (statement of responsibility) supplies a statement of responsibility for the intellectual content of a text, edition, recording, or series, where the specialized elements for authors, editors, etc. do not suffice or do not apply. May also be used to encode information about individuals or organizations which have played a role in the production or distribution of a bibliographic work. [3.12.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.2. The Edition Statement 2.2.5. The Series Statement]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.respLike
Contained by
header: editionStmt titleStmt
May contain
core: name resp
Example
<respStmt>  <resp>transcribed from original ms</resp>  <persName>Claus Huitfeldt</persName> </respStmt>
Example
<respStmt>  <resp>converted to XML encoding</resp>  <name>Alan Morrison</name> </respStmt>
Content model 
<content>
 <elementRef key="resp"/>
 <elementRef key="name" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element respStmt
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   resp,
   name+
}⚓

2.1.86. <rs>

<rs> (nom générique) contient un nom générique (ex:'le père' pour parler de quelqu'un) [13.2.1. Personal Names 3.6.1. Referring Strings]
Module core
Attributes att.naming (att.canonical (@ref)) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.nameLike
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<q>My dear <rs type="person">Mr. Bennet</rs>, </q> said <rs type="person">his lady</rs> to him one day, <q>have you heard that <rs type="place">Netherfield Park</rs> is let at last?</q>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element rs
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.naming.attributes,
   macro.phraseSeq
}⚓

2.1.87. <schemaSpec>

<schemaSpec> (schema specification) generates a TEI-conformant schema and documentation for it. [2.3. The Encoding Description 22.2. Modules and Schemas 23.5.1. Making a Unified ODD]
Module tagdocs
Attributes att.namespaceable (@ns) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.identified (@ident) att.deprecated (@validUntil)
start specifies entry points to the schema, i.e. which patterns may be used as the root of documents conforming to it.
Status Optional
Datatype 1–∞ occurrences of teidata.name separated by whitespace
Default TEI
docLang (documentation language) specifies which languages to use when creating documentation if the description for an element, attribute, class or macro is available in more than one language
Status Optional
Datatype 1–∞ occurrences of teidata.language separated by whitespace
Note

Although multiple languages may be specified, the current TEI ODD processor is only capable of handling one.
Member of
model.encodingDescPart model.frontPart
Contained by
header: encodingDesc
textstructure: back body div div1 div2 div3 div4 div5 front
May contain
core: desc
tagdocs: classRef classSpec elementSpec moduleRef
Note

A <schemaSpec> combines references to modules, individual element or macro declarations, and specification groups together to form a unified schema.

The processing of the <schemaSpec> element must resolve any conflicts amongst the declarations it either contains or refers to. Different ODD processors may generate schemas and documentation using different concrete syntaxes.

The source may be specified (on the source attribute) in the form of a private URI, for which the recommended format is tei:x.y.z, where x.y.z indicates the version number, e.g. tei:1.5.1 for 1.5.1 release of TEI P5 or (as a special case) tei:current for whatever is the latest release. The source indicated must provide a set of TEI-conformant specifications in a form directly usable by an ODD processor. By default, this will be the location of the current release of the TEI Guidelines.
Example
<schemaSpec prefix="TEI_" ident="testsvg"  start="TEI svg">  <moduleRef source="tei:current"   key="header"/>  <moduleRef key="core"/>  <moduleRef key="drama"/>  <moduleRef url="svg11.rng"/> </schemaSpec>
This schema combines elements from the current versions of the drama and core modules, the current release version of the header module, and elements from an existing RELAX NG schema available from the URL indicated.
Example
<schemaSpec ident="Bare-plus"  source="tei_bare.compiled.odd" start="TEI">  <moduleRef key="tei"/>  <moduleRef key="header"/>  <elementRef key="q" source="tei:3.0.0"/>  <moduleRef key="textstructure"/> </schemaSpec>
This schema starts with a pre-existing customization of the TEI called TEI Bare (a customization with a minimal selection of elements). The <q> element is not available in TEI Bare, but it can be brought back. In this case, we will get the version defined in TEI P5 release 3.0.0
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.oddRef"/>
   <classRef key="model.oddDecl"/>
   <elementRef key="listRef"/>
  </alternate>
 </sequence>
</content>
    ⚓
Schema Declaration 
element schemaSpec
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.identified.attribute.ident,
   att.deprecated.attribute.validUntil,
   att.namespaceable.attributes,
   attribute start { list { + } }?,
   attribute docLang { list { + } }?,
   (
      ( model.glossLike | model.descLike )*,
      ( model.oddRef | model.oddDecl | listRef )*
   )
}⚓

2.1.88. <segmentation>

<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. The Editorial Practices Declaration 15.3.2. Declarable Elements]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.editorialDeclPart
Contained by
header: editorialDecl
May contain
core: p
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>
Content model 
<content>
 <classRef key="model.pLike" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element segmentation
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   model.pLike+
}⚓

2.1.89. <settingDesc>

<settingDesc> (setting description) describes the setting or settings within which a language interaction takes place, or other places otherwise referred to in a text, edition, or metadata. [15.2. Contextual Information 2.4. The Profile Description]
Module corpus
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Member of
model.profileDescPart
Contained by
header: profileDesc
May contain
namesdates: listPlace
Note

May contain a prose description organized as paragraphs, or a series of <setting> elements. If used to record not settings of language interactions, but other places mentioned in the text, then <place> optionally grouped by <listPlace> inside <standOff> should be preferred.
Example
<settingDesc>  <p>Texts recorded in the    Canadian Parliament building in Ottawa, between April and November 1988 </p> </settingDesc>
Content model 
<content>
 <elementRef key="listPlace"/>
</content>
    ⚓
Schema Declaration 
element settingDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   listPlace
}⚓

2.1.90. <settlement>

<settlement> (settlement) contains the name of a settlement such as a city, town, or village identified as a single geo-political or administrative unit. [13.2.3. Place Names]
Module namesdates
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
Member of
model.placeNamePart
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: msIdentifier repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<placeName>  <settlement type="town">Glasgow</settlement>  <region>Scotland</region> </placeName>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element settlement
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   macro.phraseSeq
}⚓

2.1.91. <sex>

<sex> (sex) Définit le sexe d'un individu [13.3.2.1. Personal Characteristics]
Module namesdates
Attributes att.editLike (@instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
value supplies a coded value for sex
Status Recommended
Datatype 1–∞ occurrences of teidata.sex separated by whitespace
Legal values are:
F
M
unknown
Note

Values for this attribute may be locally defined by a project, or may refer to an external standard, such as vCard's sex property http://microformats.org/wiki/gender-formats (in which M indicates male, F female, O other, N none or not applicable, U unknown), or the often used ISO 5218:2004 Representation of Human Sexes http://standards.iso.org/ittf/PubliclyAvailableStandards/c036266_ISO_IEC_5218_2004(E_F).zip (in which 0 indicates unknown; 1 male; 2 female; and 9 not applicable, although the ISO standard is widely considered inadequate); cf. CETH's Recommendations for Inclusive Data Collection of Trans People http://transhealth.ucsf.edu/trans?page=lib-data-collection.
Member of
model.persStateLike
Contained by
namesdates: person
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Note

As with other culturally-constructed traits such as age, the way in which this concept is described in different cultural contexts may vary. The normalizing attributes are provided only as an optional means of simplifying that variety to one or more external standards for purposes of interoperability, or project-internal taxonomies for consistency, and should not be used where that is inappropriate or unhelpful. The content of the element may be used to describe the intended concept in more detail, using plain text.

Example
<sex value="M">male</sex>
Example
<sex value="2">female</sex>
Example
<sex value="I">Intersex</sex>
Example
<sex value="TG F">Female (TransWoman)</sex>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element sex
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.editLike.attributes,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   attribute value { list { ( "F" | "M" | "unknown" )+ } }?,
   macro.phraseSeq
}⚓

2.1.92. <sic>

<sic> (Latin for thus or so) contains text reproduced although apparently incorrect or inaccurate. [3.5.1. Apparent Errors]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
model.pPart.transcriptional
Contained by
analysis: w
core: abbr add addrLine choice corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Example
for his nose was as sharp as a pen, and <sic>a Table</sic> of green fields.
Example If all that is desired is to call attention to the apparent problem in the copy text, <sic> may be used alone:
I don't know, Juan. It's so far in the past now — how <sic>we can</sic> prove or disprove anyone's theories?
Example It is also possible, using the <choice> and <corr> elements, to provide a corrected reading:
I don't know, Juan. It's so far in the past now — how <choice>  <sic>we can</sic>  <corr>can we</corr> </choice> prove or disprove anyone's theories?
Example
for his nose was as sharp as a pen, and <choice>  <sic>a Table</sic>  <corr>a' babbld</corr> </choice> of green fields.
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element sic { att.global.attributes, macro.paraContent }⚓

2.1.93. <sourceDesc>

<sourceDesc> (source description) describes the source(s) 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. The Source Description]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
default indicates whether or not this element is selected by default when its parent is selected.
Derived from att.declarable
Status Optional
Datatype teidata.truthValue
Legal values are:
false
[Default]
Contained by
header: fileDesc
May contain
core: list p
msdescription: msDesc
namesdates: listOrg listPerson listPlace listRelation
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>
Content model 
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.biblLike"/>
   <classRef key="model.sourceDescPart"/>
   <classRef key="model.listLike"/>
  </alternate>
 </alternate>
</content>
    ⚓
Schema Declaration 
element sourceDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute default { "false" }?,
   (
      model.pLike+
    | ( model.biblLike | model.sourceDescPart | model.listLike )+
   )
}⚓

2.1.94. <supportDesc>

<supportDesc> (support description) groups elements describing the physical support for the written part of a manuscript or other object. [10.7.1. Object Description]
Module msdescription
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
msdescription: objectDesc
May contain
header: extent
Example
<supportDesc>  <support> Parchment roll with <material>silk</material> ribbons.  </support> </supportDesc>
Content model 
<content>
 <elementRef key="extent" minOccurs="1"/>
</content>
    ⚓
Schema Declaration 
element supportDesc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   extent
}⚓

2.1.95. <surface>

<surface> defines a written surface as a two-dimensional coordinate space, optionally grouping one or more graphic representations of that space, zones of interest within that space, and transcriptions of the writing within them. [11.1. Digital Facsimiles 11.2.2. Embedded Transcription]
Module transcr
Attributes att.coordinated (@start, @ulx, @uly, @lrx, @lry, @points) att.declaring (@decls) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
enveloppe
recto
verso
appendix
Contained by
transcr: surface surfaceGrp
May contain
core: cb desc gap graphic lb note pb
transcr: surface surfaceGrp
Note

The <surface> element represents any two-dimensional space on some physical surface forming part of the source material, such as a piece of paper, a face of a monument, a billboard, a scroll, a leaf etc.

The coordinate space defined by this element may be thought of as a grid lrx - ulx units wide and uly - lry units high.

The <surface> element may contain graphic representations or transcriptions of written zones, or both. The coordinate values used by every <zone> element contained by this element are to be understood with reference to the same grid.

Where it is useful or meaningful to do so, any grouping of multiple <surface> elements may be indicated using the <surfaceGrp> element.
Example
<facsimile>  <surface ulx="0" uly="0" lrx="200" lry="300">   <graphic url="Bovelles-49r.png"/>  </surface> </facsimile>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.global"/>
   <classRef key="model.labelLike"/>
   <classRef key="model.graphicLike"/>
  </alternate>
  <sequence minOccurs="0"
   maxOccurs="unbounded">
   <alternate minOccurs="1" maxOccurs="1">
    <elementRef key="zone"/>
    <elementRef key="line"/>
    <elementRef key="path"/>
    <elementRef key="surface"/>
    <elementRef key="surfaceGrp"/>
   </alternate>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element surface
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.coordinated.attributes,
   att.declaring.attributes,
   attribute type { "enveloppe" | "recto" | "verso" | "appendix" }?,
   (
      ( model.global | model.labelLike | model.graphicLike )*,
      ( ( zone | line | path | surface | surfaceGrp ), model.global* )*
   )
}⚓

2.1.96. <surfaceGrp>

<surfaceGrp> defines any kind of useful grouping of written surfaces, for example the recto and verso of a single leaf, which the encoder wishes to treat as a single unit. [11.1. Digital Facsimiles]
Module transcr
Attributes att.declaring (@decls) att.global (n, @xml:id, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
n (number) gives a number (or other label) for an element, which is not necessarily unique within the document.
Derived from att.global
Status Optional
Datatype teidata.text
Legal values are:
1
type characterizes the element in some sense, using any convenient classification scheme or typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
letter
Contained by
transcr: facsimile surface
May contain
transcr: surface
Note

Where it is useful or meaningful to do so, any grouping of multiple <surface> elements may be indicated using the <surfaceGrp> elements.
Example
<sourceDoc>  <surfaceGrp>   <surface ulx="0" uly="0" lrx="200"    lry="300">    <graphic url="Bovelles-49r.png"/>   </surface>   <surface ulx="0" uly="0" lrx="200"    lry="300">    <graphic url="Bovelles-49v.png"/>   </surface>  </surfaceGrp> </sourceDoc>
Content model 
<content>
 <elementRef key="surface" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element surfaceGrp
{
   att.global.attribute.xmlid,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.declaring.attributes,
   attribute n { "1" }?,
   attribute type { "letter" }?,
   surface+
}⚓

2.1.97. <surname>

<surname> (Nom de famille) permet de relever le nom de famille d'une personne. [13.2.1. Personal Names]
Module namesdates
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
full indicates whether the name component is given in full, as an abbreviation or simply as an initial.
Derived from att.personal
Status Optional
Datatype teidata.enumerated
Legal values are:
yes
[Default]
ref (reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.
Derived from att.canonical
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Member of
model.persNamePart
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: correspAction edition extent language licence
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del expan gap graphic hi lb name note pb ref rs sic title unclear
header: idno
namesdates: country forename orgName persName placeName settlement surname
tagdocs: att gi val
character data
Example
<surname type="combine">St John Stevas</surname>
Content model 
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    ⚓
Schema Declaration 
element surname
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   attribute full { "yes" }?,
   attribute ref { list { + } }?,
   macro.phraseSeq
}⚓

2.1.98. <teiHeader>

<teiHeader> (TEI header) supplies descriptive and declarative metadata associated with a digital resource or set of resources. [2.1.1. The TEI Header and Its Components 15.1. Varieties of Composite Text]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
textstructure: TEI
May contain
header: encodingDesc fileDesc profileDesc
Note

One of the few elements unconditionally required in any TEI document.
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>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="fileDesc"/>
  <classRef key="model.teiHeaderPart"
   minOccurs="0" maxOccurs="unbounded"/>
  <elementRef key="revisionDesc"
   minOccurs="0"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element teiHeader
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( fileDesc, model.teiHeaderPart*, revisionDesc? )
}⚓

2.1.99. <text>

<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. Default Text Structure 15.1. Varieties of Composite Text]
Module textstructure
Attributes att.declaring (@decls) att.written (@hand) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Member of
model.resource
Contained by
textstructure: TEI
May contain
core: cb gap lb note pb
textstructure: back body front
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.
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> <!-- front matter for the whole group -->  </front>  <group>   <text> <!-- first text -->   </text>   <text> <!-- second text -->   </text>  </group> </text>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <classRef key="model.global"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0" maxOccurs="1">
   <elementRef key="front"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
  <alternate minOccurs="1" maxOccurs="1">
   <elementRef key="body"/>
   <elementRef key="group"/>
  </alternate>
  <classRef key="model.global"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0" maxOccurs="1">
   <elementRef key="back"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
    ⚓
Schema Declaration 
element text
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.declaring.attributes,
   att.written.attributes,
   (
      model.global*,
      ( front, model.global* )?,
      ( body | group ),
      model.global*,
      ( back, model.global* )?
   )
}⚓

2.1.100. <title>

<title> (title) contains a title for any kind of work. [3.12.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.5. The Series Statement]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) 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)
type classifies the title according to some convenient typology.
Derived from att.typed
Status Optional
Datatype teidata.enumerated
Legal values are:
short
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.
Member of
model.emphLike
Contained by
core: abbr add addrLine corr date del desc expan hi item name note p ref resp rs sic title unclear
header: edition extent language licence titleStmt
msdescription: repository
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
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.
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>
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element title
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datable.iso.attribute.when-iso,
   att.datable.iso.attribute.notBefore-iso,
   att.datable.iso.attribute.notAfter-iso,
   att.datable.iso.attribute.from-iso,
   att.datable.iso.attribute.to-iso,
   att.datable.custom.attribute.when-custom,
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.datable.custom.attribute.from-custom,
   att.datable.custom.attribute.to-custom,
   att.datable.custom.attribute.datingPoint,
   att.datable.custom.attribute.datingMethod,
   attribute type { "short" }?,
   macro.paraContent
}⚓

2.1.101. <titleStmt>

<titleStmt> (title statement) groups information about the title of a work and those responsible for its content. [2.2.1. The Title Statement 2.2. The File Description]
Module header
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
Contained by
header: fileDesc
May contain
core: respStmt title
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>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="title" minOccurs="1"
   maxOccurs="unbounded"/>
  <classRef key="model.respLike"
   minOccurs="0" maxOccurs="unbounded"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element titleStmt
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   ( title+, model.respLike* )
}⚓

2.1.102. <unclear>

<unclear> (unclear) contains a word, phrase, or passage which cannot be transcribed with certainty because it is illegible or inaudible in the source. [11.3.3.1. Damage, Illegibility, and Supplied Text 3.5.3. Additions, Deletions, and Omissions]
Module core
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@instant) att.dimensions (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
reason indicates why the material is hard to transcribe.
Status Optional
Datatype 1–∞ occurrences of teidata.enumerated separated by whitespace
Suggested values include:
illegible
(illegible)
inaudible
(inaudible)
faded
(faded)
background_noise
(background_noise)
eccentric_ductus
(eccentric_ductus) indicates illegibility due to an unusual, awkward, or incompetent execution of a glyph or glyphs
<div>  <head>Rx</head>  <p>500 mg <unclear reason="illegible">placebo</unclear>  </p> </div>
Note

One or more words may be used to describe the reason; usually each word will refer to a single cause.
agent Where the difficulty in transcription arises from damage, categorizes the cause of the damage, if it can be identified.
Status Optional
Datatype teidata.enumerated
Sample values include:
rubbing
damage results from rubbing of the leaf edges
mildew
damage results from mildew on the leaf surface
smoke
damage results from smoke
Member of
model.pPart.transcriptional
Contained by
analysis: w
core: abbr add addrLine choice corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add address cb choice corr date del desc expan gap graphic hi lb list name note pb ref rs sic title unclear
header: idno
msdescription: msDesc
namesdates: country forename listOrg listPerson listPlace listRelation orgName persName placeName settlement surname
tagdocs: att classSpec elementSpec gi val
character data
Note

The same element is used for all cases of uncertainty in the transcription of element content, whether for written or spoken material. For other aspects of certainty, uncertainty, and reliability of tagging and transcription, see chapter 21. Certainty, Precision, and Responsibility.

The <damage>, <gap>, <del>, <unclear> and <supplied> elements may be closely allied in use. See section 11.3.3.2. Use of the gap, del, damage, unclear, and supplied Elements in Combination for discussion of which element is appropriate for which circumstance.

The hand attribute points to a definition of the hand concerned, as further discussed in section 11.3.2.1. Document Hands.
Example
<u> ...and then <unclear reason="background-noise">Nathalie</unclear> said ... </u>
Content model 
<content>
 <macroRef key="macro.paraContent"/>
</content>
    ⚓
Schema Declaration 
element unclear
{
   att.global.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   attribute reason
   {
      list
      {
         (
            "illegible"
          | "inaudible"
          | "faded"
          | "background_noise"
          | "eccentric_ductus"
         )+
      }
   }?,
   attribute agent { text }?,
   macro.paraContent
}⚓

2.1.104. <valItem>

<valItem> documents a single value in a predefined list of values. [22.5.3. Attribute List Specification]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.deprecated (@validUntil)
ident specifies the value concerned.
Status Required
Datatype teidata.text
Contained by
tagdocs: valList
May contain
core: desc
Example
<valItem ident="dub">  <altIdent xml:lang="fr">dou</altIdent>  <equiv name="unknown"/>  <gloss>dubious</gloss>  <desc>used when the application of this element is doubtful or uncertain</desc> </valItem>
Example The <remarks> element is only allowed within <valItem> if the <desc> element is also present:
<valList type="closed">  <valItem ident="border">   <desc>used to signify that there is border around a page.</desc>  </valItem>  <valItem ident="border-rule">   <desc>used to signify that there is a border made of ruled lines.</desc>  </valItem>  <valItem ident="border-ornamental">   <desc>used to signify that there is an ornamental border.</desc>  </valItem>  <valItem ident="catch">   <gloss>catchword</gloss>   <desc>for catch words.</desc>  </valItem>  <valItem ident="lineNum">   <gloss>line number</gloss>   <desc>for printed line numbers (usually in poetry).</desc>  </valItem>  <valItem ident="listHead">   <gloss>list heading</gloss>   <desc>for headings of lists or similar constructs; often used in tables of contents for the   <q>page</q> heading.</desc>  </valItem>  <valItem ident="pageNum">   <gloss>page number</gloss>   <desc>for page numbers.</desc>  </valItem>  <valItem ident="pressFig">   <gloss>press figure</gloss>   <desc>for press figures. These are usually numbers, but are not sequential or regularly      printed like signatures.</desc>  </valItem>  <valItem ident="sig">   <gloss>signature</gloss>   <desc>for printed signatures.</desc>  </valItem>  <valItem ident="unknown">   <desc>for a metawork whose function you do not know.</desc>  </valItem>  <valItem ident="vol">   <gloss>volume number</gloss>   <desc>for printed volume numbers.</desc>  </valItem>  <valItem ident="other">   <desc>anything not covered by the above values.</desc>   <remarks>    <p>Used for an ornament, decorated tool line, or symbol(s) that is not officially a        delimiter (and thus there is no element on which to put <val>pre()</val> or    <val>post()</val>) but is used to fill space at the bottom of a page so that a    <gi>floatingText</gi> or similar can start at the top of the next.</p>   </remarks>  </valItem> </valList>
Content model 
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <classRef key="model.glossLike"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0" maxOccurs="1">
   <classRef key="model.descLike"
    minOccurs="1" maxOccurs="unbounded"/>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.glossLike"
     minOccurs="1" maxOccurs="1"/>
    <classRef key="model.descLike"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
   <elementRef key="remarks" minOccurs="0"
    maxOccurs="unbounded"/>
  </sequence>
  <elementRef key="paramList" minOccurs="0"
   maxOccurs="1"/>
 </sequence>
</content>
    ⚓
Schema Declaration 
element valItem
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.deprecated.attribute.validUntil,
   attribute ident { text },
   (
      model.glossLike*,
      ( model.descLike+, ( model.glossLike, model.descLike* )*, remarks* )?,
      paramList?
   )
}⚓

2.1.105. <valList>

<valList> (value list) contains one or more <valItem> elements defining possible values. [22.5.3. Attribute List Specification]
Module tagdocs
Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.deprecated (@validUntil)
mode specifies the effect of this declaration on its parent object.
Derived from att.combinable
Status Optional
Datatype teidata.enumerated
Legal values are:
add
[Default]
type specifies the extensibility of the list of values specified.
Status Optional
Datatype teidata.enumerated
Legal values are:
closed
Contained by
tagdocs: attDef elementSpec
May contain
tagdocs: valItem
Example
<valList type="closed">  <valItem ident="req">   <gloss>required</gloss>  </valItem>  <valItem ident="rec">   <gloss>recommended</gloss>  </valItem>  <valItem ident="opt">   <gloss>optional</gloss>  </valItem> </valList>
Content model 
<content>
 <elementRef key="valItem" minOccurs="0"
  maxOccurs="unbounded"/>
</content>
    ⚓
Schema Declaration 
element valList
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.deprecated.attribute.validUntil,
   attribute mode { "add" }?,
   attribute type { "closed" }?,
   valItem*
}⚓

2.1.106. <w>

<w> (word) represents a grammatical (not necessarily orthographic) word. [17.1. Linguistic Segment Categories 17.4.2. Lightweight Linguistic Annotation]
Module analysis
Attributes att.notated (@notation) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.datcat (@datcat, @valueDatcat) att.linguistic (pos, @lemma, @lemmaRef, @msd, @join) att.lexicographic.normalized (@norm, @orig)
part specifies whether or not its parent element is fragmented in some way, typically by some other overlapping structure: for example a speech which is divided between two or more verse stanzas, a paragraph which is split across a page division, a verse line which is divided between two speakers.
Derived from att.fragmentable
Status Optional
Datatype teidata.enumerated
Legal values are:
N
[Default]
pos (part of speech) indicates the part of speech assigned to a token (i.e. information on whether it is a noun, adjective, or verb), usually according to some official reference vocabulary (e.g. for German: STTS, for English: CLAWS, for Polish: NKJP, etc.).
Derived from att.linguistic
Status Optional
Datatype teidata.text
Member of
model.segLike
Contained by
analysis: w
core: abbr add addrLine choice corr date del expan hi item name note p ref rs sic title unclear
header: edition extent licence
namesdates: country forename occupation orgName persName placeName settlement sex surname
May contain
analysis: w
core: abbr add cb choice corr del expan gap hi lb note pb sic unclear
character data
Example This example is adapted from the Folger Library’s Early Modern English Drama version of The Wits: a Comedy by William Davenant.
<l>  <w lemma="it" pos="pn"   xml:id="A19883-003-a-0100">IT</w>  <w lemma="have" pos="vvz"   xml:id="A19883-003-a-0110">hath</w>  <w lemma="be" pos="vvn"   xml:id="A19883-003-a-0120">been</w>  <w lemma="say" pos="vvn"   xml:id="A19883-003-a-0130">said</w>  <w lemma="of" pos="acp-p"   xml:id="A19883-003-a-0140">of</w>  <w lemma="old" pos="j"   xml:id="A19883-003-a-0150">old</w>  <pc xml:id="A19883-003-a-0160">,</pc>  <w lemma="that" pos="cs"   xml:id="A19883-003-a-0170">that</w>  <w lemma="play" pos="vvz"   xml:id="A19883-003-a-0180">   <choice>    <orig>Playes</orig>    <reg>Plays</reg>   </choice>  </w>  <w lemma="be" pos="vvb"   xml:id="A19883-003-a-0190">are</w>  <w lemma="feast" pos="n2"   xml:id="A19883-003-a-0200">Feasts</w>  <pc xml:id="A19883-003-a-0210">,</pc> </l> <l xml:id="A19883-e100220">  <w lemma="poet" pos="n2"   xml:id="A19883-003-a-0220">Poets</w>  <w lemma="the" pos="d"   xml:id="A19883-003-a-0230">the</w>  <w lemma="cook" pos="n2"   xml:id="A19883-003-a-0240">   <choice>    <orig>Cookes</orig>    <reg>Cooks</reg>   </choice>  </w>  <pc xml:id="A19883-003-a-0250">,</pc>  <w lemma="and" pos="cc"   xml:id="A19883-003-a-0260">and</w>  <w lemma="the" pos="d"   xml:id="A19883-003-a-0270">the</w>  <w lemma="spectator" pos="n2"   xml:id="A19883-003-a-0280">Spectators</w>  <w lemma="guest" pos="n2"   xml:id="A19883-003-a-0290">Guests</w>  <pc xml:id="A19883-003-a-0300">,</pc> </l> <l xml:id="A19883-e100230">  <w lemma="the" pos="d"   xml:id="A19883-003-a-0310">The</w>  <w lemma="actor" pos="n2"   xml:id="A19883-003-a-0320">Actors</w>  <w lemma="waiter" pos="n2"   xml:id="A19883-003-a-0330">Waiters</w>  <pc xml:id="A19883-003-a-0340">:</pc> <!-- ... --> </l>
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <elementRef key="seg"/>
  <elementRef key="w"/>
  <elementRef key="m"/>
  <elementRef key="c"/>
  <elementRef key="pc"/>
  <classRef key="model.global"/>
  <classRef key="model.lPart"/>
  <classRef key="model.hiLike"/>
  <classRef key="model.pPart.edit"/>
 </alternate>
</content>
    ⚓
Schema Declaration 
element w
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.rendition.attribute.style,
   att.global.rendition.attribute.rendition,
   att.global.analytic.attribute.ana,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.datcat.attribute.datcat,
   att.datcat.attribute.valueDatcat,
   att.linguistic.attribute.lemma,
   att.linguistic.attribute.lemmaRef,
   att.linguistic.attribute.msd,
   att.linguistic.attribute.join,
   att.lexicographic.normalized.attribute.norm,
   att.lexicographic.normalized.attribute.orig,
   att.notated.attributes,
   attribute part { "N" }?,
   attribute pos { text }?,
   (
      text
    | model.gLike
    | seg
    | w
    | m
    | c
    | pc
    | model.global
    | model.lPart
    | model.hiLike
    | model.pPart.edit
   )*
}⚓

2.2. Model classes

2.2.1. model.addressLike

model.addressLike groups elements used to represent a postal or email address. [1. The TEI Infrastructure]
Module tei
Used by
model.correspActionPart model.pPart.data
Members address

2.2.2. model.attributable

model.attributable groups elements that contain a word or phrase that can be attributed to a source. [3.3.3. Quotation 4.3.2. Floating Texts]
Module tei
Used by
macro.phraseSeq model.inter
Members model.quoteLike

2.2.3. model.availabilityPart

model.availabilityPart groups elements such as licences and paragraphs of text which may appear as part of an availability statement [2.2.4. Publication, Distribution, Licensing, etc.]
Module tei
Used by
availability
Members licence

2.2.4. model.biblLike

model.biblLike groups elements containing a bibliographic description. [3.12. Bibliographic Citations and References]
Module tei
Used by
model.inter model.personPart sourceDesc
Members msDesc

2.2.5. model.common

model.common groups common chunk- and inter-level elements. [1.3. The TEI Class System]
Module tei
Used by
body div div1 div2 div3 div4 div5
Members model.divPart[model.lLike model.pLike[p]] model.entryLike model.inter[model.attributable[model.quoteLike] model.biblLike[msDesc] model.egLike model.labelLike[desc] model.listLike[list listOrg listPerson listPlace listRelation] model.oddDecl[classSpec elementSpec] model.stageLike]
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.2.6. model.correspActionPart

model.correspActionPart groups elements which define the parts (usually names, dates and places) of one action related to the correspondence.
Module tei
Used by
correspAction
Members model.addressLike[address] model.dateLike[date] model.nameLike[model.nameLike.agent[name orgName persName] model.offsetLike model.persNamePart[forename surname] model.placeStateLike[model.placeNamePart[country placeName settlement]] idno rs] note

2.2.7. model.dateLike

model.dateLike groups elements containing temporal expressions. [3.6.4. Dates and Times 13.4. Dates]
Module tei
Used by
model.correspActionPart model.pPart.data
Members date

2.2.8. model.descLike

model.descLike groups elements which contain a description of their function.
Module tei
Used by
attDef classSpec elementSpec gap graphic schemaSpec valItem
Members desc

2.2.9. model.div1Like

model.div1Like groups top-level structural divisions.
Module tei
Used by
back body front
Members div1

2.2.10. model.div2Like

model.div2Like groups second-level structural divisions.
Module tei
Used by
div1
Members div2

2.2.11. model.div3Like

model.div3Like groups third-level structural divisions.
Module tei
Used by
div2
Members div3

2.2.12. model.div4Like

model.div4Like groups fourth-level structural divisions.
Module tei
Used by
div3
Members div4

2.2.13. model.div5Like

model.div5Like groups fifth-level structural divisions.
Module tei
Used by
div4
Members div5

2.2.14. model.divBottom

model.divBottom groups elements appearing at the end of a text division. [4.2. Elements Common to All Divisions]
Module tei
Used by
body div div1 div2 div3 div4 div5 front list
Members model.divBottomPart model.divWrapper

2.2.15. model.divLike

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

2.2.16. model.divPart

model.divPart groups paragraph-level elements appearing directly within divisions. [1.3. The TEI Class System]
Module tei
Used by
macro.specialPara model.common
Members model.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.2.17. model.divTop

model.divTop groups elements appearing at the beginning of a text division. [4.2. Elements Common to All Divisions]
Module tei
Used by
body div div1 div2 div3 div4 div5 list
Members model.divTopPart[model.headLike] model.divWrapper

2.2.18. model.divTopPart

model.divTopPart groups elements which can occur only at the beginning of a text division. [4.6. Title Pages]
Module tei
Used by
model.divTop
Members model.headLike

2.2.19. model.editorialDeclPart

model.editorialDeclPart groups elements which may be used inside <editorialDecl> and appear multiple times.
Module tei
Used by
editorialDecl
Members segmentation

2.2.20. model.emphLike

model.emphLike groups phrase-level elements which are typographically distinct and to which a specific function can be attributed. [3.3. Highlighting and Quotation]
Module tei
Used by
model.highlighted model.limitedPhrase
Members title

2.2.21. model.encodingDescPart

model.encodingDescPart groups elements which may be used inside <encodingDesc> and appear multiple times.
Module tei
Used by
encodingDesc
Members editorialDecl projectDesc schemaSpec

2.2.22. model.frontPart

model.frontPart groups elements which appear at the level of divisions within front or back matter. [7.1. Front and Back Matter ]
Module tei
Used by
back front
Members model.frontPart.drama schemaSpec

2.2.23. model.global

model.global groups elements which may appear at any point within a TEI text. [1.3. The TEI Class System]
Module tei
Used by
back body date div div1 div2 div3 div4 div5 front list macro.paraContent macro.phraseSeq macro.phraseSeq.limited macro.specialPara person surface text w
Members model.global.edit[gap] model.global.meta model.milestoneLike[cb lb pb] model.noteLike[note]

2.2.24. model.global.edit

model.global.edit groups globally available elements which perform a specifically editorial function. [1.3. The TEI Class System]
Module tei
Used by
model.global
Members gap

2.2.25. model.graphicLike

model.graphicLike groups elements containing images, formulae, and similar objects. [3.10. Graphics and Other Non-textual Components]
Module tei
Used by
model.phrase surface
Members graphic

2.2.26. model.hiLike

model.hiLike groups phrase-level elements which are typographically distinct but to which no specific function can be attributed. [3.3. Highlighting and Quotation]
Module tei
Used by
model.highlighted model.limitedPhrase w
Members hi

2.2.27. model.highlighted

model.highlighted groups phrase-level elements which are typographically distinct. [3.3. Highlighting and Quotation]
Module tei
Used by
model.phrase
Members model.emphLike[title] model.hiLike[hi]

2.2.28. model.inter

model.inter groups elements which can appear either within or between paragraph-like elements. [1.3. The TEI Class System]
Module tei
Used by
macro.limitedContent macro.paraContent macro.specialPara model.common
Members model.attributable[model.quoteLike] model.biblLike[msDesc] model.egLike model.labelLike[desc] model.listLike[list listOrg listPerson listPlace listRelation] model.oddDecl[classSpec elementSpec] model.stageLike

2.2.29. model.labelLike

model.labelLike groups elements used to gloss or explain other parts of a document.
Module tei
Used by
model.inter surface
Members desc

2.2.30. model.limitedPhrase

model.limitedPhrase groups phrase-level elements excluding those elements primarily intended for transcription of existing sources. [1.3. The TEI Class System]
Module tei
Used by
macro.limitedContent macro.phraseSeq.limited
Members model.emphLike[title] model.hiLike[hi] model.pPart.data[model.addressLike[address] model.dateLike[date] model.measureLike model.nameLike[model.nameLike.agent[name orgName persName] model.offsetLike model.persNamePart[forename surname] model.placeStateLike[model.placeNamePart[country placeName settlement]] idno rs]] model.pPart.editorial[abbr choice expan] model.pPart.msdesc model.phrase.xml[att gi val] model.ptrLike[ref]

2.2.31. model.listLike

model.listLike groups list-like elements. [3.8. Lists]
Module tei
Used by
back model.inter sourceDesc
Members list listOrg listPerson listPlace listRelation

2.2.32. model.milestoneLike

model.milestoneLike groups milestone-style elements used to represent reference systems. [1.3. The TEI Class System 3.11.3. Milestone Elements]
Module tei
Used by
model.global
Members cb lb pb

2.2.33. model.nameLike

model.nameLike groups elements which name or refer to a person, place, or organization.
Module tei
Used by
model.correspActionPart model.pPart.data
Members model.nameLike.agent[name orgName persName] model.offsetLike model.persNamePart[forename surname] model.placeStateLike[model.placeNamePart[country placeName settlement]] idno rs
Note

A superset of the naming elements that may appear in datelines, addresses, statements of responsibility, etc.

2.2.34. model.nameLike.agent

model.nameLike.agent groups elements which contain names of individuals or corporate bodies. [3.6. Names, Numbers, Dates, Abbreviations, and Addresses]
Module tei
Used by
model.nameLike
Members name orgName persName
Note

This class is used in the content model of elements which reference names of people or organizations.

2.2.35. model.noteLike

model.noteLike groups globally-available note-like elements. [3.9. Notes, Annotation, and Indexing]
Module tei
Used by
model.global
Members note

2.2.36. model.oddDecl

model.oddDecl groups elements which generate declarations in some markup language in ODD documents.
Module tei
Used by
model.inter schemaSpec
Members classSpec elementSpec

2.2.37. model.oddRef

model.oddRef groups elements which reference declarations in some markup language in ODD documents.
Module tei
Used by
schemaSpec
Members classRef moduleRef

2.2.38. model.pLike

model.pLike groups paragraph-like elements.
Module tei
Used by
availability back correspAction editionStmt editorialDecl encodingDesc front langUsage model.divPart msDesc particDesc person projectDesc publicationStmt segmentation sourceDesc
Members p

2.2.39. model.pPart.data

model.pPart.data groups phrase-level elements containing names, dates, numbers, measures, and similar data. [3.6. Names, Numbers, Dates, Abbreviations, and Addresses]
Module tei
Used by
model.limitedPhrase model.phrase
Members model.addressLike[address] model.dateLike[date] model.measureLike model.nameLike[model.nameLike.agent[name orgName persName] model.offsetLike model.persNamePart[forename surname] model.placeStateLike[model.placeNamePart[country placeName settlement]] idno rs]

2.2.40. model.pPart.edit

model.pPart.edit groups phrase-level elements for simple editorial correction and transcription. [3.5. Simple Editorial Changes]
Module tei
Used by
model.phrase w
Members model.pPart.editorial[abbr choice expan] model.pPart.transcriptional[add corr del sic unclear]

2.2.41. model.pPart.editorial

model.pPart.editorial groups phrase-level elements for simple editorial interventions that may be useful both in transcribing and in authoring. [3.5. Simple Editorial Changes]
Module tei
Used by
model.limitedPhrase model.pPart.edit
Members abbr choice expan

2.2.42. model.pPart.transcriptional

model.pPart.transcriptional groups phrase-level elements used for editorial transcription of pre-existing source materials. [3.5. Simple Editorial Changes]
Module tei
Used by
model.pPart.edit
Members add corr del sic unclear

2.2.43. model.persNamePart

model.persNamePart groups elements which form part of a personal name. [13.2.1. Personal Names]
Module namesdates
Used by
model.nameLike
Members forename surname

2.2.44. model.persStateLike

model.persStateLike groups elements describing changeable characteristics of a person which have a definite duration, for example occupation, residence, or name.
Module tei
Used by
model.personPart
Members occupation persName sex
Note

These characteristics of an individual are typically a consequence of their own action or that of others.

2.2.45. model.personLike

model.personLike groups elements which provide information about people and their relationships.
Module tei
Used by
particDesc
Members org person

2.2.46. model.personPart

model.personPart groups elements which form part of the description of a person. [15.2.2. The Participant Description]
Module tei
Used by
person
Members model.biblLike[msDesc] model.eventLike model.persStateLike[occupation persName sex] idno name

2.2.47. model.phrase

model.phrase groups elements which can occur at the level of individual words or phrases. [1.3. The TEI Class System]
Module tei
Used by
date macro.paraContent macro.phraseSeq macro.specialPara
Members model.graphicLike[graphic] model.highlighted[model.emphLike[title] model.hiLike[hi]] model.lPart model.pPart.data[model.addressLike[address] model.dateLike[date] model.measureLike model.nameLike[model.nameLike.agent[name orgName persName] model.offsetLike model.persNamePart[forename surname] model.placeStateLike[model.placeNamePart[country placeName settlement]] idno rs]] model.pPart.edit[model.pPart.editorial[abbr choice expan] model.pPart.transcriptional[add corr del sic unclear]] model.pPart.msdesc model.phrase.xml[att gi val] model.ptrLike[ref] model.ptrLike.form model.segLike[w] model.specDescLike
Note

This class of elements can occur within paragraphs, list items, lines of verse, etc.

2.2.48. model.phrase.xml

model.phrase.xml groups phrase-level elements used to encode XML constructs such as element names, attribute names, and attribute values [22. Documentation Elements]
Module tei
Used by
model.limitedPhrase model.phrase
Members att gi val

2.2.49. model.placeNamePart

model.placeNamePart groups elements which form part of a place name. [13.2.3. Place Names]
Module tei
Used by
model.placeStateLike
Members country placeName settlement

2.2.50. model.placeStateLike

model.placeStateLike groups elements which describe changing states of a place.
Module tei
Used by
model.nameLike
Members model.placeNamePart[country placeName settlement]

2.2.51. model.profileDescPart

model.profileDescPart groups elements which may be used inside <profileDesc> and appear multiple times.
Module tei
Used by
profileDesc
Members correspDesc langUsage particDesc settingDesc

2.2.52. model.ptrLike

model.ptrLike groups elements used for purposes of location and reference. [3.7. Simple Links and Cross-References]
Module tei
Used by
model.limitedPhrase model.phrase model.publicationStmtPart.detail
Members ref

2.2.53. model.publicationStmtPart.agency

model.publicationStmtPart.agency groups the child elements of a <publicationStmt> element of the TEI header that indicate an authorising agent. [2.2.4. Publication, Distribution, Licensing, etc.]
Module tei
Used by
publicationStmt
Members publisher
Note

The ‘agency’ child elements, while not required, are required if one of the ‘detail’ child elements is to be used. It is not valid to have a ‘detail’ child element without a preceding ‘agency’ child element.

See also model.publicationStmtPart.detail.

2.2.54. model.publicationStmtPart.detail

model.publicationStmtPart.detail groups the agency-specific child elements of the <publicationStmt> element of the TEI header. [2.2.4. Publication, Distribution, Licensing, etc.]
Module tei
Used by
publicationStmt
Members model.ptrLike[ref] address availability date idno pubPlace
Note

A ‘detail’ child element may not occur unless an ‘agency’ child element precedes it.

See also model.publicationStmtPart.agency.

2.2.55. model.resource

model.resource groups separate elements which constitute the content of a digital resource, as opposed to its metadata. [1.3. The TEI Class System]
Module tei
Used by
TEI
Members facsimile text

2.2.56. model.respLike

model.respLike groups elements which are used to indicate intellectual or other significant responsibility, for example within a bibliographic element.
Module tei
Used by
editionStmt titleStmt
Members respStmt

2.2.57. model.segLike

model.segLike groups elements used for arbitrary segmentation. [16.3. Blocks, Segments, and Anchors 17.1. Linguistic Segment Categories]
Module tei
Used by
model.phrase
Members w
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.2.58. model.teiHeaderPart

model.teiHeaderPart groups high level elements which may appear more than once in a TEI header.
Module tei
Used by
teiHeader
Members encodingDesc profileDesc

2.3. Attribute classes

2.3.1. att.anchoring

att.anchoring (anchoring) provides attributes for use on annotations, e.g. notes and groups of notes describing the existence and position of an anchor for annotations.
Module tei
Members note
Attributes
anchored (anchored) indicates whether the copy text shows the exact place of reference for the note.
Status Optional
Datatype teidata.truthValue
Default true
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.
targetEnd (target end) points 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 teidata.pointer separated by whitespace
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.6. range().
Example
<p>(...) tamen reuerendos dominos archiepiscopum et canonicos Leopolienses necnon episcopum in duplicibus Quatuortemporibus<anchor xml:id="A55234"/> totaliter expediui...</p> <!-- elsewhere in the document --> <noteGrp targetEnd="#A55234">  <note xml:lang="en"> Quatuor Tempora, so called dry fast days.  </note>  <note xml:lang="pl"> Quatuor Tempora, tzw. Suche dni postne.  </note> </noteGrp>

2.3.2. att.breaking

att.breaking provides attributes to indicate whether or not the element concerned is considered to mark the end of an orthographic token in the same way as whitespace. [3.11.3. Milestone Elements]
Module tei
Members cb lb pb
Attributes
break indicates 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 teidata.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
the encoding does not take any position on this issue.
In the following lines from the Dream of the Rood, linebreaks occur in the middle of the words lāðost and reord-berendum.
<ab> ...eƿesa tome iu icƿæs ȝeƿorden ƿita heardoſt . leodum la<lb break="no"/> ðost ærþan ichim lifes ƿeȝ rihtne ȝerymde reord be<lb break="no"/> rendum hƿæt me þaȝeƿeorðode ƿuldres ealdor ofer... </ab>

2.3.3. att.cReferencing

att.cReferencing provides attributes that may be used to supply a canonical reference as a means of identifying the target of a pointer.
Module tei
Members ref
Attributes
cRef (canonical reference) specifies the destination of the pointer by supplying a canonical reference expressed using the scheme defined in a <refsDecl> element in the TEI header
Status Optional
Datatype teidata.text
Note

The value of cRef should be constructed so that when the algorithm for the resolution of canonical references (described in section 16.2.5. Canonical References) is applied to it the result is a valid URI reference to the intended target.

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.

2.3.4. att.canonical

att.canonical provides attributes that can be used to associate a representation such as a name or title with canonical information about the object being named or referenced. [13.1.1. Linking Names and Their Referents]
Module tei
Members att.naming[att.personal[forename name orgName persName placeName surname] country occupation pubPlace repository rs settlement] correspDesc date publisher relation resp respStmt title
Attributes
ref (reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
<name ref="http://viaf.org/viaf/109557338"  type="person">Seamus Heaney</name>
Note

The value must point directly to one or more XML elements or other resources 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.

2.3.5. att.combinable

att.combinable provides attributes indicating how multiple references to the same object in a schema should be combined
Module tagdocs
Members att.identified[attDef classSpec elementSpec schemaSpec] valItem valList
Attributes att.deprecated (@validUntil)
mode specifies the effect of this declaration on its parent object.
Status Optional
Datatype teidata.enumerated
Legal values are:
add
this declaration is part of the current definitions.[Default]
delete
the object with the same identifier (and namespace in the case of an element or attribute) as the current one is no longer part of the current definitions
change
this declaration changes the object of the same identifier (and namespace in the case of an element or attribute) in the current definition
replace
this declaration replaces the object with the same identifier (and namespace in the case of an element or attribute) in the current definition.
Note

An ODD processor should handle the values for mode as follows:

add
the object should be created (processing any children in add mode); raise an error if the object has an identifier and an object with the same identifier (and namespace in the case of an element or attribute) already exists.
replace
use this object in preference to any existing object with the same identifier (and namespace in the case of an element or attribute), and ignore any children of that object; process any new children in replace mode
delete
do not process this object or any existing object with the same identifier (and namespace in the case of an element or attribute); the element carrying this attribute must be empty: raise an error if there are any children
change
process this object and its children, replacing only those components of an existing object of the same type with the same identifier (and namespace in case of an element or attribute) that are explicitly specified. This will change only those existing attribute values and child elements that appear both in the original specification and in the new specification. Other children from the original specification will be preserved.

2.3.6. att.coordinated

att.coordinated provides attributes that can be used to position their parent element within a two dimensional coordinate system.
Module transcr
Members surface
Attributes
start indicates the element within a transcription of the text containing at least the start of the writing represented by this zone or surface.
Status Optional
Datatype teidata.pointer
ulx gives the x coordinate value for the upper left corner of a rectangular space.
Status Optional
Datatype teidata.numeric
uly gives the y coordinate value for the upper left corner of a rectangular space.
Status Optional
Datatype teidata.numeric
lrx gives the x coordinate value for the lower right corner of a rectangular space.
Status Optional
Datatype teidata.numeric
lry gives the y coordinate value for the lower right corner of a rectangular space.
Status Optional
Datatype teidata.numeric
points identifies a two dimensional area by means of a series of pairs of numbers, each of which gives the x,y coordinates of a point on a line enclosing the area.
Status Optional
Datatype 3–∞ occurrences of teidata.point separated by whitespace

2.3.7. att.datable

att.datable provides attributes for normalization of elements that contain dates, times, or datable events. [3.6.4. Dates and Times 13.4. Dates]
Module tei
Members country date idno licence name occupation orgName persName placeName provenance relation resp settlement sex title
Attributes att.datable.w3c (@when) 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)
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.

2.3.8. 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). [13.4. Dates]
Module namesdates
Members att.datable[country date idno licence name occupation orgName persName placeName provenance relation resp settlement sex title]
Attributes
when-custom supplies the value of a date or time in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
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 at the <date when="2012-12-21"   when-custom="13.0.0.0.0">end of B'ak'tun 13</date>.</p> <p>The Battle of Meggidu (<date when-custom="Thutmose_III:23">23rd year of reign of Thutmose III</date>).</p> <p>Esidorus bixit in pace annos LXX plus minus sub <date when-custom="Ind:4-10-11">die XI mensis Octobris indictione IIII</date> </p>
Not all custom date formulations will have Gregorian equivalents.The when-custom attribute and other custom dating are not constrained to a datatype by the TEI, but individual projects are recommended to regularize and document their dating formats.
notBefore-custom specifies the earliest possible date for the event in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
notAfter-custom specifies the latest possible date for the event in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
from-custom indicates the starting point of the period in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
<event xml:id="FIRE1"  datingMethod="#julian"  from-custom="1666-09-02"  to-custom="1666-09-05">  <head>The Great Fire of London</head>  <p>The Great Fire of London burned through a large part    of the city of London.</p> </event>
to-custom indicates the ending point of the period in some custom standard form.
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
datingPoint supplies 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 teidata.pointer
datingMethod supplies a pointer to a <calendar> element or other means of interpreting the values of the custom dating attributes.
Status Optional
Datatype teidata.pointer
Contayning the Originall, Antiquity, Increaſe, Moderne eſtate, and deſcription of that Citie, written in the yeare <date when-custom="1598"  calendar="#julian"  datingMethod="#julian">1598</date>. by Iohn Stow Citizen of London.
In this example, the calendar attribute points to a <calendar> element for the Julian calendar, specifying that the text content of the <date> element is a Julian date, and the datingMethod attribute also points to the Julian calendar to indicate that the content of the when-custom attribute value is Julian too.
<date when="1382-06-28"  when-custom="6890-06-20"  datingMethod="#creationOfWorld"> μηνὶ Ἰουνίου εἰς <num>κ</num> ἔτους <num>ςωϞ</num> </date>
In this example, a date is given in a Mediaeval text measured "from the creation of the world", which is normalised (in when) to the Gregorian date, but is also normalized (in when-custom) to a machine-actionable, numeric version of the date from the Creation.
Note

Note that the datingMethod attribute (unlike calendar defined in att.datable) defines the calendar or dating system to which the date described by the parent element is normalized (i.e. in the when-custom or other X-custom attributes), not the calendar of the original date in the element.

2.3.9. att.datable.iso

att.datable.iso provides attributes for normalization of elements that contain datable events using the ISO 8601 standard. [3.6.4. Dates and Times 13.4. Dates]
Module namesdates
Members att.datable[country date idno licence name occupation orgName persName placeName provenance relation resp settlement sex title]
Attributes
when-iso supplies the value of a date or time in a standard form.
Status Optional
Datatype teidata.temporal.iso
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 Second Edition specification. The first occurence could not.
notBefore-iso specifies the earliest possible date for the event in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype teidata.temporal.iso
notAfter-iso specifies the latest possible date for the event in standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype teidata.temporal.iso
from-iso indicates the starting point of the period in standard form.
Status Optional
Datatype teidata.temporal.iso
to-iso indicates the ending point of the period in standard form.
Status Optional
Datatype teidata.temporal.iso
Note

The value of these attributes should be a 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.

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 when-iso="2007-06-01" dur-iso="P8D"/>
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.

2.3.10. att.datable.w3c

att.datable.w3c provides attributes for normalization of elements that contain datable events conforming to the W3C XML Schema Part 2: Datatypes Second Edition. [3.6.4. Dates and Times 13.4. Dates]
Module tei
Members att.datable[country date idno licence name occupation orgName persName placeName provenance relation resp settlement sex title]
Attributes
when supplies the value of the date or time in a standard form, e.g. yyyy-mm-dd.
Status Optional
Datatype teidata.temporal.w3c
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>
Schematron
<sch:rule context="tei:*[@when]"> <sch:report test="@notBefore|@notAfter|@from|@to"  role="nonfatal">The @when attribute cannot be used with any other att.datable.w3c attributes.</sch:report> </sch:rule>
Schematron
<sch:rule context="tei:*[@from]"> <sch:report test="@notBefore"  role="nonfatal">The @from and @notBefore attributes cannot be used together.</sch:report> </sch:rule>
Schematron
<sch:rule context="tei:*[@to]"> <sch:report test="@notAfter"  role="nonfatal">The @to and @notAfter attributes cannot be used together.</sch:report> </sch:rule>
Example
<date from="1863-05-28" to="1863-06-01">28 May through 1 June 1863</date>
Note

The value of these attributes should be a 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 portion of a temporal 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.

2.3.11. att.datcat

att.datcat provides attributes that are used to align XML elements or attributes with the appropriate Data Categories (DCs) defined by the ISO 12620:2009 standard and stored in the Web repository called ISOCat at http://www.isocat.org/. [9.5.2. Lexical View 18.3. Other Atomic Feature Values]
Module tei
Members att.segLike[w]
Attributes
datcat contains a PID (persistent identifier) that aligns the given element with the appropriate Data Category (or categories) in ISOcat.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
valueDatcat contains a PID (persistent identifier) that aligns the content of the given element or the value of the given attribute with the appropriate simple Data Category (or categories) in ISOcat.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Example In this example dcr:datcat relates the feature name to the data category "partOfSpeech" and dcr:valueDatcat the feature value to the data category "commonNoun". Both these data categories reside in the ISOcat DCR at www.isocat.org, which is the DCR used by ISO TC37 and hosted by its registration authority, the MPI for Psycholinguistics in Nijmegen.
<fs    xmlns:dcr="http://www.isocat.org/ns/dcr">  <f name="POS"   dcr:datcat="http://www.isocat.org/datcat/DC-1345" fVal="#commonNoun"   dcr:valueDatcat="http://www.isocat.org/datcat/DC-1256"/> </fs>
Note

ISO 12620:2009 is a standard describing the data model and procedures for a Data Category Registry (DCR). Data categories are defined as elementary descriptors in a linguistic structure. In the DCR data model each data category gets assigned a unique Peristent IDentifier (PID), i.e., an URI. Linguistic resources or preferably their schemas that make use of data categories from a DCR should refer to them using this PID. For XML-based resources, like TEI documents, ISO 12620:2009 normative Annex A gives a small Data Category Reference XML vocabulary (also available online at http://www.isocat.org/12620/), which provides two attributes, dcr:datcat and dcr:valueDatcat.

2.3.12. 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. [15.3. Associating Contextual Information with a Text]
Module tei
Members back body div div1 div2 div3 div4 div5 facsimile front graphic msDesc p ref surface surfaceGrp text
Attributes
decls identifies 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 teidata.pointer separated by whitespace
Note

The rules governing the association of declarable elements with individual parts of a TEI text are fully defined in chapter 15.3. Associating Contextual Information with a Text.

2.3.13. att.deprecated

att.deprecated provides attributes indicating how a deprecated feature will be treated in future releases.
Module tagdocs
Members att.combinable[att.identified[attDef classSpec elementSpec schemaSpec] valItem valList]
Attributes
validUntil provides a date before which the construct being defined will not be removed.
Status Optional
Datatype date
Schematron
<sch:rule context="tei:*[@validUntil]"> <sch:let name="advance_warning_period"  value="current-date() + xs:dayTimeDuration('P60D')"/> <sch:let name="me_phrase"  value="if (@ident) then concat('The ', @ident ) else concat('This ', local-name(.), ' of ', ancestor::tei:*[@ident][1]/@ident )"/> <sch:assert test="@validUntil cast as xs:date ge current-date()">  <sch:value-of select=" concat( $me_phrase, ' construct is outdated (as of ', @validUntil, '); ODD processors may ignore it, and its use is no longer supported' )"/> </sch:assert> <sch:assert role="nonfatal"  test="@validUntil cast as xs:date ge $advance_warning_period">  <sch:value-of select="concat( $me_phrase, ' construct becomes outdated on ', @validUntil )"/> </sch:assert> </sch:rule>
Schematron
<sch:rule context="tei:*[@validUntil][ not( self::valDesc | self::valList | self::defaultVal )]"> <sch:assert test="child::tei:desc[ @type eq 'deprecationInfo']"> A deprecated construct should include, whenever possible, an explanation, but this <sch:value-of select="name(.)"/> does not have a child <desc type="deprecationInfo"></sch:assert> </sch:rule>
Note

The value of this attribute should represent a date (in standard yyyy-mm-dd format) which is later than the date on which the attribute is added to an ODD. Technically, this attribute asserts only the intent to leave a construct in future releases of the markup language being defined up to at least the specified date, and makes no assertion about what happens past that date. In practice, the expectation is that the construct will be removed from future releases of the markup language being defined sometime shortly after the validUntil date.

An ODD processor will typically not process a specification element which has a validUntil date that is in the past. An ODD processor will typically warn users about constructs which have a validUntil date that is in the future. E.g., the documentation for such a construct might include the phrase warning: deprecated in red.

2.3.14. att.dimensions

att.dimensions provides attributes for describing the size of physical objects.
Module tei
Members add date del gap unclear
Attributes att.ranging (@atLeast, @atMost, @min, @max, @confidence)

2.3.15. att.divLike

att.divLike provides attributes common to all elements which behave in the same way as divisions. [4. Default Text Structure]
Module tei
Members div div1 div2 div3 div4 div5
Attributes att.fragmentable (@part)

2.3.16. att.editLike

att.editLike provides attributes describing the nature of an encoded scholarly intervention or interpretation of any kind. [3.5. Simple Editorial Changes 10.3.1. Origination 13.3.2. The Person Element 11.3.1.1. Core Elements for Transcriptional Work]
Module tei
Members att.transcriptional[add del] corr date expan gap name occupation org orgName persName person place placeName relation sex unclear
Attributes
instant indicates whether this is an instant revision or not.
Status Optional
Datatype teidata.xTruthValue
Default false
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.

Each pointer on the source (if present) corresponding to a witness or witness group should reference a bibliographic citation such as a <witness>, <msDesc>, or <bibl> element, or another external bibliographic citation, documenting the source concerned.

2.3.17. att.edition

att.edition provides attributes identifying the source edition from which some encoded feature derives.
Module tei
Members cb lb pb
Attributes
ed (edition) supplies a sigil or other 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 teidata.word separated by whitespace
edRef (edition reference) provides a pointer to 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 teidata.pointer separated by whitespace
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>
Example
<listBibl>  <bibl xml:id="stapledon1937">   <author>Olaf Stapledon</author>,  <title>Starmaker</title>, <publisher>Methuen</publisher>, <date>1937</date>  </bibl>  <bibl xml:id="stapledon1968">   <author>Olaf Stapledon</author>,  <title>Starmaker</title>, <publisher>Dover</publisher>, <date>1968</date>  </bibl> </listBibl> <!-- ... --> <p>Looking into the future aeons from the supreme moment of the cosmos, I saw the populations still with all their strength maintaining the<pb n="411" edRef="#stapledon1968"/>essentials of their ancient culture, still living their personal lives in zest and endless novelty of action, … I saw myself still preserving, though with increasing difficulty, my lucid con-<pb n="291" edRef="#stapledon1937"/>sciousness;</p>

2.3.18. att.fragmentable

att.fragmentable provides attributes for representing fragmentation of a structural element, typically as a consequence of some overlapping hierarchy.
Module tei
Members att.divLike[div div1 div2 div3 div4 div5] att.segLike[w] p
Attributes
part specifies whether or not its parent element is fragmented in some way, typically by some other overlapping structure: for example a speech which is divided between two or more verse stanzas, a paragraph which is split across a page division, a verse line which is divided between two speakers.
Status Optional
Datatype teidata.enumerated
Legal values are:
Y
(yes) the element is fragmented in some (unspecified) respect
N
(no) the element is not fragmented, or no claim is made as to its completeness[Default]
I
(initial) this is the initial part of a fragmented element
M
(medial) this is a medial part of a fragmented element
F
(final) this is the final part of a fragmented element
Note

The values I, M, or F should be used only where it is clear how the element may be reconstituted.

2.3.19. att.global

att.global provides attributes common to all elements in the TEI encoding scheme. [1.3.1.1. Global Attributes]
Module tei
Members TEI abbr add addrLine address att attDef attList availability back body cb choice classRef classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 edition editionStmt editorialDecl elementSpec encodingDesc expan extent facsimile fileDesc forename front gap gi graphic handDesc handNote hi history idno item langUsage language lb licence list listOrg listPerson listPlace listRelation moduleRef msDesc msIdentifier name note objectDesc occupation org orgName p particDesc pb persName person physDesc place placeName profileDesc projectDesc provenance pubPlace publicationStmt publisher ref relation repository resp respStmt rs schemaSpec segmentation settingDesc settlement sex sic sourceDesc supportDesc surface surfaceGrp surname teiHeader text title titleStmt unclear val valItem valList w
Attributes att.global.rendition (@rend, @style, @rendition) att.global.analytic (@ana) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:id (identifier) provides a unique identifier for the element bearing the attribute.
Status Optional
Datatype ID
Note

The xml:id attribute may be used to specify a canonical reference for an element; see section 3.11. Reference Systems.
n (number) gives a number (or other label) for an element, which is not necessarily unique within the document.
Status Optional
Datatype teidata.text
Note

The value of this attribute is always understood to be a single token, even if it contains space or other punctuation characters, and need not be composed of numbers only. It is typically 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 teidata.language
<p> … The consequences of this rapid depopulation were the loss of the last <foreign xml:lang="rap">ariki</foreign> or chief (Routledge 1920:205,210) and their connections to ancestral territorial organization.</p>
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.

Only attributes with free text values (rare in these guidelines) will be in the scope of xml:lang.

The authoritative list of registered language subtags is maintained by IANA and is available at http://www.iana.org/assignments/language-subtag-registry. For a good general overview of the construction of language tags, see https://www.w3.org/International/articles/language-tags/, and for a practical step-by-step guide, see https://www.w3.org/International/questions/qa-choosing-language-tags.en.php.

The value used must conform with BCP 47. If the value is a private use code (i.e., starts with x- or contains -x-), a <language> element with a matching value for its ident attribute should be supplied in the TEI header to document this value. Such documentation may also optionally be supplied for non-private-use codes, though these must remain consistent with their (IETF)Internet Engineering Task Force definitions.
xml:base provides a base URI reference with which applications can resolve relative URI references into absolute URI references.
Status Optional
Datatype teidata.pointer
<div type="bibl">  <head>Bibliography</head>  <listBibl xml:base="http://www.lib.ucdavis.edu/BWRP/Works/">   <bibl>    <author>     <name>Landon, Letitia Elizabeth</name>    </author>    <ref target="LandLVowOf.sgm">     <title>The Vow of the Peacock</title>    </ref>   </bibl>   <bibl>    <author>     <name>Compton, Margaret Clephane</name>    </author>    <ref target="NortMIrene.sgm">     <title>Irene, a Poem in Six Cantos</title>    </ref>   </bibl>   <bibl>    <author>     <name>Taylor, Jane</name>    </author>    <ref target="TaylJEssay.sgm">     <title>Essays in Rhyme on Morals and Manners</title>    </ref>   </bibl>  </listBibl> </div>
xml:space signals an intention about how white space should be managed by applications.
Status Optional
Datatype teidata.enumerated
Legal values are:
default
signals that the application's default white-space processing modes are acceptable
preserve
indicates the intent that applications preserve all white space
Note

The XML specification provides further guidance on the use of this attribute. Note that many parsers may not handle xml:space correctly.

2.3.20. att.global.analytic

att.global.analytic provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text. [17.2. Global Attributes for Simple Analyses 17.3. Spans and Interpretations]
Module analysis
Members att.global[TEI abbr add addrLine address att attDef attList availability back body cb choice classRef classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 edition editionStmt editorialDecl elementSpec encodingDesc expan extent facsimile fileDesc forename front gap gi graphic handDesc handNote hi history idno item langUsage language lb licence list listOrg listPerson listPlace listRelation moduleRef msDesc msIdentifier name note objectDesc occupation org orgName p particDesc pb persName person physDesc place placeName profileDesc projectDesc provenance pubPlace publicationStmt publisher ref relation repository resp respStmt rs schemaSpec segmentation settingDesc settlement sex sic sourceDesc supportDesc surface surfaceGrp surname teiHeader text title titleStmt unclear val valItem valList w]
Attributes
ana (analysis) indicates one or more elements containing interpretations of the element on which the ana attribute appears.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
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.

2.3.21. att.global.change

att.global.change provides attributes allowing its member elements to specify one or more states or revision campaigns with which they are associated.
Module transcr
Members att.global[TEI abbr add addrLine address att attDef attList availability back body cb choice classRef classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 edition editionStmt editorialDecl elementSpec encodingDesc expan extent facsimile fileDesc forename front gap gi graphic handDesc handNote hi history idno item langUsage language lb licence list listOrg listPerson listPlace listRelation moduleRef msDesc msIdentifier name note objectDesc occupation org orgName p particDesc pb persName person physDesc place placeName profileDesc projectDesc provenance pubPlace publicationStmt publisher ref relation repository resp respStmt rs schemaSpec segmentation settingDesc settlement sex sic sourceDesc supportDesc surface surfaceGrp surname teiHeader text title titleStmt unclear val valItem valList w]
Attributes
change points to one or more <change> elements documenting a state or revision campaign to which the element bearing this attribute and its children have been assigned by the encoder.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace

2.3.23. att.global.rendition

att.global.rendition provides rendering attributes common to all elements in the TEI encoding scheme. [1.3.1.1.3. Rendition Indicators]
Module tei
Members att.global[TEI abbr add addrLine address att attDef attList availability back body cb choice classRef classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 edition editionStmt editorialDecl elementSpec encodingDesc expan extent facsimile fileDesc forename front gap gi graphic handDesc handNote hi history idno item langUsage language lb licence list listOrg listPerson listPlace listRelation moduleRef msDesc msIdentifier name note objectDesc occupation org orgName p particDesc pb persName person physDesc place placeName profileDesc projectDesc provenance pubPlace publicationStmt publisher ref relation repository resp respStmt rs schemaSpec segmentation settingDesc settlement sex sic sourceDesc supportDesc surface surfaceGrp surname teiHeader text title titleStmt unclear val valItem valList w]
Attributes
rend (rendition) indicates how the element in question was rendered or presented in the source text.
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
<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. The values of the rend attribute are a set of sequence-indeterminate individual tokens separated by whitespace.
style contains an expression in some formal style definition language which defines the rendering or presentation used for this element in the source text
Status Optional
Datatype teidata.text
<head style="text-align: center; font-variant: small-caps">  <lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her <lb/>  <hi style="font-variant: normal">New Blazing-World</hi>. </head>
Note

Unlike the attribute values of rend, which uses whitespace as a separator, the style attribute may contain whitespace. This attribute is intended for recording inline stylistic information concerning the source, not any particular output.

The formal language in which values for this attribute are expressed may be specified using the <styleDefDecl> element in the TEI header.

If style and rendition are both present on an element, then style overrides or complements rendition. style should not be used in conjunction with rend, because the latter does not employ a formal style definition language.
rendition points to a description of the rendering or presentation used for this element in the source text.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
<head rendition="#ac #sc">  <lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her <lb/>  <hi rendition="#normal">New Blazing-World</hi>. </head> <!-- elsewhere... --> <rendition xml:id="sc"  scheme="css">font-variant: small-caps</rendition> <rendition xml:id="normal"  scheme="css">font-variant: normal</rendition> <rendition xml:id="ac"  scheme="css">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.

If rendition is used to refer to a style definition in a formal language like CSS, it is recommended that it not be used in conjunction with rend. 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.

2.3.24. att.global.responsibility

att.global.responsibility provides attributes indicating the agent responsible for some aspect of the text, the markup or something asserted by the markup, and the degree of certainty associated with it. [1.3.1.1.4. Sources, certainty, and responsibility 3.5. Simple Editorial Changes 11.3.2.2. Hand, Responsibility, and Certainty Attributes 17.3. Spans and Interpretations 13.1.1. Linking Names and Their Referents]
Module tei
Members att.global[TEI abbr add addrLine address att attDef attList availability back body cb choice classRef classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 edition editionStmt editorialDecl elementSpec encodingDesc expan extent facsimile fileDesc forename front gap gi graphic handDesc handNote hi history idno item langUsage language lb licence list listOrg listPerson listPlace listRelation moduleRef msDesc msIdentifier name note objectDesc occupation org orgName p particDesc pb persName person physDesc place placeName profileDesc projectDesc provenance pubPlace publicationStmt publisher ref relation repository resp respStmt rs schemaSpec segmentation settingDesc settlement sex sic sourceDesc supportDesc surface surfaceGrp surname teiHeader text title titleStmt unclear val valItem valList w]
Attributes
cert (certainty) signifies the degree of certainty associated with the intervention or interpretation.
Status Optional
Datatype teidata.probCert
resp (responsible party) indicates the agency responsible for the intervention or interpretation, for example an editor or transcriber.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Note

To reduce the ambiguity of a resp pointing directly to a person or organization, we recommend that resp be used to point not to an agent (<person> or <org>) but to a <respStmt>, <author>, <editor> or similar element which clarifies the exact role played by the agent. Pointing to multiple <respStmt>s allows the encoder to specify clearly each of the roles played in part of a TEI file (creating, transcribing, encoding, editing, proofing etc.).
Example
Blessed are the <choice>  <sic>cheesemakers</sic>  <corr resp="#editor" cert="high">peacemakers</corr> </choice>: for they shall be called the children of God.
Example
<!-- in the <text> ... --><lg> <!-- ... -->  <l>Punkes, Panders, baſe extortionizing    sla<choice>    <sic>n</sic>    <corr resp="#JENS1_transcriber">u</corr>   </choice>es,</l> <!-- ... --> </lg> <!-- in the <teiHeader> ... --> <!-- ... --> <respStmt xml:id="JENS1_transcriber">  <resp when="2014">Transcriber</resp>  <name>Janelle Jenstad</name> </respStmt>

2.3.25. att.global.source

att.global.source provides attributes used by elements to point to an external source. [1.3.1.1.4. Sources, certainty, and responsibility 3.3.3. Quotation 8.3.4. Writing]
Module tei
Members att.global[TEI abbr add addrLine address att attDef attList availability back body cb choice classRef classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 edition editionStmt editorialDecl elementSpec encodingDesc expan extent facsimile fileDesc forename front gap gi graphic handDesc handNote hi history idno item langUsage language lb licence list listOrg listPerson listPlace listRelation moduleRef msDesc msIdentifier name note objectDesc occupation org orgName p particDesc pb persName person physDesc place placeName profileDesc projectDesc provenance pubPlace publicationStmt publisher ref relation repository resp respStmt rs schemaSpec segmentation settingDesc settlement sex sic sourceDesc supportDesc surface surfaceGrp surname teiHeader text title titleStmt unclear val valItem valList w]
Attributes
source specifies the source from which some aspect of this element is drawn.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Schematron
<sch:rule context="tei:*/@source"> <sch:let name="srcs"  value="tokenize( normalize-space(.),' ')"/> <sch:report test="( parent::tei:classRef | parent::tei:dataRef | parent::tei:elementRef | parent::tei:macroRef | parent::tei:moduleRef | parent::tei:schemaSpec ) and $srcs[2]"> When used on a schema description element (like <sch:value-of select="name(..)"/>), the @source attribute should have only 1 value. (This one has <sch:value-of select="count($srcs)"/>.) </sch:report> </sch:rule>
Note

The source attribute points to an external source. When used on an element describing a schema component (<classRef>, <dataRef>, <elementRef>, <macroRef>, <moduleRef>, or <schemaSpec>), it identifies the source from which declarations for the components should be obtained.

On other elements it provides a pointer to the bibliographical source from which a quotation or citation is drawn.

In either case, the location may be provided using any form of URI, for example an absolute URI, a relative URI, a private scheme URI of the form tei:x.y.z, where x.y.z indicates the version number, e.g. tei:4.3.2 for TEI P5 release 4.3.2 or (as a special case) tei:current for whatever is the latest release, or a private scheme URI that is expanded to an absolute URI as documented in a <prefixDef>.

When used on elements describing schema components, source should have only one value; when used on other elements multiple values are permitted.
Example
<p> <!-- ... --> As Willard McCarty (<bibl xml:id="mcc_2012">2012, p.2</bibl>) tells us, <quote source="#mcc_2012">‘Collaboration’ is a problematic and should be a contested    term.</quote> <!-- ... --> </p>
Example
<p> <!-- ... -->  <quote source="#chicago_15_ed">Grammatical theories are in flux, and the more we learn, the    less we seem to know.</quote> <!-- ... --> </p> <!-- ... --> <bibl xml:id="chicago_15_ed">  <title level="m">The Chicago Manual of Style</title>, <edition>15th edition</edition>. <pubPlace>Chicago</pubPlace>: <publisher>University of    Chicago Press</publisher> (<date>2003</date>), <biblScope unit="page">p.147</biblScope>. </bibl>
Example
<elementRef key="p" source="tei:2.0.1"/>
Include in the schema an element named <p> available from the TEI P5 2.0.1 release.
Example
<schemaSpec ident="myODD"  source="mycompiledODD.xml"> <!-- further declarations specifying the components required --> </schemaSpec>
Create a schema using components taken from the file mycompiledODD.xml.

2.3.26. att.handFeatures

att.handFeatures provides attributes describing aspects of the hand in which a manuscript is written. [11.3.2.1. Document Hands]
Module tei
Members handNote
Attributes
scribe gives a name or other identifier for the scribe believed to be responsible for this hand.
Status Optional
Datatype teidata.name
scribeRef points to a full description of the scribe concerned, typically supplied by a <person> element elsewhere in the description.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
script characterizes the particular script or writing style used by this hand, for example secretary, copperplate, Chancery, Italian, etc.
Status Optional
Datatype 1–∞ occurrences of teidata.name separated by whitespace
scriptRef points to a full description of the script or writing style used by this hand, typically supplied by a <scriptNote> element elsewhere in the description.
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
medium describes the tint or type of ink, e.g. brown, or other writing medium, e.g. pencil
Status Optional
Datatype 1–∞ occurrences of teidata.enumerated separated by whitespace
scope specifies how widely this hand is used in the manuscript.
Status Optional
Datatype teidata.enumerated
Legal values are:
sole
only this hand is used throughout the manuscript
major
this hand is used through most of the manuscript
minor
this hand is used occasionally in the manuscript
Note

Usually either script or scriptRef, and similarly, either scribe or scribeRef, will be supplied.

2.3.27. att.internetMedia

att.internetMedia provides attributes for specifying the type of a computer resource using a standard taxonomy.
Module tei
Members att.media[graphic] ref
Attributes
mimeType (MIME media type) specifies the applicable multimedia internet mail extension (MIME) media type
Status Optional
Datatype 1–∞ occurrences of teidata.word separated by whitespace
Example In this example mimeType is used to indicate that the URL points to a TEI XML file encoded in UTF-8.
<ref mimeType="application/tei+xml; charset=UTF-8"  target="https://raw.githubusercontent.com/TEIC/TEI/dev/P5/Source/guidelines-en.xml"/>
Note

This attribute class provides an attribute for describing a computer resource, typically available over the internet, using a value taken from a standard taxonomy. At present only a single taxonomy is supported, the Multipurpose Internet Mail Extensions (MIME) Media Type system. This 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 (IANA). The mimeType attribute must have a value taken from this list.

2.3.28. att.lexicographic.normalized

att.lexicographic.normalized provides attributes for usage within word-level elements in the analysis module and within lexicographic microstructure in the dictionaries module.
Module analysis
Members att.linguistic[w]
Attributes
norm (normalized) provides the normalized/standardized form of information present in the source text in a non-normalized form
Status Optional
Datatype teidata.text
Normalization of part-of-speech information within a dictionary entry.
<gramGrp>  <pos norm="noun">n</pos> </gramGrp>
Normalization of a source form in a tokenized historical corpus.
<s>  <w>for</w>  <w norm="virtue's">vertues</w>  <w>sake</w> </s>
<s>  <w norm="persuasion">perswasion</w>  <w>of</w>  <w norm="Unity">Vnitie</w> </s>
Example of normalization from Aviso. Relation oder Zeitung. Wolfenbüttel, 1609. In: Deutsches Textarchiv.
<s>  <w norm="freiwillig">freywillig</w>  <pc norm=","   join="left">/</pc>  <w norm="unbedrängt">vnbedraͤngt</w>  <w norm="und">vnd</w>  <w norm="unverhindert">vnuerhindert</w> </s>
<w norm="Teil">Theyll</w>
<w norm="Freude">Frewde</w>
orig (original) gives the original string or is the empty string when the element does not appear in the source text.
Status Optional
Datatype teidata.text
Example from a language documentation project of the Mixtepec-Mixtec language (ISO 639-3: 'mix'). This is a use case where speakers spell something incorrectly but we would like to preserve it for any number of reasons, the use of orig is essential and could have uses for both the speaker to see past mistakes, researchers to get insight into how untrained speakers write their language instinctually (in contrast to prescribed convention), etc.:
<w orig="ntsa sia'i">ntsasia'i</w>
Example from the EarlyPrint project. Fragment of text where obvious errors have been corrected but the original forms remain recorded:
<w lemma="he"  pos="pns"  xml:id="b1afj-003-a-0950">he</w> <w lemma="have"  pos="vvz"  xml:id="b1afj-003-a-0960">hath</w> <w lemma="bring"  pos="vvn"  xml:id="b1afj-003-a-0970">brought</w> <w lemma="forth"  pos="av"  xml:id="b1afj-003-a-0980"  orig="sorth">forth</w>
An example from the EarlyPrint project showing the use of both norm and orig. The orig attribute preserves the original version (sometimes with spelling errors, often with printer abbreviations), the element content resolves printer abbreviations but retains the original orthography, and the norm attribute holds normalized values:
<w lemma="commandment"  pos="n1"  norm="commandment"  xml:id="b9avr-018-a-7720"  orig="commandemēt">commandement</w>
Note

It needs to be stressed that the two attributes in this class are meant for strictly lexicographic and linguistic uses, and not for editorial interventions. For the latter, the mechanism based on <choice>, <orig>, and <reg> needs to be employed.

2.3.29. att.media

att.media provides attributes for specifying display and related properties of external media.
Module tei
Members graphic
Attributes att.internetMedia (@mimeType)

2.3.30. att.namespaceable

att.namespaceable provides attributes indicating the target namespace for an object being created
Module tagdocs
Members elementSpec schemaSpec
Attributes
ns (namespace) specifies the namespace to which this element belongs
Status Optional
Datatype teidata.namespace
Default http://www.tei-c.org/ns/1.0

2.3.31. att.naming

att.naming provides attributes common to elements which refer to named persons, places, organizations etc. [3.6.1. Referring Strings 13.3.6. Names and Nyms]
Module tei
Members att.personal[forename name orgName persName placeName surname] country occupation pubPlace repository rs settlement
Attributes att.canonical (@ref)

2.3.32. att.notated

att.notated provides attributes to indicate any specialised notation used for element content.
Module tei
Members w
Attributes
notation names the notation used for the content of the element.
Status Optional
Datatype teidata.enumerated

2.3.33. att.placement

att.placement provides attributes for describing where on the source page or object a textual element appears. [3.5.3. Additions, Deletions, and Omissions 11.3.1.4. Additions and Deletions]
Module tei
Members add note
Attributes
place specifies where this item is placed.
Status Recommended
Datatype 1–∞ occurrences of teidata.enumerated separated by whitespace
Suggested values include:
top
at the top of the page
bottom
at the foot of the page
margin
in the margin (left, right, or both)
opposite
on the opposite, i.e. facing, page
overleaf
on the other side of the leaf
above
above the line
right
to the right, e.g. to the right of a vertical line of text, or to the right of a figure
below
below the line
left
to the left, e.g. to the left of a vertical line of text, or to the left of a figure
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>

2.3.34. att.pointing

att.pointing provides a set of attributes used by all elements which point to other elements by means of one or more URI references. [1.3.1.1.2. Language Indicators 3.7. Simple Links and Cross-References]
Module tei
Members licence note ref
Attributes
target specifies the destination of the reference by supplying one or more URI References
Status Optional
Datatype 1–∞ occurrences of teidata.pointer separated by whitespace
Note

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.

2.3.35. att.ranging

att.ranging provides attributes for describing numerical ranges.
Module tei
Members att.dimensions[add date del gap unclear]
Attributes
atLeast gives a minimum estimated value for the approximate measurement.
Status Optional
Datatype teidata.numeric
atMost gives a maximum estimated value for the approximate measurement.
Status Optional
Datatype teidata.numeric
min where the measurement summarizes more than one observation or a range, supplies the minimum value observed.
Status Optional
Datatype teidata.numeric
max where the measurement summarizes more than one observation or a range, supplies the maximum value observed.
Status Optional
Datatype teidata.numeric
confidence specifies the 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 teidata.probability
Example
The MS. was lost in transmission by mail from <del rend="overstrike">  <gap reason="illegible"   extent="one or two letters" atLeast="1" atMost="2" unit="chars"/> </del> Philadelphia to the Graphic office, New York.

2.3.36. att.repeatable

att.repeatable provides attributes for the elements which define component parts of a content model.
Module tagdocs
Members classRef
Attributes
minOccurs (minimum number of occurences) indicates the smallest number of times this component may occur.
Status Optional
Datatype teidata.count
Default 1
maxOccurs (maximum number of occurences) indicates the largest number of times this component may occur.
Status Optional
Datatype teidata.unboundedInt
Default 1
Schematron
<sch:rule context="*[ @minOccurs and @maxOccurs ]"> <sch:let name="min"  value="@minOccurs cast as xs:integer"/> <sch:let name="max"  value="if ( normalize-space( @maxOccurs ) eq 'unbounded') then -1 else @maxOccurs cast as xs:integer"/> <sch:assert test="$max eq -1 or $max ge $min">@maxOccurs should be greater than or equal to @minOccurs</sch:assert> </sch:rule> <sch:rule context="*[ @minOccurs and not( @maxOccurs ) ]"> <sch:assert test="@minOccurs cast as xs:integer lt 2">When @maxOccurs is not specified, @minOccurs must be 0 or 1</sch:assert> </sch:rule>
Note

The value of minOccurs must always be less than or equal to that of maxOccurs. Since the default value of maxOccurs is 1, when maxOccurs is not specified minOccurs must always be less than or equal to 1. The default value of minOccurs is also 1, and therefore, when minOccurs is not specified the value of maxOccurs must always be greater than or equal to 1. An ODD processor should raise an error if either of these conditions is not met.

2.3.37. att.resourced

att.resourced provides attributes by which a resource (such as an externally held media file) may be located.
Module tei
Members graphic
Attributes
url (uniform resource locator) specifies the URL from which the media concerned may be obtained.
Status Required
Datatype teidata.pointer

2.3.38. 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. [9.1. Dictionary Body and Overall Structure]
Module tei
Members correspAction idno item list listOrg listPerson listPlace listRelation msDesc org person place relation
Attributes
sortKey supplies the sort key for this element in an index, list or group which contains it.
Status Optional
Datatype teidata.word
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. It provides a sequence of characters which, when sorted with the other values, will produced the desired order; specifics of sort key construction are application-dependent

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.

2.3.39. att.spanning

att.spanning provides attributes for elements which delimit a span of text by pointing mechanisms rather than by enclosing it. [11.3.1.4. Additions and Deletions 1.3.1. Attribute Classes]
Module tei
Members cb lb pb
Attributes
spanTo indicates the end of a span initiated by the element bearing this attribute.
Status Optional
Datatype teidata.pointer
Schematron The @spanTo attribute must point to an element following the current element
<sch:rule context="tei:*[@spanTo]"> <sch:assert test="id(substring(@spanTo,2)) and following::*[@xml:id=substring(current()/@spanTo,2)]">The element indicated by @spanTo (<sch:value-of select="@spanTo"/>) must follow the current element <sch:name/> </sch:assert> </sch:rule>
Note

The span is defined as running in document order from the start of the content of the pointing element 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. If no content is present, the assumption is that the starting point of the span is immediately following the element itself.

2.3.40. att.timed

att.timed provides attributes common to those elements which have a duration in time, expressed either absolutely or by reference to an alignment map. [8.3.5. Temporal Information]
Module tei
Members gap
Attributes

2.3.41. att.translatable

att.translatable provides attributes used to indicate the status of a translatable portion of an ODD document.
Module tagdocs
Members desc
Attributes
versionDate specifies the date on which the source text was extracted and sent to the translator
Status Optional
Datatype teidata.temporal.working
Note

The versionDate attribute can be used to determine whether a translation might need to be revisited, by comparing the modification date on the containing file with the versionDate value on the translation. If the file has changed, changelogs can be checked to see whether the source text has been modified since the translation was made.

2.3.42. att.typed

att.typed provides attributes that can be used to classify or subclassify elements in any way. [1.3.1. Attribute Classes 17.1.1. Words and Above 3.6.1. Referring Strings 3.7. Simple Links and Cross-References 3.6.5. Abbreviations and Their Expansions 3.13.1. Core Tags for Verse 7.2.5. Speech Contents 4.1.1. Un-numbered Divisions 4.1.2. Numbered Divisions 4.2.1. Headings and Trailers 4.4. Virtual Divisions 13.3.2.3. Personal Relationships 11.3.1.1. Core Elements for Transcriptional Work 16.1.1. Pointers and Links 16.3. Blocks, Segments, and Anchors 12.2. Linking the Apparatus to the Text 22.5.1.2. Defining Content Models: RELAX NG 8.3. Elements Unique to Spoken Texts 23.3.1.3. Modification of Attribute and Attribute Value Lists]
Module tei
Members TEI abbr add cb classSpec corr correspAction correspDesc country date del desc div div1 div2 div3 div4 div5 forename graphic idno lb list listOrg listPerson listPlace listRelation msDesc name note occupation org orgName pb persName place placeName provenance ref relation rs settlement sex surface surfaceGrp surname text title w
Attributes
type characterizes the element in some sense, using any convenient classification scheme or typology.
Status Optional
Datatype teidata.enumerated
<div type="verse">  <head>Night in Tarras</head>  <lg type="stanza">   <l>At evening tramping on the hot white road</l>   <l>…</l>  </lg>  <lg type="stanza">   <l>A wind sprang up from nowhere as the sky</l>   <l>…</l>  </lg> </div>
Note

The type attribute is present on a number of elements, not all of which are members of att.typed, usually because these elements restrict the possible values for the attribute in a specific way.
Schematron
<sch:rule context="tei:*[@subtype]"> <sch:assert test="@type">The <sch:name/> element should not be categorized in detail with @subtype unless also categorized in general with @type</sch:assert> </sch:rule>
Note

When appropriate, values from an established typology should be used. Alternatively a typology may be defined in the associated TEI header. If values are to be taken from a project-specific list, this should be defined using the <valList> element in the project-specific schema description, as described in 23.3.1.3. Modification of Attribute and Attribute Value Lists .

2.3.43. att.written

att.written provides attributes to indicate the hand in which the content of an element was written in the source being transcribed. [1.3.1. Attribute Classes]
Module tei
Members att.transcriptional[add del] div hi note p text
Attributes
hand points to a <handNote> element describing the hand considered responsible for the content of the element concerned.
Status Optional
Datatype teidata.pointer

2.4. Macros

2.4.1. macro.limitedContent

macro.limitedContent (paragraph content) defines the content of prose elements that are not used for transcription of extant materials. [1.3. The TEI Class System]
Module tei
Used by
desc
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.limitedPhrase"/>
  <classRef key="model.inter"/>
 </alternate>
</content>
    ⚓
Declaration 
macro.limitedContent = ( text | model.limitedPhrase | model.inter )*⚓

2.4.2. macro.paraContent

macro.paraContent (paragraph content) defines the content of paragraphs and similar elements. [1.3. The TEI Class System]
Module tei
Used by
add corr del hi p ref sic title unclear
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.phrase"/>
  <classRef key="model.inter"/>
  <classRef key="model.global"/>
  <elementRef key="lg"/>
  <classRef key="model.lLike"/>
 </alternate>
</content>
    ⚓
Declaration 
macro.paraContent =
   (
      text
    | model.gLike
    | model.phrase
    | model.inter
    | model.global
    | lg
    | model.lLike
   )*⚓

2.4.3. macro.phraseSeq

macro.phraseSeq (phrase sequence) defines a sequence of character data and phrase-level elements. [1.4.1. Standard Content Models]
Module tei
Used by
abbr addrLine country edition expan extent forename name orgName persName placeName rs settlement sex surname
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.attributable"/>
  <classRef key="model.phrase"/>
  <classRef key="model.global"/>
 </alternate>
</content>
    ⚓
Declaration 
macro.phraseSeq =
   ( text | model.gLike | model.attributable | model.phrase | model.global )*⚓

2.4.4. 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. [1.4.1. Standard Content Models]
Module tei
Used by
language repository resp
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.limitedPhrase"/>
  <classRef key="model.global"/>
 </alternate>
</content>
    ⚓
Declaration 
macro.phraseSeq.limited = ( text | model.limitedPhrase | model.global )*⚓

2.4.5. 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. [1.3. The TEI Class System]
Module tei
Used by
item licence note occupation
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.phrase"/>
  <classRef key="model.inter"/>
  <classRef key="model.divPart"/>
  <classRef key="model.global"/>
 </alternate>
</content>
    ⚓
Declaration 
macro.specialPara =
   (
      text
    | model.gLike
    | model.phrase
    | model.inter
    | model.divPart
    | model.global
   )*⚓

2.5. Datatypes

2.5.1. teidata.certainty

teidata.certainty defines the range of attribute values expressing a degree of certainty.
Module tei
Used by
teidata.probCert
Content model 
<content>
 <valList type="closed">
  <valItem ident="high"/>
  <valItem ident="medium"/>
  <valItem ident="low"/>
  <valItem ident="unknown"/>
 </valList>
</content>
    ⚓
Declaration 
teidata.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.

2.5.2. teidata.count

teidata.count defines the range of attribute values used for a non-negative integer value used as a count.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef name="nonNegativeInteger"/>
</content>
    ⚓
Declaration 
teidata.count = xsd:nonNegativeInteger⚓
Note

Any positive integer value or zero is permitted

2.5.3. teidata.duration.iso

teidata.duration.iso defines the range of attribute values available for representation of a duration in time using ISO 8601 standard formats
Module tei
Used by
Content model 
<content>
 <dataRef name="token"
  restriction="[0-9.,DHMPRSTWYZ/:+\-]+"/>
</content>
    ⚓
Declaration 
teidata.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.

2.5.4. teidata.duration.w3c

teidata.duration.w3c defines the range of attribute values available for representation of a duration in time using W3C datatypes.
Module tei
Used by
Content model 
<content>
 <dataRef name="duration"/>
</content>
    ⚓
Declaration 
teidata.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.

2.5.5. teidata.enumerated

teidata.enumerated defines the range of attribute values expressed as a single XML name taken from a list of documented possibilities.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef key="teidata.word"/>
</content>
    ⚓
Declaration 
teidata.enumerated = teidata.word⚓
Note

Attributes using this datatype must contain a single ‘word’ which contains only letters, digits, punctuation characters, or symbols: thus it cannot include whitespace.

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.

2.5.6. teidata.language

teidata.language defines the range of attribute values used to identify a particular combination of human language and writing system. [6.1. Language Identification]
Module tei
Used by
Element:
Content model 
<content>
 <alternate>
  <dataRef name="language"/>
  <valList>
   <valItem ident=""/>
  </valList>
 </alternate>
</content>
    ⚓
Declaration 
teidata.language = xsd:language | ( "" )⚓
Note

The values for this attribute are language ‘tags’ as defined in BCP 47. Currently BCP 47 comprises RFC 5646 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 searched or browsed at https://www.iso.org/obp/ui/#search/code/. 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.

2.5.7. teidata.name

teidata.name defines the range of attribute values expressed as an XML Name.
Module tei
Used by
att giElement:
Content model 
<content>
 <dataRef name="Name"/>
</content>
    ⚓
Declaration 
teidata.name = xsd:Name⚓
Note

Attributes using this datatype must contain a single word which follows the rules defining a legal XML name (see https://www.w3.org/TR/REC-xml/#dt-name): for example they cannot include whitespace or begin with digits.

2.5.8. teidata.namespace

teidata.namespace defines the range of attribute values used to indicate XML namespaces as defined by the W3C Namespaces in XML Technical Recommendation.
Module tei
Used by
Content model 
<content>
 <dataRef restriction="\S*" name="anyURI"/>
</content>
    ⚓
Declaration 
teidata.namespace = xsd:anyURI { pattern = "\S*" }⚓
Note

The range of syntactically valid values is defined by RFC 3986 Uniform Resource Identifier (URI): Generic Syntax

2.5.9. teidata.numeric

teidata.numeric defines the range of attribute values used for numeric values.
Module tei
Used by
Element:
Content model 
<content>
 <alternate>
  <dataRef name="double"/>
  <dataRef name="token"
   restriction="(\-?[\d]+/\-?[\d]+)"/>
  <dataRef name="decimal"/>
 </alternate>
</content>
    ⚓
Declaration 
teidata.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.

2.5.10. teidata.pattern

teidata.pattern defines attribute values which are expressed as a regular expression.
Module tei
Used by
Content model 
<content>
 <dataRef name="token"/>
</content>
    ⚓
Declaration 
teidata.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

This TEI datatype is mapped to the XSD token datatype, and may therefore contain any string of characters. However, it is recommended that the value used conform to the particular flavour of regular expression syntax supported by XSD Schema.

2.5.11. teidata.point

teidata.point defines the data type used to express a point in cartesian space.
Module tei
Used by
Content model 
<content>
 <dataRef name="token"
  restriction="(-?[0-9]+(\.[0-9]+)?,-?[0-9]+(\.[0-9]+)?)"/>
</content>
    ⚓
Declaration 
teidata.point = token { pattern = "(-?[0-9]+(\.[0-9]+)?,-?[0-9]+(\.[0-9]+)?)" }⚓
Example
<facsimile>  <surface ulx="0" uly="0" lrx="400" lry="280">   <zone points="220,100 300,210 170,250 123,234">    <graphic url="handwriting.png"/>   </zone>  </surface> </facsimile>
Note

A point is defined by two numeric values, which should be expressed as decimal numbers. Neither number can end in a decimal point. E.g., both 0.0,84.2 and 0,84 are allowed, but 0.,84. is not.

2.5.12. teidata.pointer

teidata.pointer defines the range of attribute values used to provide a single URI, absolute or relative, pointing to some other resource, either within the current document or elsewhere.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef restriction="\S+" name="anyURI"/>
</content>
    ⚓
Declaration 
teidata.pointer = xsd:anyURI { pattern = "\S+" }⚓
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/

2.5.13. teidata.probCert

teidata.probCert defines a range of attribute values which can be expressed either as a numeric probability or as a coded certainty value.
Module tei
Used by
Content model 
<content>
 <alternate>
  <dataRef key="teidata.probability"/>
  <dataRef key="teidata.certainty"/>
 </alternate>
</content>
    ⚓
Declaration 
teidata.probCert = teidata.probability | teidata.certainty⚓

2.5.14. teidata.probability

teidata.probability defines the range of attribute values expressing a probability.
Module tei
Used by
teidata.probCert
Content model 
<content>
 <dataRef name="double"/>
</content>
    ⚓
Declaration 
teidata.probability = xsd:double⚓
Note

Probability is expressed as a real number between 0 and 1; 0 representing certainly false and 1 representing certainly true.

2.5.15. teidata.replacement

teidata.replacement defines attribute values which contain a replacement template.
Module tei
Used by
Content model 
<content>
 <textNode/>
</content>
    ⚓
Declaration 
teidata.replacement = text⚓

2.5.16. teidata.sex

teidata.sex defines the range of attribute values used to identify human or animal sex.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef key="teidata.word"/>
</content>
    ⚓
Declaration 
teidata.sex = teidata.word⚓
Note

Values for attributes using this datatype may be locally defined by a project, or may refer to an external standard, such as vCard's sex property http://microformats.org/wiki/gender-formats (in which M indicates male, F female, O other, N none or not applicable, U unknown), or the often used ISO 5218:2004 Representation of Human Sexes http://standards.iso.org/ittf/PubliclyAvailableStandards/c036266_ISO_IEC_5218_2004(E_F).zip (in which 0 indicates unknown; 1 male; 2 female; and 9 not applicable, although the ISO standard is widely considered inadequate); cf. CETH's Recommendations for Inclusive Data Collection of Trans People http://transhealth.ucsf.edu/trans?page=lib-data-collection.

2.5.17. teidata.temporal.iso

teidata.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.
Module tei
Used by
Content model 
<content>
 <alternate>
  <dataRef name="date"/>
  <dataRef name="gYear"/>
  <dataRef name="gMonth"/>
  <dataRef name="gDay"/>
  <dataRef name="gYearMonth"/>
  <dataRef name="gMonthDay"/>
  <dataRef name="time"/>
  <dataRef name="dateTime"/>
  <dataRef name="token"
   restriction="[0-9.,DHMPRSTWYZ/:+\-]+"/>
 </alternate>
</content>
    ⚓
Declaration 
teidata.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.

2.5.18. teidata.temporal.w3c

teidata.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 Second Edition specification.
Module tei
Used by
Element:
Content model 
<content>
 <alternate>
  <dataRef name="date"/>
  <dataRef name="gYear"/>
  <dataRef name="gMonth"/>
  <dataRef name="gDay"/>
  <dataRef name="gYearMonth"/>
  <dataRef name="gMonthDay"/>
  <dataRef name="time"/>
  <dataRef name="dateTime"/>
 </alternate>
</content>
    ⚓
Declaration 
teidata.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.

2.5.19. teidata.temporal.working

teidata.temporal.working defines the range of values, conforming to the W3C XML Schema Part 2: Datatypes Second Edition specification, expressing a date or a date and a time within the working life of the document.
Module tei
Used by
Content model 
<content>
 <alternate>
  <dataRef name="date"
   restriction="(19[789][0-9]|[2-9][0-9]{3}).*"/>
  <dataRef name="dateTime"
   restriction="(19[789][0-9]|[2-9][0-9]{3}).*"/>
 </alternate>
</content>
    ⚓
Declaration 
teidata.temporal.working =
   xsd:date { pattern = "(19[789][0-9]|[2-9][0-9]{3}).*" }
 | xsd:dateTime { pattern = "(19[789][0-9]|[2-9][0-9]{3}).*" }⚓
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.

The earliest time expressable with this datatype is 01 January 1970 (the Unix Epoch), which could be written as either 1970-01-01 or 1970-01-01T00:00:00Z.

2.5.20. teidata.text

teidata.text defines the range of attribute values used to express some kind of identifying string as a single sequence of Unicode characters possibly including whitespace.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef name="string"/>
</content>
    ⚓
Declaration 
teidata.text = string⚓
Note

Attributes using this datatype must contain a single ‘token’ in which whitespace and other punctuation characters are permitted.

2.5.21. teidata.truthValue

teidata.truthValue defines the range of attribute values used to express a truth value.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef name="boolean"/>
</content>
    ⚓
Declaration 
teidata.truthValue = xsd:boolean⚓
Note

The possible values of this datatype are 1 or true, or 0 or false.

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: teidata.xTruthValue.

2.5.22. teidata.unboundedInt

teidata.unboundedInt defines an attribute value which can be either any non-negative integer or the string "unbounded".
Module tei
Used by
Content model 
<content>  <alternate>
  <dataRef name="nonNegativeInteger"/>
  <valList type="closed">
   <valItem ident="unbounded"/>
  </valList>
 </alternate>
</content>
    ⚓
Declaration 
teidata.unboundedInt = xsd:nonNegativeInteger | ( "unbounded" )⚓

2.5.23. teidata.versionNumber

teidata.versionNumber defines the range of attribute values used for version numbers.
Module tei
Used by
Content model 
<content>
 <dataRef name="token"
  restriction="[\d]+[a-z]*[\d]*(\.[\d]+[a-z]*[\d]*){0,3}"/>
</content>
    ⚓
Declaration 
teidata.versionNumber =
   token { pattern = "[\d]+[a-z]*[\d]*(\.[\d]+[a-z]*[\d]*){0,3}" }⚓

2.5.24. teidata.word

teidata.word defines the range of attribute values expressed as a single word or token.
Module tei
Used by
teidata.enumerated teidata.sexElement:
Content model 
<content>
 <dataRef name="token"
  restriction="[^\p{C}\p{Z}]+"/>
</content>
    ⚓
Declaration 
teidata.word = token { pattern = "[^\p{C}\p{Z}]+" }⚓
Note

Attributes using this datatype must contain a single ‘word’ which contains only letters, digits, punctuation characters, or symbols: thus it cannot include whitespace.

2.5.25. teidata.xTruthValue

teidata.xTruthValue (extended truth value) defines the range of attribute values used to express a truth value which may be unknown.
Module tei
Used by
Content model 
<content>
 <alternate>
  <dataRef name="boolean"/>
  <valList>
   <valItem ident="unknown"/>
   <valItem ident="inapplicable"/>
  </valList>
 </alternate>
</content>
    ⚓
Declaration 
teidata.xTruthValue = xsd:boolean | ( "unknown" | "inapplicable" )⚓
Note

In cases where where uncertainty is inappropriate, use the datatype teidata.TruthValue.

2.5.26. teidata.xmlName

teidata.xmlName defines attribute values which contain an XML name.
Module tei
Used by
Element:
Content model 
<content>
 <dataRef name="NCName"/>
</content>
    ⚓
Declaration 
teidata.xmlName = xsd:NCName⚓
Note

The rules defining an XML name form a part of the XML Specification.

2.5.27. teidata.xpath

teidata.xpath defines attribute values which contain an XPath expression.
Module tei
Used by
Content model 
<content>
 <textNode/>
</content>
    ⚓
Declaration 
teidata.xpath = text⚓
Note

Any XPath expression using the syntax defined in 6.2..

When writing programs that evaluate XPath expressions, programmers should be mindful of the possibility of malicious code injection attacks. For further information about XPath injection attacks, see the article at OWASP.
Home 
Baudoin Davoury . Date: 2023-10