Gaskell Journal ODD

Contained by

namesdates: person personGrp persona

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: address choice date email gap hi lb milestone name note pb ref time title

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident tag val

textcrit: app witDetail

transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin

character data

Note

As with other culturally-constructed traits such as sex, the way in which this concept is described in different cultural contexts may vary. The normalizing attributes are provided as a means of simplifying that variety to Western European norms and should not be used where that is inappropriate. The content of the element may be used to describe the intended concept in more detail, using plain text.

Example

<age value="2" notAfter="1986">under 20 in the early eighties</age>

Content model

<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>

Schema Declaration

element age
{
   att.global.attributes,
   att.editLike.attributes,
   att.datable.attributes,
   att.typed.attribute.subtype,
   att.dimensions.attributes,
   attribute type { text }?,
   attribute value { text }?,
   macro.phraseSeq.limited
}

1.15. <alt>

<alt> (alternation) identifies an alternation or a set of choices among elements or passages. [16.8. Alternation]

Module

linking

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.pointing (target, @targetLang, @evaluate)

target

specifies the destination of the reference by supplying one or more URI References

Derived from	att.pointing
Status	Optional
Datatype	2–∞ occurrences of teidata.pointer separated by whitespace

mode

states whether the alternations gathered in this collection are exclusive or inclusive.

Status	Recommended
Datatype	teidata.enumerated
Legal values are:	excl (exclusive) indicates that the alternation is exclusive, i.e. that at most one of the alternatives occurs. incl (inclusive) indicates that the alternation is not exclusive, i.e. that one or more of the alternatives occur.

weights

If mode is excl, each weight states the probability that the corresponding alternative occurs. If mode is incl each weight states the probability that the corresponding alternative occurs given that at least one of the other alternatives occurs.

Status	Optional
Datatype	2–∞ occurrences of teidata.probability separated by whitespace
Note	If mode is excl, the sum of weights must be 1. If mode is incl, the sum of weights must be in the range from 0 to the number of alternants.

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab altGrp seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

Empty element

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element alt
{
   att.global.attributes,
   att.pointing.attribute.targetLang,
   att.pointing.attribute.evaluate,
   att.typed.attributes,
   attribute target { list { * } }?,
   attribute mode { "excl" | "incl" }?,
   attribute weights { list { * } }?,
   empty
}

1.16. <altGrp>

<altGrp> (alternation group) groups a collection of <alt> elements and possibly pointers. [16.8. Alternation]

Module

linking

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing.group (@domains, @targFunc) (att.pointing (@targetLang, @target, @evaluate)) (att.typed (@type, @subtype))

mode

states whether the alternations gathered in this collection are exclusive or inclusive.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	excl (exclusive) indicates that the alternation is exclusive, i.e. that at most one of the alternatives occurs.[Default] incl (inclusive) indicates that the alternation is not exclusive, i.e. that one or more of the alternatives occur.

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

linking: alt

Note

Any number of alternations, pointers or extended pointers.

Example

Example

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <elementRef key="alt"/>
  <elementRef key="ptr"/>
 </alternate>
</content>

Schema Declaration

element altGrp
{
   att.global.attributes,
   att.pointing.group.attributes,
   attribute mode { "excl" | "incl" }?,
   ( alt | ptr )*
}

1.17. <altIdent>

<altIdent> (alternate identifier) supplies the recommended XML name for an element, class, attribute, etc. in some language. [3.3.4. Terms, Glosses, Equivalents, and Descriptions 22.4.1. Description of Components]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.glossLike
Contained by	header: category taxonomy linking: joinGrp tagdocs: attDef classSpec constraintSpec dataSpec elementSpec macroSpec model modelGrp modelSequence moduleSpec paramSpec schemaSpec valItem
May contain	Character data only
Note	All documentation elements in ODD have a canonical name, supplied as the value for their ident attribute. The <altIdent> element is used to supply an alternative name for the corresponding XML object, perhaps in a different language.
Example	<altIdent xml:lang="fr">balisageDoc</altIdent>
Content model	<content> <textNode/> </content>
Schema Declaration	element altIdent { att.global.attributes, att.typed.attributes, text }

1.18. <altIdentifier>

<altIdentifier> (alternative identifier) contains an alternative or former structured identifier used for a manuscript or other object, such as a former catalogue number. [10.4. The Manuscript Identifier]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Contained by	msdescription: msFrag msIdentifier namesdates: objectIdentifier
May contain	core: note header: idno msdescription: collection institution repository namesdates: bloc country district geogName placeName region settlement
Note	An identifying number of some kind must be supplied if known; if it is not known, this should be stated.
Example	<altIdentifier> <settlement>San Marino</settlement> <repository>Huntington Library</repository> <idno>MS.El.26.C.9</idno> </altIdentifier>
Content model	<content> <sequence> <classRef key="model.placeNamePart" expand="sequenceOptional"/> <elementRef key="institution" minOccurs="0"/> <elementRef key="repository" minOccurs="0"/> <elementRef key="collection" minOccurs="0"/> <elementRef key="idno"/> <elementRef key="note" minOccurs="0"/> </sequence> </content>
Schema Declaration	element altIdentifier { att.global.attributes, att.typed.attributes, ( placeName?, bloc?, country?, region?, settlement?, district?, geogName?, institution?, repository?, collection?, idno, note? ) }

1.19. <alternate>

<alternate> indicates that the constructs referenced by its children form an alternation [22.5.1. Defining Content Models]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.repeatable (@minOccurs, @maxOccurs)
Member of	model.contentPart
Contained by	tagdocs: alternate content sequence
May contain	tagdocs: alternate anyElement classRef dataRef elementRef empty macroRef sequence textNode valList
Example	<content> <alternate> <elementRef key="name"/> <elementRef key="persName"/> </alternate> </content> This example content model permits either a <name> or a <persName>.
Schematron	<sch:assert test="count(*)>1">The alternate element must have at least two child elements</sch:assert>
Content model	<content> <classRef key="model.contentPart" maxOccurs="unbounded"/> </content>
Schema Declaration	element alternate { att.global.attributes, att.repeatable.attributes, model.contentPart+ }

1.20. <am>

<am> (abbreviation marker) contains a sequence of letters or signs present in an abbreviation which are omitted or replaced in the expanded form of the abbreviation. [11.3.1.2. Abbreviation and Expansion]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.editLike (@evidence, @instant)
Member of	model.choicePart model.pPart.editorial
Contained by	analysis: cl pc phr s span w core: add author bibl biblScope choice date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	core: add del reg sic unclear gaiji: g transcr: damage handShift mod redo restore retrace secl supplied surplus undo character data
Example	do you <abbr>Mr<am>.</am> </abbr> Jones?
Example	<choice> <abbr>Aug<am>g</am> </abbr> <expan>Aug<ex>ustorum duo</ex> </expan> </choice>
Example	<abbr>eu<am> <g ref="#b-er"/> </am>y</abbr> <abbr> <am> <g ref="#b-per"/> </am>sone </abbr> ...
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.gLike"/> <classRef key="model.pPart.transcriptional"/> </alternate> </content>
Schema Declaration	element am { att.global.attributes, att.typed.attributes, att.editLike.attributes, ( text \| model.gLike \| model.pPart.transcriptional )* }

1.21. <anchor>

<anchor> (anchor point) attaches an identifier to a point within a text, whether or not it corresponds with a textual element. [8.4.2. Synchronization and Overlap 16.5. Correspondence and Alignment]
Module	linking
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.milestoneLike
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg listBibl name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc subst supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	Empty element
Note	On this element, the global xml:id attribute must be supplied to specify an identifier for the point at which this element occurs within a document. The value used may be chosen freely provided that it is unique within the document and is a syntactically valid name. There is no requirement for values containing numbers to be in sequence.
Example	<s>The anchor is he<anchor xml:id="A234"/>re somewhere.</s> <s>Help me find it.<ptr target="#A234"/> </s>
Content model	<content> <empty/> </content>
Schema Declaration	element anchor { att.global.attributes, att.typed.attributes, empty }

1.22. <anyElement>

<anyElement> indicates the presence of any elements in a content model [22. Documentation Elements]

Module tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.repeatable (@minOccurs, @maxOccurs)

require

supplies a list of namespaces to one of which the permitted elements must belong.

Status	Optional
Datatype	1–∞ occurrences of teidata.namespace separated by whitespace

except

supplies a list of namespaces or prefixed element names which are not permitted.

Status	Optional
Datatype	1–∞ occurrences of teidata.namespaceOrName separated by whitespace
Note	When RELAX NG DTD Compatibility Mode is turned on, validation requires that any elements which may take an xml:id be excluded from the content of anyName name classes. For normal TEI purposes, this includes anything in the TEI namespace and the <egXML> element. Default elements and namespaces to be excluded are set on the defaultExceptions attribute of the <schemaSpec>. except may be used when the exceptions need to be locally specified. Element prefixes must be declared using a namespace declaration on the parent or an ancestor element.

Member of

model.contentPart

Contained by

tagdocs: alternate content sequence

May contain Empty element

Example

This <content> element permits one occurrence of any element which does not belong to the TEI namespace.

Example

This <content> element permits one or more elements which belong either to the MathML namespace or to the TEI examples namespace.

Example

This <content> element permits one or more children which are either text nodes or elements from the TEI examples namespace. It is the equivalent of the content model ANY in an XML DTD using the TEI All schema.

Content model

<content>
 <empty/>
</content>

Schema Declaration

element anyElement
{
   att.global.attributes,
   att.repeatable.attributes,
   attribute require { list { + } }?,
   attribute except { list { + } }?,
   empty
}

1.23. <app>

<app> (apparatus entry) contains one entry in a critical apparatus, with an optional lemma and usually one or more readings or notes on the relevant passage. [12.1.1. The Apparatus Entry]

Module

textcrit

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

type

classifies the variation contained in this element according to some convenient typology.

Status	Optional
Datatype	teidata.enumerated

from

identifies the beginning of the lemma in the base text.

Status	Optional
Datatype	teidata.pointer
Note	This attribute should be used when either the double-end point method of apparatus markup, or the location-referenced method with a URL rather than canonical reference, are used.

to

identifies the endpoint of the lemma in the base text.

Status	Optional
Datatype	teidata.pointer
Note	This attribute is only used when the double-end point method of apparatus markup is used, when the encoded apparatus is not embedded in-line in the base-text.

loc

(location) indicates the location of the variation, when the location-referenced method of apparatus markup is used.

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace
Note	This attribute is used only when the location-referenced encoding method is used. It supplies a string containing a canonical reference for the passage to which the variation applies.

Member of

model.biblPart model.publicationStmtPart.detail

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem listApp rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

core: note

textcrit: lem rdg rdgGrp wit witDetail

Example

<app> <lem wit="#El #Hg">Experience</lem> <rdg wit="#La" type="substantive">Experiment</rdg> <rdg wit="#Ra2" type="substantive">Eryment</rdg> </app>

Example

<app type="substantive"> <rdgGrp type="subvariants"> <lem wit="#El #Hg">Experience</lem> <rdg wit="#Ha4">Experiens</rdg> </rdgGrp> <rdgGrp type="subvariants"> <lem wit="#Cp #Ld1">Experiment</lem> <rdg wit="#La">Ex<g ref="#per"/>iment</rdg> </rdgGrp> <rdgGrp type="subvariants"> <lem resp="#ed2013">Eriment</lem> <rdg wit="#Ra2">Eryment</rdg> </rdgGrp> </app>

Example

<app loc="1"> <rdg resp="#SEG">TIMΩΔA</rdg> </app>

Example

<app loc="1-6"> <note>Too badly worn to yield a text</note> </app>

Example

<choice xml:id="choice3"> <reg>σύμπαντα</reg> <orig>ΣΙΝΠΑΤΑΝ</orig> </choice>  <app from="#choice3"> <note>Mommsen's fanciful normalization, reproduced here, has not been accepted by all recent editions</note> </app>

Content model

<content>
 <sequence>
  <elementRef key="lem" minOccurs="0"/>
  <alternate maxOccurs="unbounded"
   minOccurs="0">
   <classRef key="model.rdgLike"/>
   <classRef key="model.noteLike"/>
   <elementRef key="witDetail"/>
   <elementRef key="wit"/>
   <elementRef key="rdgGrp"/>
  </alternate>
 </sequence>
</content>

Schema Declaration

element app
{
   att.global.attributes,
   attribute type { text }?,
   attribute from { text }?,
   attribute to { text }?,
   attribute loc { list { + } }?,
   ( lem?, ( model.rdgLike | model.noteLike | witDetail | wit | rdgGrp )* )
}

1.24. <appInfo>

<appInfo> (application information) records information about an application which has edited the TEI file. [2.3.11. The Application Information Element]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	header: application
Example	<appInfo> <application version="1.24" ident="Xaira"> <label>XAIRA Indexer</label> <ptr target="#P1"/> </application> </appInfo>
Content model	<content> <classRef key="model.applicationLike" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element appInfo { att.global.attributes, model.applicationLike+ }

1.25. <application>

<application> provides information about an application which has acted upon the document. [2.3.11. The Application Information Element]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))

ident

supplies an identifier for the application, independent of its version number or display name.

Status	Required
Datatype	teidata.name

version

supplies a version number for the application, independent of its identifier or display name.

Status	Required
Datatype	teidata.versionNumber

Member of

model.applicationLike

Contained by

header: appInfo

May contain

core: desc p ref

linking: ab

Example

<appInfo> <application version="1.5" ident="ImageMarkupTool1" notAfter="2006-06-01"> <label>Image Markup Tool</label> <ptr target="#P1"/> <ptr target="#P2"/> </application> </appInfo>

This example shows an appInfo element documenting the fact that version 1.5 of the Image Markup Tool1 application has an interest in two parts of a document which was last saved on June 6 2006. The parts concerned are accessible at the URLs given as target for the two <ptr> elements.

Content model

<content>
 <sequence>
  <classRef key="model.labelLike"
   minOccurs="1" maxOccurs="unbounded"/>
  <alternate>
   <classRef key="model.ptrLike"
    minOccurs="0" maxOccurs="unbounded"/>
   <classRef key="model.pLike"
    minOccurs="0" maxOccurs="unbounded"/>
  </alternate>
 </sequence>
</content>

Schema Declaration

element application
{
   att.global.attributes,
   att.typed.attributes,
   att.datable.attributes,
   attribute ident { text },
   attribute version { text },
   ( model.labelLike+, ( model.ptrLike* | model.pLike* ) )
}

1.26. <att>

<att> (attribute) contains the name of an attribute appearing within running text. [22. Documentation Elements]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

scheme

supplies an identifier for the scheme in which this name is defined.

Status	Optional
Datatype	teidata.enumerated
Sample values include:	TEI (Text Encoding Initiative) this attribute is part of the TEI scheme.[Default] DBK (Docbook) this attribute is part of the Docbook scheme. XX (unknown) this attribute is part of an unknown scheme. imaginary the attribute is from a non-existent scheme, for illustrative purposes only XHTML the attribute is part of the XHTML language XML the attribute is part of the XML language XI the attribute is defined in the xInclude schema

Member of

model.phrase.xml

Contained by

analysis: cl phr s span

core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

Empty element

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

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.

Content model

<content>
 <dataRef key="teidata.name"/>
</content>

Schema Declaration

element att { att.global.attributes, attribute scheme { text }?, teidata.name }

1.27. <attDef>

<attDef> (attribute definition) contains the definition of a single attribute. [22.5.3. Attribute List Specification]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) )

usage

specifies the optionality of the attribute.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	req (required) rec (recommended ) opt (optional ) [Default]

ns

(namespace) specifies the namespace to which this attribute belongs

Status	Optional
Datatype	teidata.namespace
Default	http://www.tei-c.org/ns/1.0

Contained by

tagdocs: attList

May contain

core: desc

tagdocs: altIdent constraintSpec datatype defaultVal equiv exemplum remarks valDesc 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">It does not make sense to make "<sch:value-of select="normalize-space(tei:defaultVal)"/>" the default value of @<sch:value-of select="@ident"/>, because that attribute is required.</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>
  <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">
   <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.attributes,
   att.identified.attributes,
   attribute usage { "req" | "rec" | "opt" }?,
   attribute ns { text }?,
   (
      ( model.glossLike | model.descLike )*,
      datatype?,
      constraintSpec*,
      defaultVal?,
      ( valList | valDesc+ )?,
      exemplum*,
      remarks*
   )
}

1.28. <attList>

<attList> 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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

org

(organization) specifies whether all the attributes in the list are available (org="group") or only one of them (org="choice")

Status	Optional
Datatype	teidata.enumerated
Legal values are:	group grouped[Default] choice alternated

Contained by

tagdocs: attList classSpec elementSpec

May contain

tagdocs: attDef attList attRef

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.attributes,
   attribute org { "group" | "choice" }?,
   ( attRef | attDef | attList )+
}

1.29. <attRef>

<attRef> (attribute pointer) points to the definition of an attribute or group of attributes. [22.2. Modules and Schemas]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

class

the name of the attribute class

Status	Optional
Datatype	teidata.word

name

the name of the attribute

Status	Optional
Datatype	teidata.text

Contained by

tagdocs: attList

May contain

Empty element

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element attRef
{
   att.global.attributes,
   attribute class { text }?,
   attribute name { text }?,
   empty
}

1.30. <author>

<author> in a bibliographic reference, contains the name(s) of an author, personal or corporate, of a work; for example in the same form as that provided by a recognized bibliographic name authority. [3.11.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Member of	model.respLike
Contained by	core: bibl header: editionStmt titleStmt msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use a generally recognized name authority file to supply the content for this element. The attributes key or ref may also be used to reference canonical information about the author(s) intended from any appropriate authority, such as a library catalogue or online resource. In the case of a broadcast, use this element for the name of the company or network responsible for making the broadcast. Where an author is unknown or unspecified, this element may contain text such as Unknown or Anonymous. When the appropriate TEI modules are in use, it may also contain detailed tagging of the names used for people, organizations or places, in particular where multiple names are given.
Example	<author>British Broadcasting Corporation</author> <author>La Fayette, Marie Madeleine Pioche de la Vergne, comtesse de (1634–1693)</author> <author>Anonymous</author> <author>Bill and Melinda Gates Foundation</author> <author> <persName>Beaumont, Francis</persName> and <persName>John Fletcher</persName> </author> <author> <orgName key="BBC">British Broadcasting Corporation</orgName>: Radio 3 Network </author>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element author { att.global.attributes, att.naming.attributes, macro.phraseSeq }

1.31. <authority>

<authority> (release authority) supplies the name of a person or other agency responsible for making a work available, other than a publisher or distributor. [2.2.4. Publication, Distribution, Licensing, etc.]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.publicationStmtPart.agency
Contained by	header: publicationStmt
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: address choice date email gap hi lb milestone name note pb ref time title header: idno linking: alt altGrp anchor join joinGrp link linkGrp timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val textcrit: app witDetail transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data
Example	<authority>John Smith</authority>
Content model	<content> <macroRef key="macro.phraseSeq.limited"/> </content>
Schema Declaration	element authority { att.global.attributes, att.canonical.attributes, macro.phraseSeq.limited }

1.32. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

status

supplies a code identifying the current availability of the text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	free the text is freely available. unknown the status of the text is unknown. restricted the text is not freely available.

Member of

Contained by

core: bibl

header: publicationStmt

msdescription: adminInfo

May contain

core: p

header: licence

linking: ab

Note

A consistent format should be adopted

Example

<availability status="restricted"> Available for academic research purposes only. </availability> <availability status="free"> In the public domain </availability> <availability status="restricted"> Available under licence from the publishers. </availability>

Example

<availability> <licence target="http://opensource.org/licenses/MIT"> The MIT License applies to this document. Copyright (C) 2011 by The University of Victoria 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: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. 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. </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.attributes,
   att.declarable.attributes,
   attribute status { "free" | "unknown" | "restricted" }?,
   ( model.availabilityPart | model.pLike )+
}

1.33. <bibl>

<bibl> (bibliographic citation) contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. [3.11.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default) att.typed (@type, @subtype) att.sortable (@sortKey) att.docStatus (@status)

ref

Status	Required
Legal values are:	#Southey-ToADyingInfant #Saussure-LEducationProgressive #Combe-Physiology #Blackwoods #Bible

Member of

model.biblLike model.biblPart

Contained by

core: add bibl del desc head hi l listBibl note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote sourceDesc tagUsage taxonomy

linking: ab seg

namesdates: climate event location object occupation org person personGrp persona place population state terrain trait

textcrit: lem rdg witDetail witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address author bibl biblScope choice date del editor email gap hi lb milestone name note pb pubPlace publisher ref reg respStmt sic textLang time title unclear

gaiji: g

header: availability distributor edition extent funder idno principal sponsor

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: depth dim height msIdentifier width

tagdocs: code ident

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

character data

Note

Contains phrase-level elements, together with any combination of elements from the model.biblPart class

Example

<bibl>Blain, Clements and Grundy: Feminist Companion to Literature in English (Yale, 1990)</bibl>

Example

<bibl> <title level="a">The Interesting story of the Children in the Wood</title>. In <author>Victor E Neuberg</author>, <title>The Penny Histories</title>. <publisher>OUP</publisher> <date>1968</date>. </bibl>

Example

<bibl type="article" subtype="book_chapter" xml:id="carlin_2003"> <author> <name> <surname>Carlin</surname> (<forename>Claire</forename>)</name> </author>, <title level="a">The Staging of Impotence : France’s last congrès</title> dans <bibl type="monogr"> <title level="m">Theatrum mundi : studies in honor of Ronald W. Tobin</title>, éd. <editor> <name> <forename>Claire</forename> <surname>Carlin</surname> </name> </editor> et <editor> <name> <forename>Kathleen</forename> <surname>Wine</surname> </name> </editor>, <pubPlace>Charlottesville, Va.</pubPlace>, <publisher>Rookwood Press</publisher>, <date when="2003">2003</date>. </bibl> </bibl>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.highlighted"/>
  <classRef key="model.pPart.data"/>
  <classRef key="model.pPart.edit"/>
  <classRef key="model.segLike"/>
  <classRef key="model.ptrLike"/>
  <classRef key="model.biblPart"/>
  <classRef key="model.global"/>
 </alternate>
</content>

Schema Declaration

element bibl
{
   att.global.attributes,
   att.declarable.attributes,
   att.typed.attributes,
   att.sortable.attributes,
   att.docStatus.attributes,
   attribute ref
   {
      "#Southey-ToADyingInfant"
    | "#Saussure-LEducationProgressive"
    | "#Combe-Physiology"
    | "#Blackwoods"
    | "#Bible"
   },
   (
      text
    | model.gLike
    | model.highlighted
    | model.pPart.data
    | model.pPart.edit
    | model.segLike
    | model.ptrLike
    | model.biblPart
    | model.global
   )*
}

1.34. <biblFull>

<biblFull> (fully-structured bibliographic citation) contains a fully-structured bibliographic citation, in which all components of the TEI file description are present. [3.11.1. Methods of Encoding Bibliographic References and Lists of References 2.2. The File Description 2.2.7. The Source Description 15.3.2. Declarable Elements]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default) att.sortable (@sortKey) att.docStatus (@status)
Member of	model.biblLike
Contained by	core: add del desc head hi l listBibl note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote sourceDesc tagUsage taxonomy linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout msItem musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: climate event location object occupation org person personGrp persona place population state terrain trait textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	header: editionStmt extent fileDesc notesStmt profileDesc publicationStmt seriesStmt sourceDesc titleStmt
Example	<biblFull> <titleStmt> <title>The Feminist Companion to Literature in English: women writers from the middle ages to the present</title> <author>Blain, Virginia</author> <author>Clements, Patricia</author> <author>Grundy, Isobel</author> </titleStmt> <editionStmt> <edition>UK edition</edition> </editionStmt> <extent>1231 pp</extent> <publicationStmt> <publisher>Yale University Press</publisher> <pubPlace>New Haven and London</pubPlace> <date>1990</date> </publicationStmt> <sourceDesc> <p>No source: this is an original work</p> </sourceDesc> </biblFull>
Content model	<content> <alternate> <sequence> <sequence> <elementRef key="titleStmt"/> <elementRef key="editionStmt" minOccurs="0"/> <elementRef key="extent" minOccurs="0"/> <elementRef key="publicationStmt"/> <elementRef key="seriesStmt" minOccurs="0"/> <elementRef key="notesStmt" minOccurs="0"/> </sequence> <elementRef key="sourceDesc" minOccurs="0" maxOccurs="unbounded"/> </sequence> <sequence> <elementRef key="fileDesc"/> <elementRef key="profileDesc"/> </sequence> </alternate> </content>
Schema Declaration	element biblFull { att.global.attributes, att.declarable.attributes, att.sortable.attributes, att.docStatus.attributes, ( ( ( titleStmt, editionStmt?, extent?, publicationStmt, seriesStmt?, notesStmt? ), sourceDesc* ) \| ( fileDesc, profileDesc ) ) }

1.35. <biblScope>

<biblScope> (scope of bibliographic reference) defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work. [3.11.2.5. Scopes and Ranges in Bibliographic Citations]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.citing (@unit, @from, @to)
Member of	model.imprintPart
Contained by	core: bibl header: seriesStmt
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	When a single page is being cited, use the from and to attributes with an identical value. When no clear endpoint is provided, the from attribute may be used without to; for example a citation such as ‘p. 3ff’ might be encoded `<biblScope from="3">p. 3ff<biblScope>`. It is now considered good practice to supply this element as a sibling (rather than a child) of <imprint>, since it supplies information which does not constitute part of the imprint.
Example	<biblScope>pp 12–34</biblScope> <biblScope unit="page" from="12" to="34"/> <biblScope unit="volume">II</biblScope> <biblScope unit="page">12</biblScope>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element biblScope { att.global.attributes, att.citing.attributes, macro.phraseSeq }

1.36. <binding>

<binding> contains a description of one binding, i.e. type of covering, boards, etc. applied to a manuscript or other object. [10.7.3.1. Binding Descriptions]

Module

msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))

contemporary

specifies whether or not the binding is contemporary with the majority of its contents

Status	Optional
Datatype	teidata.xTruthValue
Note	The value true indicates that the binding is contemporaneous with its contents; the value false that it is not. The value unknown should be used when the date of either binding or manuscript is unknown

Contained by

msdescription: bindingDesc

May contain

core: p

linking: ab

msdescription: condition decoNote

Example

<binding contemporary="true"> Contemporary blind stamped leather over wooden boards with evidence of a fore edge clasp closing to the back cover. </binding>

Example

<bindingDesc> <binding contemporary="false"> Quarter bound by the Phillipps' binder, Bretherton, with his sticker on the front pastedown. </binding> <binding contemporary="false"> Rebound by an unknown 19th c. company; edges cropped and gilt. </binding> </bindingDesc>

Content model

<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <classRef key="model.pLike"/>
  <elementRef key="condition"/>
  <elementRef key="decoNote"/>
 </alternate>
</content>

Schema Declaration

element binding
{
   att.global.attributes,
   att.datable.attributes,
   attribute contemporary { text }?,
   ( model.pLike | condition | decoNote )+
}

1.37. <bindingDesc>

<bindingDesc> (binding description) describes the present and former bindings of a manuscript or other object, either as a series of paragraphs or as a series of distinct <binding> elements, one for each binding of the manuscript. [10.7.3.1. Binding Descriptions]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.physDescPart
Contained by	msdescription: physDesc
May contain	core: p linking: ab msdescription: binding condition decoNote
Example	<bindingDesc> <p>Sewing not visible; tightly rebound over 19th-cent. pasteboards, reusing panels of 16th-cent. brown leather with gilt tooling à la fanfare, Paris c. 1580-90, the centre of each cover inlaid with a 17th-cent. oval medallion of red morocco tooled in gilt (perhaps replacing the identifying mark of a previous owner); the spine similarly tooled, without raised bands or title-piece; coloured endbands; the edges of the leaves and boards gilt.Boxed.</p> </bindingDesc>
Content model	<content> <alternate> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.pLike"/> <elementRef key="decoNote"/> <elementRef key="condition"/> </alternate> <elementRef key="binding" minOccurs="1" maxOccurs="unbounded"/> </alternate> </content>
Schema Declaration	element bindingDesc { att.global.attributes, ( ( model.pLike \| decoNote \| condition )+ \| binding+ ) }

1.38. <birth>

<birth> contains information about a person's birth, such as its date and place. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	caesarean (caesarean section) vaginal (vaginal delivery) exNihilo (ex nihilo) incorporated founded established

Member of

model.personPart

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<birth>Before 1920, Midlands region.</birth>

Example

<birth when="1960-12-10">In a small cottage near <name type="place">Aix-la-Chapelle</name>, early in the morning of <date>10 Dec 1960</date> </birth>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element birth
{
   att.global.attributes,
   att.editLike.attributes,
   att.datable.attributes,
   att.dimensions.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.phraseSeq
}

1.39. <bloc>

<bloc> contains the name of a geo-political unit consisting of two or more nation states or countries. [13.2.3. Place Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.placeNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef linking: ab seg msdescription: accMat acquisition additions altIdentifier catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<bloc type="union">the European Union</bloc> <bloc type="continent">Africa</bloc>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element bloc { att.global.attributes, att.naming.attributes, att.typed.attributes, att.datable.attributes, macro.phraseSeq }

1.40. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: bibl desc gap head l lb lg listBibl milestone note p pb q quote header: biblFull linking: ab alt altGrp anchor join joinGrp link linkGrp timeline msdescription: msDesc namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation tagdocs: classSpec constraintSpec dataSpec eg egXML elementSpec listRef macroSpec moduleSpec outputRendition schemaSpec specGrp specGrpRef textcrit: app listApp listWit witDetail textstructure: dateline div transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin
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> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> <sequence minOccurs="0"> <classRef key="model.divTop"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.global"/> <classRef key="model.divTop"/> </alternate> </sequence> <sequence minOccurs="0"> <classRef key="model.divGenLike"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.global"/> <classRef key="model.divGenLike"/> </alternate> </sequence> <alternate> <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> <sequence minOccurs="1" maxOccurs="unbounded"> <classRef key="model.common"/> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> </sequence> <alternate minOccurs="0"> <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.attributes, att.declaring.attributes, ( model.global, ( model.divTop, ( model.global \| model.divTop ) )?, ( model.divGenLike, ( model.global \| model.divGenLike )* )?, ( ( model.divLike, ( model.global \| model.divGenLike )* )+ \| ( model.div1Like, ( model.global \| model.divGenLike )* )+ \| ( ( model.common, model.global* )+, ( ( model.divLike, ( model.global \| model.divGenLike )* )+ \| ( model.div1Like, ( model.global \| model.divGenLike )* )+ )? ) ), ( model.divBottom, model.global* )* ) }

1.41. <c>

<c> (character) represents a character. [17.1. Linguistic Segment Categories]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation)
Member of	model.linePart model.segLike
Contained by	analysis: cl m pc phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	gaiji: g character data
Note	Contains a single character, a <g> element, or a sequence of graphemes to be treated as a single character. The type attribute is used to indicate the function of this segmentation, taking values such as letter, punctuation, or digit etc.
Example	<phr> <c>M</c> <c>O</c> <c>A</c> <c>I</c> <w>doth</w> <w>sway</w> <w>my</w> <w>life</w> </phr>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element c { att.global.attributes, att.segLike.attributes, att.typed.attributes, att.notated.attributes, macro.xtext }

1.42. <cRefPattern>

<cRefPattern> (canonical reference pattern) specifies an expression and replacement pattern for transforming a canonical reference into a URI. [2.3.6.3. Milestone Method 2.3.6. The Reference System Declaration 2.3.6.2. Search-and-Replace Method]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.patternReplacement (@matchPattern, @replacementPattern)
Contained by	header: refsDecl
May contain	core: p linking: ab
Note	The result of the substitution may be either an absolute or a relative URI reference. In the latter case it is combined with the value of xml:base in force at the place where the cRef attribute occurs to form an absolute URI in the usual manner as prescribed by XML Base.
Example	<cRefPattern matchPattern="([1-9A-Za-z]+)\s+([0-9]+):([0-9]+)" replacementPattern="#xpath(//div[@type='book'][@n='$1']/div[@type='chap'][@n='$2']/div[@type='verse'][@n='$3'])"/>
Content model	<content> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> </content>
Schema Declaration	element cRefPattern { att.global.attributes, att.patternReplacement.attributes, model.pLike* }

1.43. <caesura>

<caesura> marks the point at which a metrical line may be divided. [6.2. Components of the Verse Line]
Module	verse
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.lPart
Contained by	analysis: cl phr s w core: add author biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	Empty element
Example	<l>Hwæt we Gar-Dena <caesura/> in gear-dagum</l> <l>þeod-cyninga <caesura/> þrym gefrunon,</l> <l>hy ða æþelingas <caesura/> ellen fremedon.</l>
Content model	<content> <empty/> </content>
Schema Declaration	element caesura { att.global.attributes, empty }

1.44. <calendar>

<calendar> describes a calendar or dating system used in a dating formula in the text. [2.4.5. Calendar Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate)
Contained by	header: calendarDesc
May contain	core: p linking: ab
Example	<calendarDesc> <calendar xml:id="julianEngland"> <p>Julian Calendar (including proleptic)</p> </calendar> </calendarDesc>
Example	<calendarDesc> <calendar xml:id="egyptian" target="http://en.wikipedia.org/wiki/Egyptian_calendar"> <p>Egyptian calendar (as defined by Wikipedia)</p> </calendar> </calendarDesc>
Content model	<content> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element calendar { att.global.attributes, att.pointing.attributes, model.pLike+ }

1.45. <calendarDesc>

<calendarDesc> (calendar description) contains a description of the calendar system used in any dating expression found in the text. [2.4. The Profile Description 2.4.5. Calendar Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.profileDescPart
Contained by	header: profileDesc
May contain	header: calendar
Note	In the first example above, calendars and short codes for xml:ids are from W3 guidelines at http://www.w3.org/TR/xpath-functions-11/#lang-cal-country
Example	<calendarDesc> <calendar xml:id="cal_AD"> <p>Anno Domini (Christian Era)</p> </calendar> <calendar xml:id="cal_AH"> <p>Anno Hegirae (Muhammedan Era)</p> </calendar> <calendar xml:id="cal_AME"> <p>Mauludi Era (solar years since Mohammed's birth)</p> </calendar> <calendar xml:id="cal_AM"> <p>Anno Mundi (Jewish Calendar)</p> </calendar> <calendar xml:id="cal_AP"> <p>Anno Persici</p> </calendar> <calendar xml:id="cal_AS"> <p>Aji Saka Era (Java)</p> </calendar> <calendar xml:id="cal_BE"> <p>Buddhist Era</p> </calendar> <calendar xml:id="cal_CB"> <p>Cooch Behar Era</p> </calendar> <calendar xml:id="cal_CE"> <p>Common Era</p> </calendar> <calendar xml:id="cal_CL"> <p>Chinese Lunar Era</p> </calendar> <calendar xml:id="cal_CS"> <p>Chula Sakarat Era</p> </calendar> <calendar xml:id="cal_EE"> <p>Ethiopian Era</p> </calendar> <calendar xml:id="cal_FE"> <p>Fasli Era</p> </calendar> <calendar xml:id="cal_ISO"> <p>ISO 8601 calendar</p> </calendar> <calendar xml:id="cal_JE"> <p>Japanese Calendar</p> </calendar> <calendar xml:id="cal_KE"> <p>Khalsa Era (Sikh calendar)</p> </calendar> <calendar xml:id="cal_KY"> <p>Kali Yuga</p> </calendar> <calendar xml:id="cal_ME"> <p>Malabar Era</p> </calendar> <calendar xml:id="cal_MS"> <p>Monarchic Solar Era</p> </calendar> <calendar xml:id="cal_NS"> <p>Nepal Samwat Era</p> </calendar> <calendar xml:id="cal_OS"> <p>Old Style (Julian Calendar)</p> </calendar> <calendar xml:id="cal_RS"> <p>Rattanakosin (Bangkok) Era</p> </calendar> <calendar xml:id="cal_SE"> <p>Saka Era</p> </calendar> <calendar xml:id="cal_SH"> <p>Mohammedan Solar Era (Iran)</p> </calendar> <calendar xml:id="cal_SS"> <p>Saka Samvat</p> </calendar> <calendar xml:id="cal_TE"> <p>Tripurabda Era</p> </calendar> <calendar xml:id="cal_VE"> <p>Vikrama Era</p> </calendar> <calendar xml:id="cal_VS"> <p>Vikrama Samvat Era</p> </calendar> </calendarDesc>
Example	<calendarDesc> <calendar xml:id="cal_Gregorian"> <p>Gregorian calendar</p> </calendar> <calendar xml:id="cal_Julian"> <p>Julian calendar</p> </calendar> <calendar xml:id="cal_Islamic"> <p>Islamic or Muslim (hijri) lunar calendar</p> </calendar> <calendar xml:id="cal_Hebrew"> <p>Hebrew or Jewish lunisolar calendar</p> </calendar> <calendar xml:id="cal_Revolutionary"> <p>French Revolutionary calendar</p> </calendar> <calendar xml:id="cal_Iranian"> <p>Iranian or Persian (Jalaali) solar calendar</p> </calendar> <calendar xml:id="cal_Coptic"> <p>Coptic or Alexandrian calendar</p> </calendar> <calendar xml:id="cal_Chinese"> <p>Chinese lunisolar calendar</p> </calendar> </calendarDesc>
Example	<calendarDesc> <calendar xml:id="cal_Egyptian" target="http://en.wikipedia.org/wiki/Egyptian_calendar"> <p>Egyptian calendar (as defined by Wikipedia)</p> </calendar> </calendarDesc>
Content model	<content> <elementRef key="calendar" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element calendarDesc { att.global.attributes, calendar+ }

1.46. <catDesc>

<catDesc> (category description) describes some category within a taxonomy or text typology, either in the form of a brief prose description or in terms of the situational parameters used by the TEI formal <textDesc>. [2.3.7. The Classification Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: category
May contain	core: address choice date email hi name ref time title header: idno msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val transcr: am ex subst character data
Example	<catDesc>Prose reportage</catDesc>
Example	<catDesc> <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> </catDesc>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.limitedPhrase"/> <classRef key="model.catDescPart"/> </alternate> </content>
Schema Declaration	element catDesc { att.global.attributes, ( text \| model.limitedPhrase \| model.catDescPart )* }

1.47. <catRef>

<catRef> (category reference) specifies one or more defined categories within some taxonomy or text typology. [2.4.3. The Text Classification]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate)

scheme

identifies the classification scheme within which the set of categories concerned is defined, for example by a <taxonomy> element, or by some other resource.

Status	Optional
Datatype	teidata.pointer

Contained by

header: textClass

May contain

Empty element

Note

The scheme attribute needs to be supplied only if more than one taxonomy has been declared.

Example

<catRef scheme="#myTopics" target="#news #prov #sales2"/>  <taxonomy xml:id="myTopics"> <category xml:id="news"> <catDesc>Newspapers</catDesc> </category> <category xml:id="prov"> <catDesc>Provincial</catDesc> </category> <category xml:id="sales2"> <catDesc>Low to average annual sales</catDesc> </category> </taxonomy>

Content model

<content>
 <empty/>
</content>

Schema Declaration

element catRef
{
   att.global.attributes,
   att.pointing.attributes,
   attribute scheme { text }?,
   empty
}

1.48. <catchwords>

<catchwords> describes the system used to ensure correct ordering of the quires or similar making up a codex, incunable, or other object typically by means of annotations at the foot of the page. [10.3.7. Catchwords, Signatures, Secundo Folio]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<catchwords>Vertical catchwords in the hand of the scribe placed along the inner bounding line, reading from top to bottom.</catchwords>
Schematron	<sch:assert test="ancestor::tei:msDesc or ancestor::tei:egXML">The <sch:name/> element should not be used outside of msDesc.</sch:assert>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element catchwords { att.global.attributes, macro.phraseSeq }

1.49. <category>

<category> contains an individual descriptive category, possibly nested within a superordinate category, within a user-defined taxonomy. [2.3.7. The Classification Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: category taxonomy
May contain	core: desc header: catDesc category tagdocs: altIdent equiv
Example	<category xml:id="b1"> <catDesc>Prose reportage</catDesc> </category>
Example	<category xml:id="b2"> <catDesc>Prose </catDesc> <category xml:id="b11"> <catDesc>journalism</catDesc> </category> <category xml:id="b12"> <catDesc>fiction</catDesc> </category> </category>
Example	<category xml:id="LIT"> <catDesc xml:lang="pl">literatura piękna</catDesc> <catDesc xml:lang="en">fiction</catDesc> <category xml:id="LPROSE"> <catDesc xml:lang="pl">proza</catDesc> <catDesc xml:lang="en">prose</catDesc> </category> <category xml:id="LPOETRY"> <catDesc xml:lang="pl">poezja</catDesc> <catDesc xml:lang="en">poetry</catDesc> </category> <category xml:id="LDRAMA"> <catDesc xml:lang="pl">dramat</catDesc> <catDesc xml:lang="en">drama</catDesc> </category> </category>
Content model	<content> <sequence> <alternate> <elementRef key="catDesc" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.descLike"/> <classRef key="model.glossLike"/> </alternate> </alternate> <elementRef key="category" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element category { att.global.attributes, ( ( catDesc+ \| ( model.descLike \| model.glossLike )* ), category* ) }

1.50. <certainty>

<certainty> indicates the degree of certainty associated with some aspect of the text markup. [21.1.2. Structured Indications of Uncertainty]

Module

certainty

Attributes

Attributes att.scoping (@target, @match) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.analytic (@ana) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (cert, @resp) att.global.source (@source)

cert

(certainty) signifies the degree of certainty associated with the object pointed to by the <certainty> element.

Derived from	att.global.responsibility
Status	Optional
Datatype	teidata.certainty

locus

indicates more exactly the aspect concerning which certainty is being expressed: specifically, whether the markup is correctly located, whether the correct element or attribute name has been used, or whether the content of the element or attribute is correct, etc.

Status	Required
Datatype	teidata.enumerated
Legal values are:	name uncertainty concerns whether the name of the element or attribute used is correctly applied. start uncertainty concerns whether the start of the element is correctly identified. end uncertainty concerns whether the end of the element is correctly identified. location uncertainty concerns both the start and the end of the element. value uncertainty concerns the content (for an element) or the value (for an attribute)

assertedValue

provides an alternative value for the aspect of the markup in question—an alternative generic identifier, transcription, or attribute value, or the identifier of an <anchor> element (to indicate an alternative starting or ending location). If an assertedValue is given, the confidence level specified by degree applies to the alternative markup specified by assertedValue; if none is given, it applies to the markup in the text.

Status	Recommended
Datatype	teidata.word
<certainty target="#ESX" locus="name" assertedValue="placeName" cert="low"> <desc>It is unlikely, but possible, that this refers to the place rather than the person.</desc> </certainty>
Note	This attribute makes it possible to indicate the degree of confidence in a specific alternative to some aspect of the markup. In the first example above the encoder is expressing the likelihood (.2) that the generic identifier should be <placeName> rather than <persName>, which is the coded element.

given

indicates one or more element(s) characterizing the conditions which are assumed in the assignment of a degree of confidence.

Status

Recommended

Datatype

1–∞ occurrences of teidata.pointer separated by whitespace

Note

The envisioned typical value of this attribute would be the identifier of another <certainty> element or a list of such identifiers. It may thus be possible to construct probability networks by chaining <certainty> elements together. Such networks would ultimately be grounded in unconditional <certainty> elements (with no value for given). The semantics of this chaining would be understood in this way: if a <certainty> element is specified, via a reference, as the assumption, then it is not the attribution of uncertainty that is the assumption, but rather the assertion itself. For instance, in the example above, the first <certainty> element indicates that the confidence in the identification of the new scribe as msm. The second indicates the degree of confidence that Essex is a personal name, given that the new scribe is msm. Note that the given in the second <certainty> element is not the assertion that the likelihood that msm is the new scribe is 0.6, but simply the assertion that msm is the new scribe; this is a recommended convention to facilitate building networks.

The ambitious encoder may wish to attempt complex networks or probability assertions, experimenting with references to other elements or prose assertions, and deploying feature structure connectives such as <alt>, <join>, and <note>. However, we do not believe that the <certainty> element gives, at this time, a comprehensive ambiguity-free system for indicating certainty.

degree

indicates the degree of confidence assigned to the aspect of the markup named by the locus attribute.

Status	Optional
Datatype	teidata.probability

Member of

model.certLike model.global.meta

Contained by

analysis: cl interp m phr s span w

certainty: certainty precision respons

core: add address author bibl biblScope date del editor email gap head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab join seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc space substJoin supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

certainty: certainty precision respons

core: desc

Example

(For discussion of this example, see section [[undefined CEconcon]])

Ernest went to <anchor xml:id="A1"/> old <persName xml:id="SYB">Saybrook</persName>. <certainty xml:id="c1" target="#SYB" locus="name" degree="0.6"/> <certainty target="#SYB" locus="start" given="#c1" degree="0.9"/> <certainty xml:id="C-c2" target="#SYB" locus="name" assertedValue="persName" degree="0.4"/> <certainty target="#SYB" locus="start" given="#C-c2" degree="0.5"/> <certainty target="#SYB" locus="start" assertedValue="#a1" given="#c1" degree="0.5"/>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>

Schema Declaration

element certainty
{
   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.linking.attribute.corresp,
   att.global.linking.attribute.synch,
   att.global.linking.attribute.sameAs,
   att.global.linking.attribute.copyOf,
   att.global.linking.attribute.next,
   att.global.linking.attribute.prev,
   att.global.linking.attribute.exclude,
   att.global.linking.attribute.select,
   att.global.analytic.attribute.ana,
   att.global.facs.attribute.facs,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.resp,
   att.global.source.attribute.source,
   att.scoping.attributes,
   attribute cert { text }?,
   attribute locus { "name" | "start" | "end" | "location" | "value" },
   attribute assertedValue { text }?,
   attribute given { list { + } }?,
   attribute degree { text }?,
   ( model.descLike | model.certLike )*
}

1.51. <change>

<change> documents a change or set of changes made during the production of a source document, or during the revision of an electronic file. [2.6. The Revision Description 2.4.1. Creation 11.7. Identifying Changes and Revisions]

Module

header

Attributes

Attributes att.ascribed (@who) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.docStatus (@status) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)

target

points to one or more elements that belong to this change.

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

Contained by

header: listChange revisionDesc

msdescription: recordHist

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Note

The who attribute may be used to point to any other element, but will typically specify a <respStmt> or <person> element elsewhere in the header, identifying the person responsible for the change and their role in making it.

It is recommended that changes be recorded with the most recent first. The status attribute may be used to indicate the status of a document following the change documented.

Example

<titleStmt> <title> ... </title> <editor xml:id="LDB">Lou Burnard</editor> <respStmt xml:id="BZ"> <resp>copy editing</resp> <name>Brett Zamir</name> </respStmt> </titleStmt>  <revisionDesc status="published"> <change who="#BZ" when="2008-02-02" status="public">Finished chapter 23</change> <change who="#BZ" when="2008-01-02" status="draft">Finished chapter 2</change> <change n="P2.2" when="1991-12-21" who="#LDB">Added examples to section 3</change> <change when="1991-11-11" who="#MSM">Deleted chapter 10</change> </revisionDesc>

Example

<profileDesc> <creation> <listChange> <change xml:id="DRAFT1">First draft in pencil</change> <change xml:id="DRAFT2" notBefore="1880-12-09">First revision, mostly using green ink</change> <change xml:id="DRAFT3" notBefore="1881-02-13">Final corrections as supplied to printer.</change> </listChange> </creation> </profileDesc>

Content model

<content>
 <macroRef key="macro.specialPara"/>
</content>

Schema Declaration

element change
{
   att.ascribed.attributes,
   att.datable.attributes,
   att.docStatus.attributes,
   att.global.attributes,
   att.typed.attributes,
   attribute target { list { + } }?,
   macro.specialPara
}

1.52. <char>

<char> (character) provides descriptive information about a character. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	gaiji: charDecl
May contain	core: desc note gaiji: charName charProp mapping
Example	<char xml:id="circledU4EBA"> <charName>CIRCLED IDEOGRAPH 4EBA</charName> <charProp> <unicodeName>character-decomposition-mapping</unicodeName> <value>circle</value> </charProp> <charProp> <localName>daikanwa</localName> <value>36</value> </charProp> <mapping type="standard">人</mapping> </char>
Content model	<content> <sequence> <elementRef key="charName" minOccurs="0"/> <classRef key="model.descLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="charProp" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="mapping" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="figure" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.graphicLike" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.noteLike" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element char { att.global.attributes, ( charName?, model.descLike, charProp, mapping, figure, model.graphicLike, model.noteLike ) }

1.53. <charDecl>

<charDecl> (character declarations) provides information about nonstandard characters and glyphs. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	core: desc gaiji: char glyph
Example	<charDecl> <char xml:id="aENL"> <charName>LATIN LETTER ENLARGED SMALL A</charName> <mapping type="standard">a</mapping> </char> </charDecl>
Content model	<content> <sequence> <elementRef key="desc" minOccurs="0"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="char"/> <elementRef key="glyph"/> </alternate> </sequence> </content>
Schema Declaration	element charDecl { att.global.attributes, ( desc?, ( char \| glyph )+ ) }

1.54. <charName>

<charName> (character name) contains the name of a character, expressed following Unicode conventions. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	gaiji: char
May contain	Character data only
Note	The name must follow Unicode conventions for character naming. Projects working in similar fields are recommended to coordinate and publish their list of <charName>s to facilitate data exchange.
Example	<charName>CIRCLED IDEOGRAPH 4EBA</charName>
Content model	<content> <textNode/> </content>
Schema Declaration	element charName { att.global.attributes, text }

1.55. <charProp>

<charProp> (character property) provides a name and value for some property of the parent character or glyph. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Contained by	gaiji: char glyph
May contain	gaiji: localName unicodeName value
Note	If the property is a Unicode Normative Property, then its <unicodeName> must be supplied. Otherwise, its name must be specied by means of a <localName>. At a later release, additional constraints will be defined on possible value/name combinations using Schematron rules
Example	<charProp> <unicodeName>character-decomposition-mapping</unicodeName> <value>circle</value> </charProp> <charProp> <localName>daikanwa</localName> <value>36</value> </charProp>
Content model	<content> <sequence> <alternate> <elementRef key="unicodeName"/> <elementRef key="localName"/> </alternate> <elementRef key="value"/> </sequence> </content>
Schema Declaration	element charProp { att.global.attributes, att.typed.attributes, ( ( unicodeName \| localName ), value ) }

1.56. <choice>

<choice> groups a number of alternative encodings for the same point in a text. [3.4. Simple Editorial Changes]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.linePart model.pPart.editorial
Contained by	analysis: cl pc phr s span w core: add author bibl biblScope choice date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw line metamark mod restore retrace secl supplied surplus zone verse: metSym rhyme
May contain	core: choice reg sic unclear linking: seg transcr: am ex supplied
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> <alternate minOccurs="2" maxOccurs="unbounded"> <classRef key="model.choicePart"/> <elementRef key="choice"/> </alternate> </content>
Schema Declaration	element choice { att.global.attributes, ( model.choicePart \| choice )+ }

1.57. <cl>

<cl> (clause) represents a grammatical clause. [17.1. Linguistic Segment Categories]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation)
Member of	model.segLike
Contained by	analysis: cl phr s core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The type attribute may be used to indicate the type of clause, taking values such as finite, nonfinite, declarative, interrogative, relative etc. as appropriate.
Example	<cl type="relative" function="clause_modifier">Which frightened both the heroes so,<cl>They quite forgot their quarrel.</cl> </cl>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element cl { att.global.attributes, att.segLike.attributes, att.typed.attributes, att.notated.attributes, macro.phraseSeq }

1.58. <classCode>

<classCode> (classification code) contains the classification code used for this text in some standard classification system. [2.4.3. The Text Classification]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

scheme

identifies the classification system in use, as defined by, e.g. a <taxonomy> element, or some other resource.

Status	Required
Datatype	teidata.pointer

Contained by

header: textClass

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: address choice date email gap hi lb milestone name note pb ref time title

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident tag val

textcrit: app witDetail

transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin

character data

Example

Content model

<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>

Schema Declaration

element classCode
{
   att.global.attributes,
   attribute scheme { text },
   macro.phraseSeq.limited
}

1.59. <classDecl>

<classDecl> (classification declarations) contains one or more taxonomies defining any classificatory codes used elsewhere in the text. [2.3.7. The Classification Declaration 2.3. The Encoding Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	header: taxonomy
Example	<classDecl> <taxonomy xml:id="LCSH"> <bibl>Library of Congress Subject Headings</bibl> </taxonomy> </classDecl> <!-- ... --> <textClass> <keywords scheme="#LCSH"> <term>Political science</term> <term>United States -- Politics and government — Revolution, 1775-1783</term> </keywords> </textClass>
Content model	<content> <elementRef key="taxonomy" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element classDecl { att.global.attributes, taxonomy+ }

1.60. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.repeatable (@minOccurs, @maxOccurs)

key

the identifier used for the required class within the source indicated.

Status	Required
Datatype	teidata.xmlName

expand

indicates how references to this class within a content model should be interpreted.

Status	Optional
Legal values are:	alternation any one member of the class may appear sequence a single occurrence of all members of the class may appear in sequence sequenceOptional a single occurrence of one or more members of the class may appear in sequence sequenceOptionalRepeatable one or more occurrences of one or more members of the class may appear in sequence. sequenceRepeatable one or more occurrences of all members of the class may appear in sequence
Note	If the members of the class are a, b and c, then a reference to the class within a content model is understood as being a reference to `a\|b\|c` when expand is omitted or has the value alternation; to `a,b,c` when it has the value sequence; to `(a?,b?,c?)` when it has the value sequenceOptional; to `(a,b,c*)` when it has the value sequenceOptionalRepeatable; or to `(a+,b+,c+)` when it has the value sequenceRepeatable.

include

supplies a list of class members which are to be included in the schema being defined.

Status	Optional
Datatype	0–∞ occurrences of teidata.xmlName separated by whitespace

except

supplies a list of class members which are to be excluded from the schema being defined.

Status	Optional
Datatype	0–∞ occurrences of teidata.xmlName separated by whitespace

Member of

Contained by

tagdocs: alternate content schemaSpec sequence specGrp

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

Content model

<content>
 <empty/>
</content>

Schema Declaration

element classRef
{
   att.global.attributes,
   att.repeatable.attributes,
   attribute key { text },
   attribute expand
   {
      "alternation"
    | "sequence"
    | "sequenceOptional"
    | "sequenceOptionalRepeatable"
    | "sequenceRepeatable"
   }?,
   ( attribute include { list { * } }? | attribute except { list { * } }? ),
   empty
}

1.61. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) )

type

indicates whether this is a model class or an attribute class

Status	Required
Datatype	teidata.enumerated
Legal values are:	model (content model) members of this class appear in the same content models atts (attributes) members of this class share common attributes

generate

indicates which alternation and sequence instantiations of a model class may be referenced. By default, all variations are permitted.

Status	Optional
Datatype	1–5 occurrences of teidata.enumerated separated by whitespace
Legal values are:	alternation members of the class are alternatives sequence members of the class are to be provided in sequence sequenceOptional members of the class may be provided, in sequence, but are optional sequenceOptionalRepeatable members of the class may be provided one or more times, in sequence, but are optional. sequenceRepeatable members of the class may be provided one or more times, in sequence

Member of

Contained by

core: add del desc head hi l note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote tagUsage

linking: ab seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: schemaSpec specGrp

textcrit: lem rdg witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

core: desc

tagdocs: altIdent attList classes constraintSpec equiv exemplum listRef remarks

Example

<classSpec module="tei" type="model" ident="model.segLike"> <desc>groups elements used for arbitrary segmentation.</desc> <classes> <memberOf key="model.phrase"/> </classes> <remarks> 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. </remarks> </classSpec>

Content model

<content>
 <sequence>
  <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.attributes,
   att.identified.attributes,
   attribute type { "model" | "atts" },
   attribute generate
   {
      list
      {
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         ),
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?,
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?,
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?,
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?
      }
   }?,
   (
      ( model.glossLike | model.descLike )*,
      classes?,
      constraintSpec*,
      attList?,
      exemplum*,
      remarks*,
      listRef*
   )
}

1.62. <classes>

<classes> specifies all the classes of which the documented element or class is a member or subclass. [22.5. Element Specifications 22.6. Class Specifications]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

mode

specifies the effect of this declaration on its parent module.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	change this declaration changes the declaration of the same name in the current definition replace this declaration replaces the declaration of the same name in the current definition[Default]

Contained by

tagdocs: classSpec elementSpec

May contain

tagdocs: memberOf

Note

An empty <classes> element indicates that the element documented is not a member of any class. This should not generally happen.

Example

This <classes> element indicates that the element documented (which may be an element or a class) is a member of two distinct classes: model.qLike and att.declarable.

Content model

<content>
 <elementRef key="memberOf" minOccurs="0"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element classes
{
   att.global.attributes,
   attribute mode { "change" | "replace" }?,
   memberOf*
}

1.63. <climate>

<climate> contains information about the physical climate of a place. [13.3.4.3. States, Traits, and Events]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype)
Member of	model.placeStateLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc climate country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	certainty: precision core: bibl desc head listBibl note p header: biblFull linking: ab msdescription: msDesc namesdates: climate
Example	<place xml:id="ROMA"> <placeName>Rome</placeName> <!-- ... --> <climate> <ab> <table> <head>24-hr Average Temperature</head> <row> <cell/> <cell role="label">Jan</cell> <cell role="label">Jun</cell> <cell role="label">Dec</cell> </row> <row> <cell role="label">°C</cell> <cell role="data">7.1</cell> <cell role="data">21.7</cell> <cell role="data">8.3</cell> </row> <row> <cell role="label">°F</cell> <cell role="data">44.8</cell> <cell role="data">71.1</cell> <cell role="data">46.9</cell> </row> </table> </ab> <note>Taken from <bibl> <abbr>GHCN 2 Beta</abbr>: The Global Historical Climatology Network, version 2 beta, 1904 months between 1811 and 1980. <ptr target="http://www.worldclimate.com/cgi-bin/data.pl?ref=N41E012+1202+0004058G2"/> </bibl> </note> </climate> </place>
Content model	<content> <sequence> <elementRef key="precision" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.labelLike" minOccurs="1" maxOccurs="unbounded"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> <elementRef key="climate" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element climate { att.global.attributes, att.datable.attributes, att.editLike.attributes, att.naming.attributes, att.typed.attributes, ( precision, model.headLike, ( model.pLike+ \| model.labelLike+ ), ( model.noteLike \| model.biblLike ), climate ) }

1.64. <code>

<code> contains literal code from some formal language such as a programming language. [22.1.1. Phrase Level Terms]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

lang

(formal language) a name identifying the formal language in which the code is expressed

Status	Optional
Datatype	teidata.word

Member of

model.emphLike

Contained by

analysis: cl phr s span

core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

Character data only

Example

<code lang="JAVA"> Size fCheckbox1Size = new Size(); fCheckbox1Size.Height = 500; fCheckbox1Size.Width = 500; xCheckbox1.setSize(fCheckbox1Size); </code>

Content model

<content>
 <textNode/>
</content>

Schema Declaration

element code { att.global.attributes, attribute lang { text }?, text }

1.65. <collation>

<collation> contains a description of how the leaves, bifolia, or similar objects are physically arranged. [10.7.1. Object Description]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: supportDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<collation>The written leaves preceded by an original flyleaf, conjoint with the pastedown.</collation>
Example	<collation> <p> <formula>1-5.8 6.6 (catchword, f. 46, does not match following text) 7-8.8 9.10, 11.2 (through f. 82) 12-14.8 15.8(-7)</formula> <catchwords>Catchwords are written horizontally in center or towards the right lower margin in various manners: in red ink for quires 1-6 (which are also signed in red ink with letters of the alphabet and arabic numerals); quires 7-9 in ink of text within yellow decorated frames; quire 10 in red decorated frame; quire 12 in ink of text; quire 13 with red decorative slashes; quire 14 added in cursive hand.</catchwords> </p> </collation>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element collation { att.global.attributes, macro.specialPara }

1.66. <collection>

<collection> contains the name of a collection of manuscripts or other objects, not necessarily located within a single repository. [10.4. The Manuscript Identifier]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype)
Contained by	msdescription: altIdentifier msIdentifier namesdates: objectIdentifier
May contain	gaiji: g character data
Example	<msIdentifier> <country>USA</country> <region>California</region> <settlement>San Marino</settlement> <repository>Huntington Library</repository> <collection>Ellesmere</collection> <idno>El 26 C 9</idno> <msName>The Ellesmere Chaucer</msName> </msIdentifier>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element collection { att.global.attributes, att.naming.attributes, att.typed.attributes, macro.xtext }

1.67. <colophon>

<colophon> contains the colophon of an item: that is, a statement providing information regarding the date, place, agency, or reason for production of the manuscript or other object. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.msExcerpt (@defective)
Member of	model.msQuoteLike
Contained by	msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<colophon>Ricardus Franciscus Scripsit Anno Domini 1447.</colophon>
Example	<colophon>Explicit expliceat/scriptor ludere eat.</colophon>
Example	<colophon>Explicit venenum viciorum domini illius, qui comparavit Anno domini Millessimo Trecentesimo nonagesimo primo, Sabbato in festo sancte Marthe virginis gloriose. Laus tibi criste quia finitur libellus iste.</colophon>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element colophon { att.global.attributes, att.msExcerpt.attributes, macro.phraseSeq }

1.68. <condition>

<condition> contains a description of the physical condition of the manuscript or object. [10.7.1.5. Condition]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: binding bindingDesc sealDesc supportDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<condition> <p>There are lacunae in three places in this manuscript. After 14v two leaves has been cut out and narrow strips leaves remains in the spine. After 68v one gathering is missing and after 101v at least one gathering of 8 leaves has been lost. </p> <p>Several leaves are damaged with tears or holes or have a irregular shape. Some of the damages do not allow the lines to be of full length and they are apparently older than the script. There are tears on fol. 2r-v, 9r-v, 10r-v, 15r-18v, 19r-v, 20r-22v, 23r-v, 24r-28v, 30r-v, 32r-35v, 37r-v, 38r-v, 40r-43v, 45r-47v, 49r-v, 51r-v, 53r-60v, 67r-v, 68r-v, 70r-v, 74r-80v, 82r-v, 86r-v, 88r-v, 89r-v, 95r-v, 97r-98v 99r-v, 100r-v. On fol. 98 the corner has been torn off. Several leaves are in a bad condition due to moist and wear, and have become dark, bleached or wrinkled. </p> <p>The script has been touched up in the 17th century with black ink. The touching up on the following fols. was done by <name>Bishop Brynjólf Sveinsson</name>: 1v, 3r, 4r, 5r, 6v, 8v,9r, 10r, 14r, 14v, 22r,30v, 36r-52v, 72v, 77r,78r,103r, 104r,. An AM-note says according to the lawman <name>Sigurður Björnsson</name> that the rest of the touching up was done by himself and another lawman <name>Sigurður Jónsson</name>. <name>Sigurður Björnsson</name> did the touching up on the following fols.: 46v, 47r, 48r, 49r-v, 50r, 52r-v. <name>Sigurður Jónsson</name> did the rest of the touching up in the section 36r-59r containing <title>Bretasögur</title> </p> </condition>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element condition { att.global.attributes, macro.specialPara }

1.69. <constraint>

<constraint> (constraint rules) the formal rules of a constraint [22.5. Element Specifications]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	tagdocs: constraintSpec
May contain	Character data only
Example	<constraintSpec ident="isoconstraint" scheme="schematron" xmlns:sch="http://purl.oclc.org/dsdl/schematron"> <constraint> <s:assert test="tei:fileDesc/tei:titleStmt/tei:title[@type='main']"> a main title must be supplied </s:assert> </constraint> </constraintSpec>
Example	<constraintSpec ident="local" scheme="private"> <constraint> (output = (ident(title) ident(author) "You must supply a title or an author")) </constraint> </constraintSpec>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <anyElement/> </alternate> </content>
Schema Declaration	element constraint { att.global.attributes, ( text \| anyElement-constraint )* }

1.70. <constraintSpec>

<constraintSpec> (constraint on schema) contains a formal constraint, typically expressed in a rule-based schema language, to which a construct must conform in order to be considered valid [22.5. Element Specifications]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) ) att.typed (type, @subtype)

type

characterizes the <constraintSpec> element in some sense; used to indicate when a <constraintSpec> warns about a deprecated construct.

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	deprecationWarning Indicates that this constraint specification warns that some other construct in the schema is deprecated.

scheme

supplies the name of the language in which the constraints are defined

Status	Required
Datatype	teidata.enumerated
Suggested values include:	schematron (ISO Schematron)
Note	These Guidelines no longer recommend, and the available TEI stylesheets no longer support, the use of Schematron 1.x within <constraintSpec>. Thus the value schematron is used to indicate that ISO Schematron is used within the <constraintSpec>.

Member of

Contained by

core: add del desc head hi l note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote tagUsage

linking: ab seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: attDef classSpec dataSpec elementSpec macroSpec schemaSpec specGrp

textcrit: lem rdg witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

core: desc

tagdocs: altIdent constraint equiv

Example

This constraint uses Schematron to enforce the presence of the spanTo attribute (which comes from an attribute class) on the <addSpan> element:

<constraintSpec ident="demo-c1" scheme="schematron" xmlns:sch="http://purl.oclc.org/dsdl/schematron"> <desc>Enforce the presence of the <att>spanTo</att> attribute</desc> <constraint> <sch:assert test="@spanTo">The spanTo= attribute of <sch:name/> is required.</sch:assert> </constraint> </constraintSpec>

Example

<constraintSpec ident="demo-c2" scheme="schematron" xmlns:sch="http://purl.oclc.org/dsdl/schematron"> <desc>Implement an accessibility rule which says that pictures should have textual explanations</desc> <constraint> <sch:report test="not(tei:figDesc or tei:head)"> You should provide information in a figure from which we can construct an alt attribute in HTML </sch:report> </constraint> </constraintSpec>

Example

This constraint uses SPITBOL (a language which is not expressed in XML) to check whether the title and author are identical:

<constraintSpec ident="local" scheme="SPITBOL"> <constraint> (output = leq(title,author) "title and author cannot be the same") </constraint> </constraintSpec>

Schematron

Relationship between scheme attribute and contents: Schematron 1.x

<sch:ns prefix="s" uri="http://www.ascc.net/xml/schematron"/> <sch:report test="tei:constraint/s:* and @scheme = ('isoschematron','schematron')">Rules in the Schematron 1.* language must be inside a constraintSpec with a value other than 'schematron' or 'isoschematron' on the scheme attribute</sch:report>

Schematron

Relationship between scheme attribute and contents: ISO Schematron

<sch:ns prefix="sch" uri="http://purl.oclc.org/dsdl/schematron"/> <sch:report test="tei:constraint/sch:* and not( @scheme eq 'schematron')">Rules in the ISO Schematron language must be inside a constraintSpec with the value 'schematron' on the scheme attribute</sch:report>

Schematron

<sch:ns prefix="sch" uri="http://purl.oclc.org/dsdl/schematron"/> <sch:rule context="tei:macroSpec/tei:constraintSpec[@scheme eq 'schematron']/tei:constraint"> <sch:report test="sch:assert|sch:report">An ISO Schematron constraint specification for a macro should not have an 'assert' or 'report' element without a parent 'rule' element</sch:report> </sch:rule>

Content model

<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="constraint"
   minOccurs="0"/>
 </sequence>
</content>

Schema Declaration

element constraintSpec
{
   att.global.attributes,
   att.identified.attributes,
   att.typed.attribute.subtype,
   attribute type { "deprecationWarning" }?,
   attribute scheme { "schematron" },
   ( ( model.glossLike | model.descLike )*, constraint? )
}

1.71. <content>

<content> (content model) contains a declaration of the intended content model for the element (or other construct) being specified. [22.5. Element Specifications]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

autoPrefix

controls whether or not pattern names generated in the corresponding RELAX NG schema source are automatically prefixed to avoid potential nameclashes.

Status	Optional
Datatype	teidata.truthValue
Legal values are:	true Each name referenced in e.g. a <rng:ref> element within a content model is automatically prefixed by the value of the prefix attribute on the current <schemaSpec>[Default] false No prefixes are added: any prefix required by the value of the prefix attribute on the current <schemaSpec> must therefore be supplied explicitly, as appropriate.

Contained by

tagdocs: dataSpec elementSpec macroSpec moduleRef

May contain

tagdocs: alternate anyElement classRef dataRef elementRef empty macroRef sequence textNode valList

Note

As the example shows, content models may be expressed using the RELAX NG syntax directly. To avoid ambiguity when schemas using elements from different namespaces are created, the name supplied for an element in a content model will be automatically prefixed by a short string, as specified by the prefix attribute on <schemaSpec>. The autoPrefix attribute may be used to reverse this behaviour.

Alternatively, a content model may be expressed using the TEI <valList> element.

Example

This <content> element indicates that the element being specified has no content:

Example

This <content> element defines a content model allowing either a sequence of paragraphs or a series of msItem elements optionally preceded by a summary:

Example

This content model defines a content model allowing either a sequence of paragraphs or a series of msItem elements optionally preceded by a summary:

Schematron

Use a child <empty> element to indicate that the element being specified is not allowed to have content.

<sch:assert test="*">The use of the <content> element without any child elements is deprecated, and will be considered invalid after 2019-08-25. Use a child <empty> element to indicate that the element being specified is not allowed to have content.</sch:assert>

Content model

<content>
 <alternate>
  <classRef key="model.contentPart"
   minOccurs="0" maxOccurs="unbounded"/>
  <anyElement require="http://relaxng.org/ns/structure/1.0"
   minOccurs="1" maxOccurs="unbounded"/>
 </alternate>
</content>

Schema Declaration

element content
{
   att.global.attributes,
   attribute autoPrefix { "true" | "false" }?,
   ( model.contentPart* | anyElement-content+ )
}

1.72. <conversion>

<conversion> defines how to calculate one unit of measure in terms of another. [2.3.9. The Unit Declaration]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.formula (@formula)

fromUnit

indicates a source unit of measure that is to be converted into another unit indicated in toUnit.

Status	Required
Datatype	teidata.pointer

toUnit

the target unit of measurement for a conversion from a source unit referenced in fromUnit.

Status	Required
Datatype	teidata.pointer

Contained by

header: unitDef

May contain

Empty element

Note

The conversion element is designed to store information about converting from one unit of measurement to another. The formula attribute holds an XPath expression that indicates how the measurement system in fromUnit is converted to the system in toUnit. Do not confuse the usage of the dating attributes (from and to) in the examples with the attributes (fromUnit and toUnit) designed to reference units of measure.

Example

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element conversion
{
   att.global.attributes,
   att.datable.attributes,
   att.formula.attributes,
   attribute fromUnit { text },
   attribute toUnit { text },
   empty
}

1.73. <correction>

<correction> (correction principles) states how and under what circumstances corrections have been made in the text. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

status

indicates the degree of correction applied to the text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	high the text has been thoroughly checked and proofread. medium the text has been checked at least once. low the text has not been checked. unknown the correction status of the text is unknown.

method

indicates the method adopted to indicate corrections within the text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	silent corrections have been made silently[Default] markup corrections have been represented using markup

Member of

Contained by

header: editorialDecl

May contain

core: p

linking: ab

Note

May be used to note the results of proof reading the text against its original, indicating (for example) whether discrepancies have been silently rectified, or recorded using the editorial tags described in section 3.4. Simple Editorial Changes.

Example

<correction> Errors in transcription controlled by using the WordPerfect spelling checker, with a user defined dictionary of 500 extra words taken from Chambers Twentieth Century Dictionary. </correction>

Content model

<content>
 <classRef key="model.pLike" minOccurs="1"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element correction
{
   att.global.attributes,
   att.declarable.attributes,
   attribute status { "high" | "medium" | "low" | "unknown" }?,
   attribute method { "silent" | "markup" }?,
   model.pLike+
}

1.74. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.typed (type, @subtype)

type

describes the nature of the action.

Derived from	att.typed
Status	Optional
Datatype	teidata.enumerated
Suggested values include:	sent information concerning the sending or dispatch of a message. received information concerning the receipt of a message. transmitted information concerning the transmission of a message, i.e. between the dispatch and the next receipt, redirect or forwarding. redirected information concerning the redirection of an unread message. forwarded information concerning the forwarding of a message.

Member of

model.correspDescPart

Contained by

header: correspDesc

May contain

core: address date email name note p time

header: idno

linking: ab

Example

<correspAction type="sent"> <persName>Adelbert von Chamisso</persName> <settlement>Vertus</settlement> <date when="1807-01-29"/> </correspAction>

Content model

<content>
 <alternate>
  <classRef key="model.correspActionPart"
   minOccurs="1" maxOccurs="unbounded"/>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>

Schema Declaration

element correspAction
{
   att.global.attributes,
   att.typed.attribute.subtype,
   att.sortable.attributes,
   attribute type
   {
      "sent" | "received" | "transmitted" | "redirected" | "forwarded"
   }?,
   ( model.correspActionPart+ | model.pLike+ )
}

1.75. <correspContext>

<correspContext> (correspondence context) provides references to preceding or following correspondence related to this piece of correspondence. [2.4.6. Correspondence Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.correspDescPart
Contained by	header: correspDesc
May contain	core: note p ref linking: ab
Example	<correspContext> <ptr type="next" subtype="toAuthor" target="http://tei.ibi.hu-berlin.de/berliner-intellektuelle/manuscript?Brief101VarnhagenanBoeckh"/> <ptr type="prev" subtype="fromAuthor" target="http://tei.ibi.hu-berlin.de/berliner-intellektuelle/manuscript?Brief103BoeckhanVarnhagen"/> </correspContext>
Example	<correspContext> <ref type="prev" target="http://weber-gesamtausgabe.de/A040962"> Previous letter of <persName>Carl Maria von Weber</persName> to <persName>Caroline Brandt</persName>: <date when="1816-12-30">December 30, 1816</date> </ref> <ref type="next" target="http://weber-gesamtausgabe.de/A041003"> Next letter of <persName>Carl Maria von Weber</persName> to <persName>Caroline Brandt</persName>: <date when="1817-01-05">January 5, 1817</date> </ref> </correspContext>
Content model	<content> <classRef key="model.correspContextPart" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element correspContext { att.global.attributes, model.correspContextPart+ }

1.76. <correspDesc>

<correspDesc> (correspondence description) contains a description of the actions related to one act of correspondence. [2.4.6. Correspondence Description]
Module	header
Attributes	Attributes att.declarable (@default) att.canonical (@key, @ref) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.profileDescPart
Contained by	header: profileDesc
May contain	core: note p header: correspAction correspContext linking: ab
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> <alternate> <classRef key="model.correspDescPart" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> </alternate> </content>
Schema Declaration	element correspDesc { att.declarable.attributes, att.canonical.attributes, att.global.attributes, att.typed.attributes, ( model.correspDescPart+ \| model.pLike+ ) }

1.77. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.placeNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef linking: ab seg msdescription: accMat acquisition additions altIdentifier catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.naming.attributes, att.typed.attributes, att.datable.attributes, macro.phraseSeq }

1.78. <creation>

<creation> contains information about the creation of a text. [2.4.1. Creation 2.4. The Profile Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.profileDescPart
Contained by	header: profileDesc
May contain	core: address choice date email hi name ref time title header: idno listChange msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val transcr: am ex subst character data
Note	The <creation> element may be used to record details of a text's creation, e.g. the date and place it was composed, if these are of interest. It may also contain a more structured account of the various stages or revisions associated with the evolution of a text; this should be encoded using the <listChange> element. It should not be confused with the <publicationStmt> element, which records date and place of publication.
Example	<creation> <date>Before 1987</date> </creation>
Example	<creation> <date when="1988-07-10">10 July 1988</date> </creation>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.limitedPhrase"/> <elementRef key="listChange"/> </alternate> </content>
Schema Declaration	element creation { att.global.attributes, att.datable.attributes, ( text \| model.limitedPhrase \| listChange )* }

1.79. <custEvent>

<custEvent> (custodial event) describes a single event during the custodial history of a manuscript or other object. [10.9.1.2. Availability and Custodial History]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.typed (@type, @subtype)
Contained by	msdescription: custodialHist
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<custEvent type="photography">Photographed by David Cooper on <date>12 Dec 1964</date> </custEvent>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element custEvent { att.global.attributes, att.datable.attributes, att.typed.attributes, macro.specialPara }

1.80. <custodialHist>

<custodialHist> (custodial history) contains a description of a manuscript or other object's custodial history, either as running prose or as a series of dated custodial events. [10.9.1.2. Availability and Custodial History]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: adminInfo
May contain	core: p linking: ab msdescription: custEvent
Example	<custodialHist> <custEvent type="conservation" notBefore="1961-03" notAfter="1963-02">Conserved between March 1961 and February 1963 at Birgitte Dalls Konserveringsværksted.</custEvent> <custEvent type="photography" notBefore="1988-05-01" notAfter="1988-05-30">Photographed in May 1988 by AMI/FA.</custEvent> <custEvent type="transfer-dispatch" notBefore="1989-11-13" notAfter="1989-11-13">Dispatched to Iceland 13 November 1989.</custEvent> </custodialHist>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <elementRef key="custEvent" minOccurs="1" maxOccurs="unbounded"/> </alternate> </content>
Schema Declaration	element custodialHist { att.global.attributes, ( model.pLike+ \| custEvent+ ) }

1.81. <damage>

<damage> contains an area of damage to the text witness. [11.3.3.1. Damage, Illegibility, and Supplied Text]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.damaged (@agent, @degree, @group) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.written (@hand))
Member of	model.linePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	Since damage to text witnesses frequently makes them harder to read, the <damage> element will often contain an <unclear> element. If the damaged area is not continuous (e.g. a stain affecting several strings of text), the group attribute may be used to group together several related <damage> elements; alternatively the <join> element may be used to indicate which <damage> and <unclear> elements are part of the same physical phenomenon. 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.
Example	<l>The Moving Finger wri<damage agent="water" group="1">es; and</damage> having writ,</l> <l>Moves <damage agent="water" group="1"> <supplied>on: nor all your</supplied> </damage> Piety nor Wit</l>
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element damage { att.global.attributes, att.typed.attributes, att.damaged.attributes, macro.paraContent }

1.82. <damageSpan>

<damageSpan> (damaged span of text) marks the beginning of a longer sequence of text which is damaged in some way but still legible. [11.3.3.1. Damage, Illegibility, and Supplied Text]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.damaged (@agent, @degree, @group) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) ) (att.written (@hand)) att.typed (@type, @subtype) att.spanning (@spanTo)
Member of	model.global.edit
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	Empty element
Note	Both the beginning and ending of the damaged sequence must be marked: the beginning by the <damageSpan> element, the ending by the target of the spanTo attribute: if no other element available, the <anchor> element may be used for this purpose. The damaged text must be at least partially legible, in order for the encoder to be able to transcribe it. If it is not legible at all, the <damageSpan> element should not be used. Rather, the <gap> or <unclear> element should be employed, with the value of the reason attribute giving the cause. See further sections 11.3.3.1. Damage, Illegibility, and Supplied Text and 11.3.3.2. Use of the gap, del, damage, unclear, and supplied Elements in Combination.
Example	<p>Paragraph partially damaged. This is the undamaged portion <damageSpan spanTo="#a34"/>and this the damaged portion of the paragraph.</p> <p>This paragraph is entirely damaged.</p> <p>Paragraph partially damaged; in the middle of this paragraph the damage ends and the anchor point marks the start of the <anchor xml:id="a34"/> undamaged part of the text. ...</p>
Schematron	<s:assert test="@spanTo">The @spanTo attribute of <s:name/> is required.</s:assert>
Schematron	<s:assert test="@spanTo">L'attribut spanTo est requis.</s:assert>
Content model	<content> <empty/> </content>
Schema Declaration	element damageSpan { att.global.attributes, att.damaged.attributes, att.typed.attributes, att.spanning.attributes, empty }

1.83. <dataFacet>

<dataFacet> Restricts the value of the strings used to represent values of a datatype, according to XML Schemas: Part 2: Datatypes. [22.5.3.1. Datatypes]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

name

the name of the facet.

Status	Required
Datatype	teidata.word
Legal values are:	length minLength maxLength pattern enumeration whiteSpace maxInclusive minInclusive maxExclusive minExclusive totalDigits fractionDigits

value

the facet value.

Status	Required
Datatype	string

Contained by

tagdocs: dataRef

May contain

Empty element

Note

This element is only allowed when the parent <dataRef> refers with name to a datatype from the specification XML Schemas: Part 2: Datatypes.

Example

Example

<dataSpec ident="data.integerExample"> <desc>datatype used for attributes taking an integer value between 0 and 99</desc> <content> <dataRef name="nonNegativeInteger"> <dataFacet name="maxInclusive" value="99"/> <dataFacet name="minInclusive" value="0"/> </dataRef> </content> </dataSpec>

Content model

<content>
 <empty/>
</content>

Schema Declaration

element dataFacet
{
   att.global.attributes,
   attribute name
   {
      "length"
    | "minLength"
    | "maxLength"
    | "pattern"
    | "enumeration"
    | "whiteSpace"
    | "maxInclusive"
    | "minInclusive"
    | "maxExclusive"
    | "minExclusive"
    | "totalDigits"
    | "fractionDigits"
   },
   attribute value { text },
   empty
}

1.84. <dataRef>

<dataRef> identifies the datatype of an attribute value, either by referencing an item in an externally defined datatype library, or by pointing to a TEI-defined data specification [22.5.3.1. Datatypes]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

key

the identifier used for this datatype specification

Status	Optional
Datatype	teidata.xmlName

name

the name of a datatype in the list provided by XML Schemas: Part 2: Datatypes

Status	Optional
Datatype	teidata.xmlName

ref

a pointer to a datatype defined in some datatype library

Status	Optional
Datatype	teidata.pointer

restriction

supplies a string representing a regular expression providing additional constraints on the strings used to represent values of this datatype

Status	Optional
Datatype	teidata.pattern

Member of

model.descLike model.labelLike

Contained by

tagdocs: alternate content datatype schemaSpec sequence specGrp

May contain

tagdocs: dataFacet

Note

Only one of the attributes key, name, and ref may be used.

Note

<dataFacet> children are only allowed when <dataRef> refers with name to a datatype from the specification XML Schemas: Part 2: Datatypes.

Example

Example

Example

<dataSpec ident="data.integerExample"> <desc>datatype used for attributes taking an integer value between 0 and 99</desc> <content> <dataRef name="nonNegativeInteger" restriction="[0-9][0-9]?"/> </content> </dataSpec>

Schematron

<sch:rule context="tei:dataRef[tei:dataFacet]"> <sch:assert test="@name" role="nonfatal">Data facets can only be specified for references to datatypes specified by XML Schemas: Part 2: Datatypes</sch:assert> </sch:rule>

Schematron

<sch:rule context="tei:dataRef[tei:dataFacet]"> <sch:report test="@restriction" role="nonfatal">The attribute restriction cannot be used when dataFacet elements are present.</sch:report> </sch:rule>

Content model

<content>
 <elementRef minOccurs="0"
  maxOccurs="unbounded" key="dataFacet"/>
</content>

Schema Declaration

element dataRef
{
   att.global.attributes,
   (
      attribute key { text }?
    | attribute name { text }?
    | attribute ref { text }?
   ),
   attribute restriction { text }?,
   dataFacet*
}

1.85. <dataSpec>

<dataSpec> (datatype specification) documents a datatype. [22.3. Specification Elements 22.7. Macro Specifications]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) )
Member of	model.oddDecl
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: schemaSpec specGrp textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc tagdocs: altIdent constraintSpec content equiv exemplum listRef remarks valList
Example	<dataSpec ident="teidata.pointer"> <desc versionDate="2013-01-19" xml:lang="en">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.</desc> <content> <dataRef name="anyURI"/> </content> </dataSpec>
Content model	<content> <sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.glossLike"/> <classRef key="model.descLike"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="content"/> <elementRef key="valList"/> </alternate> <elementRef key="constraintSpec" minOccurs="0" maxOccurs="unbounded"/> <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 dataSpec { att.global.attributes, att.identified.attributes, ( ( model.glossLike \| model.descLike ), ( content \| valList ), constraintSpec, exemplum, remarks, listRef ) }

1.86. <datatype>

<datatype> specifies the declared value for an attribute, by referring to any datatype defined by the chosen schema language. [1.4.2. Datatype Specifications 22.5.3. Attribute List Specification]

Module tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

minOccurs

(minimum number of occurences) indicates the minimum number of times this datatype may occur in the specification of the attribute being defined

Derived from	att.repeatable
Status	Optional
Datatype	teidata.count
Default	1

maxOccurs

(maximum number of occurences) indicates the maximum number of times this datatype may occur in the specification of the attribute being defined

Derived from	att.repeatable
Status	Optional
Datatype	teidata.unboundedInt
Default	1

Contained by

tagdocs: attDef

May contain

tagdocs: dataRef

Note

In the TEI scheme, most datatypes are expressed using pre-defined TEI macros, which map a name in the form teidata.xxxx to a datatype defined by RELAX NG or the W3C Schema Language.

Example

Example

Example

The encoding in the following example requires that the attribute being defined contain at least two URIs in its value, as is the case for the target attribute of <join>.

Content model

<content>
 <alternate>
  <elementRef key="dataRef"/>
  <anyElement require="http://relaxng.org/ns/structure/1.0"/>
 </alternate>
</content>

Schema Declaration

element datatype
{
   att.global.attributes,
   attribute minOccurs { text }?,
   attribute maxOccurs { text }?,
   ( dataRef | anyElement-datatype )
}

1.87. <date>

<date> contains a date in any format. [3.5.4. Dates and Times 2.2.4. Publication, Distribution, Licensing, etc. 2.6. The Revision Description 3.11.2.4. Imprint, Size of a Document, and Reprint Information 15.2.3. The Setting Description 13.3.7. Dates and Times]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.typed (@type, @subtype)
Member of	model.dateLike model.publicationStmtPart.detail
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal publicationStmt rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.canonical.attributes, att.datable.attributes, att.editLike.attributes, att.dimensions.attributes, att.typed.attributes, ( text \| model.gLike \| model.phrase \| model.global )* }

1.88. <dateline>

<dateline> contains a brief description of the place, date, time, etc. of production of a letter, newspaper story, or other work, prefixed or suffixed to it as a kind of heading or trailer. [4.2.2. Openers and Closers]
Module	textstructure
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.divWrapper
Contained by	core: lg textstructure: body div front
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<dateline>Walden, this 29. of August 1592</dateline>
Example	<div type="chapter"> <p> <!-- ... --> and his heart was going like mad and yes I said yes I will Yes.</p> <closer> <dateline> <name type="place">Trieste-Zürich-Paris,</name> <date>1914–1921</date> </dateline> </closer> </div>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.gLike"/> <classRef key="model.phrase"/> <classRef key="model.global"/> <elementRef key="docDate"/> </alternate> </content>
Schema Declaration	element dateline { att.global.attributes, ( text \| model.gLike \| model.phrase \| model.global \| docDate )* }

1.89. <death>

<death> contains information about a person's death, such as its date and place. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.editLike (@evidence, @instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	proclaimed assumed verified clinical brain natural unnatural fragmentation dissolution
Note	This attribute is not intended to express the cause of death.

Member of

model.personPart

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

Example

<death when="1960-12-10">Passed away near <name type="place">Aix-la-Chapelle</name>, after suffering from cerebral palsy. </death>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element death
{
   att.datable.attributes,
   att.dimensions.attributes,
   att.editLike.attributes,
   att.global.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.phraseSeq
}

1.90. <decoDesc>

<decoDesc> (decoration description) contains a description of the decoration of a manuscript or other object, either as in paragraphs, or as one or more <decoNote> elements. [10.7.3. Bindings, Seals, and Additional Material]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.physDescPart
Contained by	msdescription: physDesc
May contain	core: p linking: ab msdescription: decoNote summary
Example	<decoDesc> <p>The start of each book of the Bible with a 10-line historiated illuminated initial; prefaces decorated with 6-line blue initials with red penwork flourishing; chapters marked by 3-line plain red initials; verses with 1-line initials, alternately blue or red.</p> </decoDesc>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <elementRef key="decoNote" minOccurs="1" maxOccurs="unbounded"/> </sequence> </alternate> </content>
Schema Declaration	element decoDesc { att.global.attributes, ( model.pLike+ \| ( summary?, decoNote+ ) ) }

1.91. <decoNote>

<decoNote> (note on decoration) contains a note describing either a decorative component of a manuscript or other object, or a fairly homogenous class of such components. [10.7.3. Bindings, Seals, and Additional Material]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.msItemPart
Contained by	msdescription: binding bindingDesc decoDesc msItem msItemStruct seal sealDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<decoDesc> <decoNote type="initial"> <p>The start of each book of the Bible with a 10-line historiated illuminated initial; prefaces decorated with 6-line blue initials with red penwork flourishing; chapters marked by 3-line plain red initials; verses with 1-line initials, alternately blue or red.</p> </decoNote> </decoDesc>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element decoNote { att.global.attributes, att.typed.attributes, macro.specialPara }

1.92. <defaultVal>

<defaultVal> (default value) specifies the default declared value for an attribute. [22.5.3. Attribute List Specification]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.deprecated (@validUntil)
Contained by	tagdocs: attDef
May contain	Character data only
Note	any legal declared value or TEI-defined keyword
Example	<defaultVal>#IMPLIED</defaultVal>
Content model	<content> <textNode/> </content>
Schema Declaration	element defaultVal { att.global.attributes, att.deprecated.attributes, text }

1.93. <del>

<del> (deletion) contains a letter, word, or passage deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, or a previous annotator or corrector. [3.4.3. Additions, Deletions, and Omissions]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.linePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw line metamark mod restore retrace secl subst supplied surplus zone verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.transcriptional.attributes, att.typed.attributes, att.dimensions.attributes, macro.paraContent }

1.94. <delSpan>

<delSpan> (deleted span of text) marks the beginning of a longer sequence of text deleted, marked as deleted, or otherwise signaled as superfluous or spurious by an author, scribe, annotator, or corrector. [11.3.1.4. Additions and Deletions]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.typed (@type, @subtype) att.spanning (@spanTo) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.global.edit
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	Empty element
Note	Both the beginning and ending of the deleted sequence must be marked: the beginning by the <delSpan> element, the ending by the target of the spanTo attribute. The text deleted must be at least partially legible, in order for the encoder to be able to transcribe it. If it is not legible at all, the <delSpan> tag should not be used. Rather, the <gap> tag should be employed to signal that text cannot be transcribed, with the value of the reason attribute giving the cause for the omission from the transcription as deletion. If it is not fully legible, the <unclear> element should be used to signal the areas of text which cannot be read with confidence. See further sections 11.3.1.7. Text Omitted from or Supplied in the Transcription and, for the close association of the <delSpan> tag with the <gap>, <damage>, <unclear> and <supplied> elements, 11.3.3.2. Use of the gap, del, damage, unclear, and supplied Elements in Combination. The <delSpan> tag should not be used for deletions made by editors or encoders. In these cases, either the <corr> tag or the <gap> tag should be used.
Example	<p>Paragraph partially deleted. This is the undeleted portion <delSpan spanTo="#a23"/>and this the deleted portion of the paragraph.</p> <p>Paragraph deleted together with adjacent material.</p> <p>Second fully deleted paragraph.</p> <p>Paragraph partially deleted; in the middle of this paragraph the deletion ends and the anchor point marks the resumption <anchor xml:id="a23"/> of the text. ...</p>
Schematron	<s:assert test="@spanTo">The @spanTo attribute of <s:name/> is required.</s:assert>
Schematron	<s:assert test="@spanTo">L'attribut spanTo est requis.</s:assert>
Content model	<content> <empty/> </content>
Schema Declaration	element delSpan { att.global.attributes, att.transcriptional.attributes, att.typed.attributes, att.spanning.attributes, att.dimensions.attributes, empty }

1.95. <depth>

<depth> contains a measurement from the front to the back of an object, perpendicular to the measurement given by the <width> element. [10.3.4. Dimensions]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.dimLike model.measureLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote dimensions explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	gaiji: g character data
Example	<depth unit="in" quantity="4"/>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element depth { att.global.attributes, att.dimensions.attributes, macro.xtext }

1.96. <desc>

<desc> (description) contains a brief description of the object documented by its parent element, typically a documentation element or an entity. [22.4.1. Description of Components]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.translatable (@versionDate) att.typed (type, @subtype)

type

characterizes the element in some sense, using any convenient classification scheme or typology.

Derived from	att.typed
Status	Optional
Datatype	teidata.enumerated
<elementSpec module="core" ident="teiCorpus" validUntil="2027-10-20"> <desc versionDate="2017-02-07" xml:lang="en">contains the whole of a TEI encoded corpus, comprising a single corpus header and one or more <gi>TEI</gi> elements, each containing a single text header and a text.</desc> <desc type="deprecationInfo" xml:lang="en">The <gi>TEI</gi> element is now permitted to nest directly within a <gi>TEI</gi> element. Thus the recommended encoding of a corpus is to use <gi>TEI</gi> with a <att>type</att> of <val>corpus</val> as the outermost element of a set of TEI documents that are to be treated as a single corpus.</desc> <!-- ... --> </elementSpec>

Member of

Contained by

analysis: interp interpGrp

certainty: certainty precision respons

core: add del desc gap head hi l lg listBibl note p q quote ref reg sic title unclear

gaiji: char charDecl glyph

header: application category change handNote licence listChange listPrefixDef rendition schemaRef scriptNote tagUsage taxonomy unitDef

linking: ab join seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: climate event listEvent listNym listObject listOrg listPerson listPlace listRelation location occupation org place population relation state terrain trait

tagdocs: attDef classSpec constraintSpec dataSpec elementSpec listRef macroSpec model modelGrp modelSequence moduleSpec paramSpec schemaSpec valItem

textcrit: lem listApp listWit rdg witness

textstructure: body div

transcr: damage listTranspose metamark mod restore retrace secl space substJoin supplied surface surplus

verse: rhyme

May contain

core: address bibl choice date desc email hi listBibl name q quote ref time title

header: biblFull idno

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specGrp specGrpRef tag val

textcrit: listApp listWit

transcr: am ex subst

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

<desc>contains a brief description of the purpose and intended use of a documentation element, or a brief characterisation of a parent entity </desc>

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.attributes,
   att.translatable.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.limitedContent
}

1.97. <dim>

<dim> contains any single measurement forming part of a dimensional specification of some sort. [10.3.4. Dimensions]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.measureLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote dimensions explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	gaiji: g character data
Note	The specific elements <width>, <height>, and <depth> should be used in preference to this generic element wherever appropriate.
Example	<dim type="circumference" extent="4.67 in"/>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element dim { att.global.attributes, att.typed.attributes, att.dimensions.attributes, macro.xtext }

1.98. <dimensions>

<dimensions> contains a dimensional specification. [10.3.4. Dimensions]

Module

msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

type

indicates which aspect of the object is being measured.

Status	Optional
Datatype	teidata.enumerated
Sample values include:	leaves dimensions relate to one or more leaves (e.g. a single leaf, a gathering, or a separately bound part) ruled dimensions relate to the area of a leaf which has been ruled in preparation for writing. pricked dimensions relate to the area of a leaf which has been pricked out in preparation for ruling (used where this differs significantly from the ruled area, or where the ruling is not measurable). written dimensions relate to the area of a leaf which has been written, with the height measured from the top of the minims on the top line of writing, to the bottom of the minims on the bottom line of writing. miniatures dimensions relate to the miniatures within the manuscript binding dimensions relate to the binding in which the codex or manuscript is contained box dimensions relate to the box or other container in which the manuscript is stored.

Member of

model.pPart.msdesc

Contained by

analysis: cl phr s span

core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

msdescription: depth dim height width

Note

Contains no more than one of each of the specialized elements used to express a three-dimensional object's height, width, and depth, combined with any number of other kinds of dimensional specification.

Example

Example

This element may be used to record the dimensions of any text-bearing object, not necessarily a codex. For example:

This might be used to show that the inscribed panels on some (imaginary) monument are all the same size (7004 by 1803 cm) and stand out from the rest of the monument by 345 mm.

Example

When simple numeric quantities are involved, they may be expressed on the quantity attribute of any or all of the child elements, as in the following example:

Schematron

<s:report test="count(tei:width)> 1">The element <s:name/> may appear once only </s:report> <s:report test="count(tei:height)> 1">The element <s:name/> may appear once only </s:report> <s:report test="count(tei:depth)> 1">The element <s:name/> may appear once only </s:report>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <elementRef key="dim"/>
  <classRef key="model.dimLike"/>
 </alternate>
</content>

Schema Declaration

element dimensions
{
   att.global.attributes,
   att.dimensions.attributes,
   attribute type { text }?,
   ( dim | model.dimLike )*
}

1.99. <distributor>

<distributor> supplies the name of a person or other agency responsible for the distribution of a text. [2.2.4. Publication, Distribution, Licensing, etc.]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.imprintPart model.publicationStmtPart.agency
Contained by	core: bibl header: publicationStmt
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<distributor>Oxford Text Archive</distributor> <distributor>Redwood and Burn Ltd</distributor>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element distributor { att.global.attributes, att.canonical.attributes, macro.phraseSeq }

1.100. <district>

<district> contains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit. [13.2.3. Place Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.placeNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef linking: ab seg msdescription: accMat acquisition additions altIdentifier catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<placeName> <district type="ward">Jericho</district> <settlement>Oxford</settlement> </placeName>
Example	<placeName> <district type="area">South Side</district> <settlement>Chicago</settlement> </placeName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element district { att.global.attributes, att.naming.attributes, att.typed.attributes, att.datable.attributes, macro.phraseSeq }

1.101. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (@org, @sample) (att.metrical (@met, @real, @rhyme)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.declaring (@decls) att.written (@hand)
Member of	model.divLike
Contained by	textcrit: lem rdg textstructure: body div front
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: bibl desc gap head l lb lg listBibl milestone note p pb q quote header: biblFull linking: ab alt altGrp anchor join joinGrp link linkGrp timeline msdescription: msDesc namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation tagdocs: classSpec constraintSpec dataSpec eg egXML elementSpec listRef macroSpec moduleSpec outputRendition schemaSpec specGrp specGrpRef textcrit: app listApp listWit witDetail textstructure: dateline div transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin
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	<s:report test="ancestor::tei:l"> Abstract model violation: Lines may not contain higher-level structural elements such as div. </s:report>
Schematron	<s: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. </s: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"> <classRef key="model.common"/> <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 )+ \| ( ( model.common, model.global* )+, ( ( model.divLike \| model.divGenLike ), model.global* )* ) ), ( model.divBottom, model.global* )* )? ) }

1.102. <edition>

<edition> describes the particularities of one edition of a text. [2.2.2. The Edition Statement]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.biblPart
Contained by	core: bibl header: editionStmt
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, macro.phraseSeq }

1.103. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: biblFull fileDesc
May contain	core: author editor p respStmt header: edition funder principal sponsor linking: ab
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> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="edition"/> <classRef key="model.respLike" minOccurs="0" maxOccurs="unbounded"/> </sequence> </alternate> </content>
Schema Declaration	element editionStmt { att.global.attributes, ( model.pLike+ \| ( edition, model.respLike* ) ) }

1.104. <editor>

<editor> contains a secondary statement of responsibility for a bibliographic item, for example the name of an individual, institution or organization, (or of several such) acting as editor, compiler, translator, etc. [3.11.2.2. Titles, Authors, and Editors]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Member of	model.respLike
Contained by	core: bibl header: editionStmt seriesStmt titleStmt msdescription: msItem
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	A consistent format should be adopted. Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use generally recognized authority lists for the exact form of personal names.
Example	<editor role="Technical_Editor">Ron Van den Branden</editor> <editor role="Editor-in-Chief">John Walsh</editor> <editor role="Managing_Editor">Anne Baillot</editor>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element editor { att.global.attributes, att.naming.attributes, macro.phraseSeq }

1.105. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	core: p header: correction hyphenation interpretation normalization punctuation quotation segmentation stdVals linking: ab
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 &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.attributes, att.declarable.attributes, ( model.pLike \| model.editorialDeclPart )+ }

1.106. <education>

<education> contains a description of the educational experience of a person. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	primary secondary undergraduate graduate residency apprenticeship

Member of

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<education>Left school at age 16</education>

Example

<education from="1986-01-01" to="1990-06-30">Attended <name>Cherwell School</name> </education>

Example

<education notBefore="1685-07" notAfter="1690-06">Anthony Hammond smuggled her into the University of Cambridge, where she was disguised as his male cousin, Jack. She remained there for some months learning grammar, logic, rhetoric, and ethics</education>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element education
{
   att.global.attributes,
   att.editLike.attributes,
   att.datable.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.phraseSeq
}

1.107. <eg>

<eg> (example) contains any kind of illustrative example. [22.5. Element Specifications 22.5.3. Attribute List Specification]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.egLike
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: exemplum textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	If the example contains material in XML markup, either it must be enclosed within a CDATA marked section, or character entity references must be used to represent the markup delimiters. If the example contains well-formed XML, it should be marked using the more specific <egXML> element.
Example	<p>The <gi>term</gi> element is declared using the following syntax: <eg><![CDATA[<!ELEMENT term (%phrase.content;)>]]</eg> </p>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element eg { att.global.attributes, macro.phraseSeq }

1.108. <egXML>

<egXML> (example of XML) a single XML fragment demonstrating the use of some XML, such as elements, attributes, or processing instructions, etc., in which the <egXML> element functions as the root element. [22.1.1. Phrase Level Terms]

Namespace

http://www.tei-c.org/ns/Examples

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

valid

indicates the intended validity of the example with respect to a schema.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	true the example is intended to be fully valid, assuming that its root element, or a provided root element, could have been used as a possible root element in the schema concerned.[Default] feasible the example could be transformed into a valid document by inserting any number of valid attributes and child elements anywhere within it; or it is valid against a version of the schema concerned in which the provision of character data, list, element, or attribute values has been made optional. false the example is not intended to be valid, and contains deliberate errors.

Member of

model.egLike

Contained by

core: add del desc head hi l note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote tagUsage

linking: ab seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: exemplum

textcrit: lem rdg witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

Character data only

Note

In the source of the TEI Guidelines, this element declares itself and its content as belonging to the namespace http://www.tei-c.org/ns/Examples. This enables the content of the element to be validated independently against the TEI scheme. Where this element is used outside this context, a different namespace or none at all may be preferable. The content must however be a well-formed XML fragment or document: where this is not the case, the more general <eg> element should be used in preference.

Example

<egXML xmlns="http://www.tei-c.org/ns/Examples"><div> <head>A slide about <gi>egXML</gi> </head> <list> <item> <gi>egXML</gi> can be used to give XML examples in the TEI Examples namespace</item> <item>Attributes values for <att>valid</att>: <list rend="collapsed"> <item> <val rend="green">true</val>: intended to be fully valid</item> <item> <val rend="amber">feasible</val>: valid if missing nodes provided</item> <item> <val rend="red">false</val>: not intended to be valid</item> </list> </item> <item>The <att>rend</att> attribute in the TEI namespace can be used for recording how parts of the example was rendered.</item> </list> </div> </egXML>

Example

Example

<egXML xmlns="http://www.tei-c.org/ns/Examples" valid="false"> <para xml:lang="en">Doubloons are a pirate's best friend</para> </egXML>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <anyElement/>
 </alternate>
</content>

Schema Declaration

element egXML
{
   att.global.attributes,
   attribute valid { "true" | "feasible" | "false" }?,
   ( text | anyElement-egXML )*
}

1.109. <elementRef>

<elementRef> points to the specification for some element which is to be included in a schema [22.2. Modules and Schemas]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.repeatable (@minOccurs, @maxOccurs)

key

the identifier used for the required element within the source indicated.

Status	Required
Datatype	teidata.xmlName

Member of

Contained by

tagdocs: alternate content schemaSpec sequence specGrp

May contain

Empty element

Note

Elements are identified by the name supplied as value for the ident attribute on the <elementSpec> element in which they are declared. TEI element names are unique.

Example

Include in the schema an element named available from the current default source.

Example

Include in the schema an element named available from the TEI P5 1.2.1 release.

Content model

<content>
 <empty/>
</content>

Schema Declaration

element elementRef
{
   att.global.attributes,
   att.repeatable.attributes,
   attribute key { text },
   empty
}

1.110. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) ) att.namespaceable (@ns)

prefix

specifies a default prefix which will be prepended to all patterns relating to the element, unless otherwise stated.

Status	Optional
Datatype	0–1 occurrences of teidata.xmlName separated by whitespace
Note	Colons, although permitted inside the value, will cause an invalid schema to be generated.

Member of

Contained by

core: add del desc head hi l note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote tagUsage

linking: ab seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: schemaSpec specGrp

textcrit: lem rdg witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

core: desc

tagdocs: altIdent attList classes constraintSpec content equiv exemplum listRef model modelGrp modelSequence remarks 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>

Content model

<content>
 <sequence>
  <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 maxOccurs="unbounded"
   minOccurs="0">
   <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.attributes,
   att.identified.attributes,
   att.namespaceable.attributes,
   attribute prefix { text }?,
   (
      ( model.glossLike | model.descLike )*,
      classes?,
      content?,
      valList?,
      constraintSpec*,
      attList?,
      ( model | modelGrp | modelSequence )*,
      exemplum*,
      remarks*,
      listRef*
   )
}

1.111. <email>

<email> (electronic mail address) contains an email address identifying a location to which email messages can be delivered. [3.5.2. Addresses]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.addressLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The format of a modern Internet email address is defined in RFC 2822
Example	<email>membership@tei-c.org</email>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element email { att.global.attributes, macro.phraseSeq }

1.112. <empty>

<empty> indicates the presence of an empty node within a content model [22. Documentation Elements]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.contentPart
Contained by	tagdocs: alternate content sequence
May contain	Empty element
Example	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <empty/> <elementRef key="hi"/> </alternate> </content>
Content model	<content> <empty/> </content>
Schema Declaration	element empty { att.global.attributes, empty }

1.113. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (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 gaiji: charDecl header: appInfo classDecl editorialDecl geoDecl listPrefixDef projectDesc refsDecl samplingDecl schemaRef styleDefDecl tagsDecl unitDecl linking: ab tagdocs: schemaSpec textcrit: variantEncoding verse: metDecl
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.attributes, ( model.encodingDescPart \| model.pLike )+ }

1.114. <equiv>

<equiv> (equivalent) specifies a component which is considered equivalent to the parent element, either by co-reference, or by external link. [3.3.4. Terms, Glosses, Equivalents, and Descriptions 22.4.1. Description of Components]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.internetMedia (@mimeType)

name

a single word which follows the rules defining a legal XML name (see http://www.w3.org/TR/REC-xml/#dt-name), naming the underlying concept of which the parent is a representation.

Status	Optional
Datatype	teidata.name

uri

(uniform resource identifier) references the underlying concept of which the parent is a representation by means of some external identifier

Status	Optional
Datatype	teidata.pointer

filter

references an external script which contains a method to transform instances of this element to canonical TEI

Status	Optional
Datatype	teidata.pointer

Member of

model.glossLike

Contained by

header: category taxonomy

linking: joinGrp

tagdocs: attDef classSpec constraintSpec dataSpec elementSpec macroSpec model modelGrp modelSequence moduleSpec paramSpec schemaSpec valItem

May contain

Empty element

Note

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

Example

The following example declares that the <bo> element is conceptually equivalent to the markup construct <hi rend='bold'>, and that an external definition of this concept is available from the URI indicated

<elementSpec ident="hi" mode="change"> <equiv name="BOLD"/> <desc>bold typography</desc> <attList> <attDef ident="rend" mode="change"> <valList> <valItem ident="bold"/> </valList> </attDef> </attList> </elementSpec> <elementSpec ident="bo" mode="add"> <equiv name="BOLD" uri="http://www.example.com/typesetting/bold"/> </elementSpec>

Content model

<content>
 <empty/>
</content>

Schema Declaration

element equiv
{
   att.global.attributes,
   att.internetMedia.attributes,
   attribute name { text }?,
   attribute uri { text }?,
   attribute filter { text }?,
   empty
}

1.115. <event>

<event> contains data relating to any kind of significant event associated with a person, place, or organization. [13.3.1. Basic Principles]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.typed (@type, @subtype) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.sortable (@sortKey)

where

indicates the location of an event by pointing to a <place> element

Status	Optional
Datatype	teidata.pointer

Member of

model.eventLike

Contained by

namesdates: event listEvent org person personGrp persona place

May contain

core: bibl desc head listBibl note p

header: biblFull idno

linking: ab link linkGrp

msdescription: msDesc

namesdates: event

Example

<person> <event type="mat" when="1972-10-12"> <label>matriculation</label> </event> <event type="grad" when="1975-06-23"> <label>graduation</label> </event> </person>

Content model

<content>
 <sequence>
  <elementRef key="idno" minOccurs="0"
   maxOccurs="unbounded"/>
  <classRef key="model.headLike"
   minOccurs="0" maxOccurs="unbounded"/>
  <alternate>
   <classRef key="model.pLike"
    minOccurs="1" maxOccurs="unbounded"/>
   <classRef key="model.labelLike"
    minOccurs="1" maxOccurs="unbounded"/>
  </alternate>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.noteLike"/>
   <classRef key="model.biblLike"/>
   <elementRef key="linkGrp"/>
   <elementRef key="link"/>
   <elementRef key="idno"/>
   <elementRef key="ptr"/>
  </alternate>
  <elementRef key="event" minOccurs="0"
   maxOccurs="unbounded"/>
 </sequence>
</content>

Schema Declaration

element event
{
   att.global.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.typed.attributes,
   att.naming.attributes,
   att.sortable.attributes,
   attribute where { text }?,
   (
      idno*,
      model.headLike*,
      ( model.pLike+ | model.labelLike+ ),
      ( model.noteLike | model.biblLike | linkGrp | link | idno | ptr )*,
      event*
   )
}

1.116. <ex>

<ex> (editorial expansion) contains a sequence of letters added by an editor or transcriber when expanding an abbreviation. [11.3.1.2. Abbreviation and Expansion]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.choicePart model.pPart.editorial
Contained by	analysis: cl pc phr s span w core: add author bibl biblScope choice date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	gaiji: g character data
Example	The address is Southmoor <choice> <expan>R<ex>oa</ex>d</expan> <abbr>Rd</abbr> </choice>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element ex { att.global.attributes, att.editLike.attributes, att.dimensions.attributes, macro.xtext }

1.117. <exemplum>

<exemplum> groups an example demonstrating the use of an element along with optional paragraphs of commentary. [22.5. Element Specifications]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.translatable (@versionDate)
Contained by	tagdocs: attDef classSpec dataSpec elementSpec macroSpec moduleSpec
May contain	core: p linking: ab tagdocs: eg egXML
Example	<exemplum xml:lang="en"> <p>The <gi>name</gi> element can be used for both personal names and place names:</p> <eg xml:space="preserve"><![CDATA[ <q>My dear <name type="person">Mr. Bennet</name>,</q> said his lady to him one day, <q>have you heard that <name type="place">Netherfield Park</name> is let at last?</q>]]></eg> <p>As shown above, the <att>type</att> attribute may be used to distinguish the one from the other.</p> </exemplum>
Content model	<content> <sequence> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <elementRef key="egXML"/> <elementRef key="eg"/> </alternate> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element exemplum { att.global.attributes, att.typed.attributes, att.translatable.attributes, ( model.pLike, ( egXML \| eg ), model.pLike ) }

1.118. <explicit>

<explicit> contains the explicit of a item, that is, the closing words of the text proper, exclusive of any rubric or colophon which might follow it. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.msExcerpt (@defective)
Member of	model.msQuoteLike
Contained by	msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<explicit>sed libera nos a malo.</explicit> <rubric>Hic explicit oratio qui dicitur dominica.</rubric> <explicit type="defective">ex materia quasi et forma sibi proporti<gap/> </explicit> <explicit type="reverse">saued be shulle that doome of day the at </explicit>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element explicit { att.global.attributes, att.typed.attributes, att.msExcerpt.attributes, macro.phraseSeq }

1.119. <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.11.2.4. Imprint, Size of a Document, and Reprint Information 10.7.1. Object Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.biblPart
Contained by	core: bibl header: biblFull fileDesc msdescription: supportDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, macro.phraseSeq }

1.120. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls)
Member of	model.resourceLike
Contained by	textstructure: TEI
May contain	textstructure: front transcr: surface 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> <sequence> <elementRef key="front" minOccurs="0"/> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.graphicLike"/> <elementRef key="surface"/> <elementRef key="surfaceGrp"/> </alternate> <elementRef key="back" minOccurs="0"/> </sequence> </content>
Schema Declaration	element facsimile { att.global.attributes, att.declaring.attributes, ( front?, ( model.graphicLike \| surface \| surfaceGrp )+, back? ) }

1.121. <faith>

<faith> specifies the faith, religion, or belief set of a person. [13.3.2.1. Personal Characteristics]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.canonical (@key, @ref) att.typed (type, @subtype)

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:	practicing clandestine patrilineal matrilineal convert

Member of

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<faith>protestant</faith>

Example

<faith ref="http://dbpedia.org/page/Manichaeism">Manichaeism</faith>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element faith
{
   att.global.attributes,
   att.editLike.attributes,
   att.datable.attributes,
   att.canonical.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.phraseSeq
}

1.122. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: biblFull teiHeader
May contain	header: editionStmt extent notesStmt publicationStmt seriesStmt 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> <sequence> <elementRef key="titleStmt"/> <elementRef key="editionStmt" minOccurs="0"/> <elementRef key="extent" minOccurs="0"/> <elementRef key="publicationStmt"/> <elementRef key="seriesStmt" minOccurs="0"/> <elementRef key="notesStmt" minOccurs="0"/> </sequence> <elementRef key="sourceDesc" minOccurs="1" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element fileDesc { att.global.attributes, ( ( titleStmt, editionStmt?, extent?, publicationStmt, seriesStmt?, notesStmt? ), sourceDesc+ ) }

1.123. <filiation>

<filiation> contains information concerning the manuscript or other object's filiation, i.e. its relationship to other surviving manuscripts or other objects of the same text or contents, its protographs, antigraphs and apographs. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.msItemPart
Contained by	msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<msContents> <msItem> <title>Beljakovski sbornik</title> <filiation type="protograph">Bulgarian</filiation> <filiation type="antigraph">Middle Bulgarian</filiation> <filiation type="apograph"> <ref target="#DN17">Dujchev N 17</ref> </filiation> </msItem> </msContents> <!-- ... --> <msDesc xml:id="DN17"> <msIdentifier> <settlement>Faraway</settlement> </msIdentifier> <!-- ... --> </msDesc> In this example, the reference to ‘Dujchev N17’ includes a link to some other manuscript description which has the identifier `DN17`.
Example	<msItem> <title>Guan-ben</title> <filiation> <p>The "Guan-ben" was widely current among mathematicians in the Qing dynasty, and "Zhao Qimei version" was also read. It is therefore difficult to know the correct filiation path to follow. The study of this era is much indebted to Li Di. We explain the outline of his conclusion here. Kong Guangsen (1752-1786)(17) was from the same town as Dai Zhen, so he obtained "Guan-ben" from him and studied it(18). Li Huang (d. 1811) (19) took part in editing Si Ku Quan Shu, so he must have had "Guan-ben". Then Zhang Dunren (1754-1834) obtained this version, and studied "Da Yan Zong Shu Shu" (The General Dayan Computation). He wrote Jiu Yi Suan Shu (Mathematics Searching for One, 1803) based on this version of Shu Xue Jiu Zhang (20).</p> <p>One of the most important persons in restoring our knowledge concerning the filiation of these books was Li Rui (1768(21) -1817)(see his biography). ... only two volumes remain of this manuscript, as far as chapter 6 (chapter 3 part 2) p.13, that is, question 2 of "Huan Tian San Ji" (square of three loops), which later has been lost.</p> </filiation> </msItem> <!--http://www2.nkfust.edu.tw/~jochi/ed1.htm-->
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element filiation { att.global.attributes, att.typed.attributes, macro.specialPara }

1.124. <finalRubric>

<finalRubric> contains the string of words that denotes the end of a text division, often with an assertion as to its author and title, usually set off from the text itself by red ink, by a different size or type of script, or by some other such visual device. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.msExcerpt (@defective)
Member of	model.msQuoteLike
Contained by	msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<finalRubric>Explicit le romans de la Rose ou l'art d'amours est toute enclose.</finalRubric> <finalRubric>ok lúkv ver þar Brennu-Nials savgv</finalRubric>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element finalRubric { att.global.attributes, att.typed.attributes, att.msExcerpt.attributes, macro.phraseSeq }

1.125. <floruit>

<floruit> contains information about a person's period of activity. [13.3.2.1. Personal Characteristics]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.editLike (@evidence, @instant)
Member of	model.persStateLike
Contained by	namesdates: person personGrp persona
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<floruit notBefore="1066" notAfter="1100"/>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element floruit { att.global.attributes, att.datable.attributes, att.dimensions.attributes, att.editLike.attributes, macro.phraseSeq }

1.126. <foliation>

<foliation> describes the numbering system or systems used to count the leaves or pages in a codex or similar object. [10.7.1.4. Foliation]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: supportDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<foliation>Contemporary foliation in red roman numerals in the centre of the outer margin.</foliation>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element foliation { att.global.attributes, macro.specialPara }

1.127. <forename>

<forename> contains a forename, given or baptismal name. [13.2.1. Personal Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Member of	model.persNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq }

1.128. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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 transcr: facsimile
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: gap head lb listBibl milestone note p pb linking: ab alt altGrp anchor join joinGrp link linkGrp timeline textcrit: app witDetail textstructure: dateline div transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin
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="gr">Σίβυλλα τί θέλεις</q>; respondebat illa: <q xml:lang="gr">ὰποθανεῖν θέλω.</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> <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"> <alternate> <sequence> <classRef key="model.div1Like"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.div1Like"/> <classRef key="model.frontPart"/> <classRef key="model.global"/> </alternate> </sequence> <sequence> <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"> <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.attributes, 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 )* )? )? ) }

1.129. <funder>

<funder> (funding body) specifies the name of an individual, institution, or organization responsible for the funding of a project or text. [2.2.1. The Title Statement]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.respLike
Contained by	core: bibl header: editionStmt titleStmt msdescription: msItem
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: address choice date email gap hi lb milestone name note pb ref time title header: idno linking: alt altGrp anchor join joinGrp link linkGrp timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val textcrit: app witDetail transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data
Note	Funders provide financial support for a project; they are distinct from sponsors (see element <sponsor>), who provide intellectual support and authority.
Example	<funder>The National Endowment for the Humanities, an independent federal agency</funder> <funder>Directorate General XIII of the Commission of the European Communities</funder> <funder>The Andrew W. Mellon Foundation</funder> <funder>The Social Sciences and Humanities Research Council of Canada</funder>
Content model	<content> <macroRef key="macro.phraseSeq.limited"/> </content>
Schema Declaration	element funder { att.global.attributes, att.canonical.attributes, macro.phraseSeq.limited }

1.130. <fw>

<fw> (forme work) contains a running head (e.g. a header, footer), catchword, or similar material appearing on the current page. [11.6. Headers, Footers, and Similar Matter]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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.written (@hand)

type

classifies the material encoded according to some useful typology.

Status	Recommended
Datatype	teidata.enumerated
Sample values include:	header a running title at the top of the page footer a running title at the bottom of the page pageNum (page number) a page number or foliation symbol lineNum (line number) a line number, either of prose or poetry sig (signature) a signature or gathering symbol catch (catchword) a catch-word

Member of

model.milestoneLike

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg listBibl name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc subst supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Note

Where running heads are consistent throughout a chapter or section, it is usually more convenient to relate them to the chapter or section, e.g. by use of the rend attribute. The <fw> element is intended for cases where the running head changes from page to page, or where details of page layout and the internal structure of the running heads are of paramount importance.

Example

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element fw
{
   att.global.attributes,
   att.placement.attributes,
   att.written.attributes,
   attribute type { text }?,
   macro.phraseSeq
}

1.131. <g>

<g> (character or glyph) represents a glyph, or a non-standard character. [5. Characters, Glyphs, and Writing Modes]

Module gaiji

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)

ref

points to a description of the character or glyph intended.

Status	Optional
Datatype	teidata.pointer

Member of

model.gLike

Contained by

analysis: c cl interp m pc phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

gaiji: mapping value

header: change distributor edition extent geoDecl handNote idno licence scriptNote

linking: ab seg

tagdocs: eg memberOf

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage ex fw line metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain Character data only

Note

The name g is short for gaiji, which is the Japanese term for a non-standardized character or glyph.

Example

This example points to a <glyph> element with the identifier ctlig like the following:

Example

The medieval brevigraph per could similarly be considered as an individual glyph, defined in a <glyph> element with the identifier per-glyph as follows:

Content model

<content>
 <textNode/>
</content>

Schema Declaration

element g
{
   att.global.attributes,
   att.typed.attributes,
   attribute ref { text }?,
   text
}

1.132. <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.4.3. Additions, Deletions, and Omissions]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.timed (@start, @end) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

reason

gives the reason for omission

Status	Optional
Datatype	1–∞ occurrences of teidata.enumerated separated by whitespace
Suggested values include:	cancelled deleted editorial for features omitted from transcription due to editorial policy illegible inaudible irrelevant sampling

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 damage results from rubbing of the leaf edges mildew damage results from mildew on the leaf surface smoke damage results from smoke

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

certainty: certainty precision respons

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

Example

Example

Example

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 )*
}

1.133. <genName>

<genName> (generational name component) contains a name component used to distinguish otherwise similar names on the basis of the relative ages or generations of the persons named. [13.2.1. Personal Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Member of	model.persNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<persName> <forename>Charles</forename> <genName>II</genName> </persName>
Example	<persName> <surname>Pitt</surname> <genName>the Younger</genName> </persName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element genName { att.global.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq }

1.134. <geo>

<geo> (geographical coordinates) contains any expression of a set of geographic coordinates, representing a point, line, or area on the surface of the earth in some notation. [13.3.4.1. Varieties of Location]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls)
Member of	model.measureLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	Character data only
Note	Uses of <geo> can be associated with a coordinate system, defined by a <geoDecl> element supplied in the TEI header, using the decls attribute. If no such link is made, the assumption is that the content of each <geo> element will be a pair of numbers separated by whitespace, to be interpreted as latitude followed by longitude according to the World Geodetic System.
Example	<geoDecl xml:id="WGS" datum="WGS84">World Geodetic System</geoDecl> <geoDecl xml:id="OS" datum="OSGB36">Ordnance Survey</geoDecl> <!-- ... --> <location> <desc>A tombstone plus six lines of Anglo-Saxon text, built into the west tower (on the south side of the archway, at 8 ft. above the ground) of the Church of St. Mary-le-Wigford in Lincoln.</desc> <geo decls="#WGS">53.226658 -0.541254</geo> <geo decls="#OS">SK 97481 70947</geo> </location>
Example	<geo>41.687142 -74.870109</geo>
Content model	<content> <textNode/> </content>
Schema Declaration	element geo { att.global.attributes, att.declaring.attributes, text }

1.135. <geoDecl>

<geoDecl> (geographic coordinates declaration) documents the notation and the datum used for geographic coordinates expressed as content of the <geo> element elsewhere within the document. [2.3.8. The Geographic Coordinates Declaration]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

datum

supplies a commonly used code name for the datum employed.

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	WGS84 (World Geodetic System) a pair of numbers to be interpreted as latitude followed by longitude according to the World Geodetic System.[Default] MGRS (Military Grid Reference System) the values supplied are geospatial entity object codes, based on OSGB36 (ordnance survey great britain) the value supplied is to be interpreted as a British National Grid Reference. ED50 (European Datum coordinate system) the value supplied is to be interpreted as latitude followed by longitude according to the European Datum coordinate system.

Member of

model.linePart model.pPart.transcriptional

Contained by

header: encodingDesc

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element geoDecl
{
   att.global.attributes,
   att.declarable.attributes,
   attribute datum { "WGS84" | "MGRS" | "OSGB36" | "ED50" }?,
   macro.phraseSeq
}

1.136. <geogFeat>

<geogFeat> (geographical feature name) contains a common noun identifying some geographical feature contained within a geographic name, such as valley, mount, etc. [13.2.3. Place Names]
Module	namesdates
Attributes	Attributes att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.offsetLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<geogName> The <geogFeat>vale</geogFeat> of White Horse</geogName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element geogFeat { att.datable.attributes, att.editLike.attributes, att.global.attributes, att.naming.attributes, att.typed.attributes, att.dimensions.attributes, macro.phraseSeq }

1.137. <geogName>

<geogName> (geographical name) identifies a name associated with some geographical feature such as Windrush Valley or Mount Sinai. [13.2.3. Place Names]
Module	namesdates
Attributes	Attributes att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype)
Member of	model.placeNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef linking: ab seg msdescription: accMat acquisition additions altIdentifier catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<geogName> <geogFeat>Mount</geogFeat> <name>Sinai</name> </geogName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element geogName { att.datable.attributes, att.editLike.attributes, att.global.attributes, att.naming.attributes, att.typed.attributes, macro.phraseSeq }

1.138. <gi>

<gi> (element name) contains the name (generic identifier) of an element. [22. Documentation Elements 22.5. Element Specifications]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (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
Sample values include:	TEI this element is part of the TEI scheme.[Default] DBK (docbook) this element is part of the Docbook scheme. XX (unknown) this element is part of an unknown scheme. Schematron this element is from Schematron. HTML this element is from the HTML scheme.

Member of

model.phrase.xml

Contained by

analysis: cl phr s span

core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

Empty element

Example

The <gi>xhtml:li</gi> element is roughly analogous to the <gi>item</gi> element, as is the <gi scheme="DBK">listItem</gi> element.

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.attributes, attribute scheme { text }?, teidata.name }

1.139. <glyph>

<glyph> (character glyph) provides descriptive information about a character glyph. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	gaiji: charDecl
May contain	core: desc note gaiji: charProp glyphName mapping
Example	<glyph xml:id="rstroke"> <glyphName>LATIN SMALL LETTER R WITH A FUNNY STROKE</glyphName> <charProp> <localName>entity</localName> <value>rstroke</value> </charProp> <figure> <graphic url="glyph-rstroke.png"/> </figure> </glyph>
Content model	<content> <sequence> <elementRef key="glyphName" minOccurs="0"/> <classRef key="model.descLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="charProp" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="mapping" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="figure" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.graphicLike" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.noteLike" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element glyph { att.global.attributes, ( glyphName?, model.descLike, charProp, mapping, figure, model.graphicLike, model.noteLike ) }

1.140. <glyphName>

<glyphName> (character glyph name) contains the name of a glyph, expressed following Unicode conventions for character names. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	gaiji: glyph
May contain	Character data only
Note	For characters of non-ideographic scripts, a name following the conventions for Unicode names should be chosen. For ideographic scripts, an Ideographic Description Sequence (IDS) as described in Chapter 10.1 of the Unicode Standard is recommended where possible. Projects working in similar fields are recommended to coordinate and publish their list of <glyphName>s to facilitate data exchange.
Example	<glyphName>CIRCLED IDEOGRAPH 4EBA</glyphName>
Content model	<content> <textNode/> </content>
Schema Declaration	element glyphName { att.global.attributes, text }

1.141. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

hands

specifies the number of distinct hands identified within the manuscript

Status	Optional
Datatype	teidata.count

Member of

model.physDescPart

Contained by

msdescription: physDesc

May contain

core: p

header: handNote

linking: ab

msdescription: summary

Example

<handDesc> <handNote scope="major">Written throughout in <term>angelicana formata</term>.</handNote> </handDesc>

Example

<handDesc hands="2"> 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. </handDesc>

Content model

<content>
 <alternate>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <sequence>
   <elementRef key="summary" minOccurs="0"/>
   <elementRef key="handNote" minOccurs="1"
    maxOccurs="unbounded"/>
  </sequence>
 </alternate>
</content>

Schema Declaration

element handDesc
{
   att.global.attributes,
   attribute hands { text }?,
   ( model.pLike+ | ( summary?, handNote+ ) )
}

1.142. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.handFeatures (@scribe, @scribeRef, @script, @scriptRef, @medium, @scope)
Contained by	msdescription: handDesc transcr: handNotes
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element handNote { att.global.attributes, att.handFeatures.attributes, macro.specialPara }

1.143. <handNotes>

<handNotes> contains one or more <handNote> elements documenting the different hands identified within the source texts. [11.3.2.1. Document Hands]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.profileDescPart
Contained by	header: profileDesc
May contain	header: handNote
Example	<handNotes> <handNote xml:id="H1" script="copperplate" medium="brown-ink">Carefully written with regular descenders</handNote> <handNote xml:id="H2" script="print" medium="pencil">Unschooled scrawl</handNote> </handNotes>
Content model	<content> <elementRef key="handNote" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element handNotes { att.global.attributes, handNote+ }

1.144. <handShift>

<handShift> marks the beginning of a sequence of text written in a new hand, or the beginning of a scribal stint. [11.3.2.1. Document Hands]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.handFeatures (@scribe, @scribeRef, @script, @scriptRef, @medium, @scope)

new

indicates a <handNote> element describing the hand concerned.

Status	Recommended
Datatype	teidata.pointer
Note	This attribute serves the same function as the hand attribute provided for those elements which are members of the att.transcriptional class. It may be renamed at a subsequent major release.

Member of

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone

verse: rhyme

May contain

Empty element

Note

The <handShift> element may be used either to denote a shift in the document hand (as from one scribe to another, on one writing style to another). Or, it may indicate a shift within a document hand, as a change of writing style, character or ink. Like other milestone elements, it should appear at the point of transition from some other state to the state which it describes.

Example

<l>When wolde the cat dwelle in his ynne</l> <handShift medium="greenish-ink"/> <l>And if the cattes skynne be slyk <handShift medium="black-ink"/> and gaye</l>

Content model

<content>
 <empty/>
</content>

Schema Declaration

element handShift
{
   att.global.attributes,
   att.handFeatures.attributes,
   attribute new { text }?,
   empty
}

1.145. <head>

<head> (heading) contains any type of heading, for example the title of a section, or the heading of a list, glossary, manuscript description, etc. [4.2.1. Headings and Trailers]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.placement (@place) att.written (@hand)
Member of	model.headLike model.pLike.front
Contained by	core: lg listBibl msdescription: msDesc msFrag msPart namesdates: climate event listEvent listNym listObject listOrg listPerson listPlace listRelation object org place population state terrain trait textcrit: listApp listWit textstructure: body div front
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The <head> element is used for headings at all levels; software which treats (e.g.) chapter headings, section headings, and list titles differently must determine the proper processing of a <head> element based on its structural position. A <head> occurring as the first element of a list is the title of that list; one occurring as the first element of a <div1> is the title of that chapter or section.
Example	The most common use for the <head> element is to mark the headings of sections. In older writings, the headings or incipits may be rather longer than usual in modern works. If a section has an explicit ending as well as a heading, it should be marked as a <trailer>, as in this example: <div1 n="I" type="book"> <head>In the name of Christ here begins the first book of the ecclesiastical history of Georgius Florentinus, known as Gregory, Bishop of Tours.</head> <div2 type="section"> <head>In the name of Christ here begins Book I of the history.</head> <p>Proposing as I do ...</p> <p>From the Passion of our Lord until the death of Saint Martin four hundred and twelve years passed.</p> <trailer>Here ends the first Book, which covers five thousand, five hundred and ninety-six years from the beginning of the world down to the death of Saint Martin.</trailer> </div2> </div1>
Example	When headings are not inline with the running text (see e.g. the heading "Secunda conclusio") they might however be encoded as if. The actual placement in the source document can be captured with the place attribute. <div type="subsection"> <head place="margin">Secunda conclusio</head> <p> <lb n="1251"/> <hi rend="large">Potencia: habitus: et actus: recipiunt speciem ab obiectis<supplied>.</supplied> </hi> <lb n="1252"/>Probatur sic. Omne importans necessariam habitudinem ad proprium [...] </p> </div>
Example	The <head> element is also used to mark headings of other units, such as lists: With a few exceptions, connectives are equally useful in all kinds of discourse: description, narration, exposition, argument. <list rend="bulleted"> <head>Connectives</head> <item>above</item> <item>accordingly</item> <item>across from</item> <item>adjacent to</item> <item>again</item> <item> <!-- ... --> </item> </list>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <elementRef key="lg"/> <classRef key="model.gLike"/> <classRef key="model.phrase"/> <classRef key="model.inter"/> <classRef key="model.lLike"/> <classRef key="model.global"/> </alternate> </content>
Schema Declaration	element head { att.global.attributes, att.typed.attributes, att.placement.attributes, att.written.attributes, ( text \| lg \| model.gLike \| model.phrase \| model.inter \| model.lLike \| model.global )* }

1.146. <height>

<height> contains a measurement measured along the axis at a right angle to the bottom of the object. [10.3.4. Dimensions]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.dimLike model.measureLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote dimensions explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	gaiji: g character data
Example	<height unit="in" quantity="7"/>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element height { att.global.attributes, att.dimensions.attributes, macro.xtext }

1.147. <heraldry>

<heraldry> contains a heraldic formula or phrase, typically found as part of a blazon, coat of arms, etc. [10.3.8. Heraldry]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<p>Ownership stamp (xvii cent.) on i recto with the arms <heraldry>A bull passant within a bordure bezanty, in chief a crescent for difference</heraldry> [Cole], crest, and the legend <q>Cole Deum</q>.</p>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element heraldry { att.global.attributes, macro.phraseSeq }

1.148. <hi>

<hi> (highlighted) marks a word or phrase as graphically distinct from the surrounding text, for reasons concerning which no claim is made. [3.3.2.2. Emphatic Words and Phrases 3.3.2. Emphasis, Foreign Words, and Unusual Language]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.written (@hand)
Member of	model.hiLike
Contained by	analysis: cl m phr s span w core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout locus material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw line metamark mod restore retrace secl supplied surplus zone verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.written.attributes, macro.paraContent }

1.149. <history>

<history> groups elements describing the full history of a manuscript, manuscript part, or other object. [10.8. History]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: msDesc msFrag msPart namesdates: object
May contain	core: p linking: ab msdescription: acquisition origin provenance summary
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> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <elementRef key="origin" minOccurs="0"/> <elementRef key="provenance" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="acquisition" minOccurs="0"/> </sequence> </alternate> </content>
Schema Declaration	element history { att.global.attributes, ( model.pLike+ \| ( summary?, origin?, provenance*, acquisition? ) ) }

1.150. <hyphenation>

<hyphenation> summarizes the way in which hyphenation in a source text has been treated in an encoded version of it. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

eol

(end-of-line) indicates whether or not end-of-line hyphenation has been retained in a text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	all all end-of-line hyphenation has been retained, even though the lineation of the original may not have been. some end-of-line hyphenation has been retained in some cases.[Default] hard all soft end-of-line hyphenation has been removed: any remaining end-of-line hyphenation should be retained. none all end-of-line hyphenation has been removed: any remaining hyphenation occurred within the line.

Member of

model.msItemPart model.nameLike model.personPart model.publicationStmtPart.detail

Contained by

header: editorialDecl

May contain

core: p

linking: ab

Example

<hyphenation eol="some"> End-of-line hyphenation silently removed where appropriate </hyphenation>

Content model

<content>
 <classRef key="model.pLike" minOccurs="1"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element hyphenation
{
   att.global.attributes,
   att.declarable.attributes,
   attribute eol { "all" | "some" | "hard" | "none" }?,
   model.pLike+
}

1.151. <ident>

<ident> (identifier) contains an identifier or name for an object of some kind in a formal language. <ident> is used for tokens such as variable names, class names, type names, function names etc. in formal programming languages. [22.1.1. Phrase Level Terms]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.emphLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	Character data only
Note	In running prose, this element may be used for any kind of identifier in any formal language. It should not be used for element and attribute names in XML, for which the special elements <gi> and <att> are provided.
Example	<ident type="ns">http://www.tei-c.org/ns/Examples</ident>
Content model	<content> <textNode/> </content>
Schema Declaration	element ident { att.global.attributes, att.typed.attributes, text }

1.152. <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.11.2.4. Imprint, Size of a Document, and Reprint Information]

Module header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.typed (type, @subtype)

type

categorizes the identifier, for example as an ISBN, Social Security number, etc.

Derived from	att.typed
Status	Optional
Datatype	teidata.enumerated
Suggested values include:	ISBN International Standard Book Number: a 13- or (if assigned prior to 2007) 10-digit identifying number assigned by the publishing industry to a published book or similar item, registered with the International ISBN Agency. ISSN International Standard Serial Number: an eight-digit number to uniquely identify a serial publication. DOI Digital Object Identifier: a unique string of letters and numbers assigned to an electronic document. URI Uniform Resource Identifier: a string of characters to uniquely identify a resource which usually contains indication of the means of accessing that resource, the name of its host, and its filepath. VIAF A data number in the Virtual Internet Authority File assigned to link different names in catalogs around the world for the same entity. ESTC English Short-Title Catalogue number: an identifying number assigned to a document in English printed in the British Isles or North America before 1801. OCLC OCLC control number (record number) for the union catalog record in WorldCat, a union catalog for member libraries in the Online Computer Library Center global cooperative.

Member of

Contained by

analysis: cl phr s span

core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

gaiji: g

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.attributes,
   att.sortable.attributes,
   att.datable.attributes,
   att.typed.attribute.subtype,
   attribute type
   {
      "ISBN" | "ISSN" | "DOI" | "URI" | "VIAF" | "ESTC" | "OCLC"
   }?,
   ( text | model.gLike | idno )*
}

1.153. <incipit>

<incipit> contains the incipit of a manuscript or similar object item, that is the opening words of the text proper, exclusive of any rubric which might precede it, of sufficient length to identify the work uniquely; such incipits were, in former times, frequently used a means of reference to a work, in place of a title. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.msExcerpt (@defective)
Member of	model.msQuoteLike
Contained by	msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<incipit>Pater noster qui es in celis</incipit> <incipit defective="true">tatem dedit hominibus alleluia.</incipit> <incipit type="biblical">Ghif ons huden onse dagelix broet</incipit> <incipit>O ongehoerde gewerdighe christi</incipit> <incipit type="lemma">Firmiter</incipit> <incipit>Ideo dicit firmiter quia ordo fidei nostre probari non potest</incipit>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element incipit { att.global.attributes, att.typed.attributes, att.msExcerpt.attributes, macro.phraseSeq }

1.154. <institution>

<institution> contains the name of an organization such as a university or library, with which a manuscript or other object is identified, generally its holding institution. [10.4. The Manuscript Identifier]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Contained by	msdescription: altIdentifier msIdentifier namesdates: objectIdentifier
May contain	gaiji: g 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.xtext"/> </content>
Schema Declaration	element institution { att.global.attributes, att.naming.attributes, macro.xtext }

1.155. <interp>

<interp> (interpretation) summarizes a specific interpretative annotation which can be linked to a span of text. [17.3. Spans and Interpretations]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.interpLike (@type, @inst)
Member of	model.global.meta
Contained by	analysis: cl interpGrp m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	certainty: certainty precision respons core: desc gaiji: g character data
Note	Generally, each <interp> element carries an xml:id attribute. This permits the encoder to explicitly associate the interpretation represented by the content of an <interp> with any textual element through its ana attribute. Alternatively (or, in addition) an <interp> may carry an inst attribute which points to one or more textual elements to which the analysis represented by the content of the <interp> applies.
Example	<interp type="structuralunit" xml:id="ana_am">aftermath</interp>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.gLike"/> <classRef key="model.descLike"/> <classRef key="model.certLike"/> </alternate> </content>
Schema Declaration	element interp { att.global.attributes, att.interpLike.attributes, ( text \| model.gLike \| model.descLike \| model.certLike )* }

1.156. <interpGrp>

<interpGrp> (interpretation group) collects together a set of related interpretations which share responsibility or type. [17.3. Spans and Interpretations]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.interpLike (@type, @inst)
Member of	model.global.meta
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	analysis: interp core: desc
Note	Any number of <interp> elements.
Example	<interpGrp resp="#TMA" type="structuralunit"> <desc>basic structural organization</desc> <interp xml:id="I1">introduction</interp> <interp xml:id="I2">conflict</interp> <interp xml:id="I3">climax</interp> <interp xml:id="I4">revenge</interp> <interp xml:id="I5">reconciliation</interp> <interp xml:id="I6">aftermath</interp> </interpGrp> <bibl xml:id="TMA"> <!-- bibliographic citation for source of this interpretive framework --> </bibl>
Content model	<content> <sequence> <classRef key="model.descLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="interp" minOccurs="1" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element interpGrp { att.global.attributes, att.interpLike.attributes, ( model.descLike*, interp+ ) }

1.157. <interpretation>

<interpretation> describes the scope of any analytic or interpretive information added to the text in addition to the transcription. [2.3.3. The Editorial Practices Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.editorialDeclPart
Contained by	header: editorialDecl
May contain	core: p linking: ab
Example	<interpretation> <p>The part of speech analysis applied throughout section 4 was added by hand and has not been checked</p> </interpretation>
Content model	<content> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element interpretation { att.global.attributes, att.declarable.attributes, model.pLike+ }

1.158. <join>

<join> identifies a possibly fragmented segment of text, by pointing at the possibly discontiguous elements which compose it. [16.7. Aggregation]

Module

linking

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.typed (@type, @subtype)

result

specifies the name of an element which this aggregation may be understood to represent.

Status	Optional
Datatype	teidata.name

scope

indicates whether the targets to be joined include the entire element indicated (the entire subtree including its root), or just the children of the target (the branches of the subtree).

Status	Recommended
Datatype	teidata.enumerated
Legal values are:	root the rooted subtrees indicated by the target attribute are joined, each subtree become a child of the virtual element created by the join[Default] branches the children of the subtrees indicated by the target attribute become the children of the virtual element (i.e. the roots of the subtrees are discarded)

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab joinGrp seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

certainty: certainty precision respons

core: desc

Example

The following example is discussed in section [[undefined SAAG]]:

<sp> <speaker>Hughie</speaker> How does it go? <q> <l xml:id="frog_x1">da-da-da</l> <l xml:id="frog_l2">gets a new frog</l> <l>...</l> </q> </sp> <sp> <speaker>Louie</speaker> <q> <l xml:id="frog_l1">When the old pond</l> <l>...</l> </q> </sp> <sp> <speaker>Dewey</speaker> <q>... <l xml:id="frog_l3">It's a new pond.</l> </q> <join target="#frog_l1 #frog_l2 #frog_l3" result="lg" scope="root"/> </sp>

The <join> element here identifies a linegroup (<lg>) comprising the three lines indicated by the target attribute. The value root for the scope attribute indicates that the resulting virtual element contains the three <l> elements linked to at #frog_l1 #frog_l2 #frog_l3, rather than their character data content.

Example

In this example, the attribute scope is specified with the value of branches to indicate that the virtual list being constructed is to be made by taking the lists indicated by the target attribute of the <join> element, discarding the <list> tags which enclose them, and combining the items contained within the lists into a single virtual list:

Southern dialect (my own variety, at least) has only <list xml:id="LP1"> <item> <s>I done gone</s> </item> <item> <s>I done went</s> </item> </list> whereas Negro Non-Standard basilect has both these and <list xml:id="LP2"> <item> <s>I done go</s> </item> </list>. White Southern dialect also has <list xml:id="LP3"> <item> <s>I've done gone</s> </item> <item> <s>I've done went</s> </item> </list> which, when they occur in Negro dialect, should probably be considered as borrowings from other varieties of English. <join result="list" xml:id="LST1" target="#LP1 #LP2 #LP3" scope="branches"> <desc>Sample sentences in Southern speech</desc> </join>

Schematron

<s:assert test="contains(@target,' ')">You must supply at least two values for @target on <s:name/> </s:assert>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>

Schema Declaration

element join
{
   att.global.attributes,
   att.pointing.attributes,
   att.typed.attributes,
   attribute result { text }?,
   attribute scope { "root" | "branches" }?,
   ( model.descLike | model.certLike )*
}

1.159. <joinGrp>

<joinGrp> (join group) groups a collection of <join> elements and possibly pointers. [16.7. Aggregation]

Module

linking

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing.group (@domains, @targFunc) (att.pointing (@targetLang, @target, @evaluate)) (att.typed (@type, @subtype))

result

supplies the default value for the result on each <join> included within the group.

Status	Optional
Datatype	teidata.name

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

linking: join

tagdocs: altIdent equiv

Note

Any number of <join> or <ptr> elements.

Example

Content model

<content>
 <sequence>
  <classRef key="model.glossLike"
   minOccurs="0" maxOccurs="unbounded"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <elementRef key="join"/>
   <elementRef key="ptr"/>
  </alternate>
 </sequence>
</content>

Schema Declaration

element joinGrp
{
   att.global.attributes,
   att.pointing.group.attributes,
   attribute result { text }?,
   ( model.glossLike*, ( join | ptr )+ )
}

1.160. <keywords>

<keywords> contains a list of keywords or phrases identifying the topic or nature of a text. [2.4.3. The Text Classification]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

scheme

identifies the controlled vocabulary within which the set of keywords concerned is defined, for example by a <taxonomy> element, or by some other resource.

Status	Optional
Datatype	teidata.pointer

Contained by

header: textClass

May contain

header: list

Note

Each individual keyword (including compound subject headings) should be supplied as a <term> element directly within the <keywords> element. An alternative usage, in which each <term> appears within a <item> inside a <list> is permitted for backwards compatibility, but is deprecated.

If no control list exists for the keywords used, then no value should be supplied for the scheme attribute.

Example

<keywords scheme="http://classificationweb.net"> <term>Babbage, Charles</term> <term>Mathematicians - Great Britain - Biography</term> </keywords>

Example

<keywords> <term>Fermented beverages</term> <term>Central Andes</term> <term>Schinus molle</term> <term>Molle beer</term> <term>Indigenous peoples</term> <term>Ethnography</term> <term>Archaeology</term> </keywords>

Content model

<content>
 <alternate>
  <elementRef key="term" minOccurs="1"
   maxOccurs="unbounded"/>
  <elementRef key="list"/>
 </alternate>
</content>

Schema Declaration

element keywords
{
   att.global.attributes,
   attribute scheme { text }?,
   ( term+ | list )
}

1.161. <l>

<l> (verse line) contains a single, possibly incomplete, line of verse. [3.12.1. Core Tags for Verse 3.12. Passages of Verse or Drama 7.2.5. Speech Contents]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.metrical (@met, @real, @rhyme) att.enjamb (@enjamb) att.fragmentable (@part)
Member of	model.lLike
Contained by	core: add del head hi lg note p q quote ref reg sic title unclear header: change handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: specGrp textcrit: lem rdg textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi lb listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<l met="x/x/x/x/x/" real="/xx/x/x/x/">Shall I compare thee to a summer's day?</l>
Schematron	<s:report test="ancestor::tei:l[not(.//tei:note//tei:l[. = current()])]"> Abstract model violation: Lines may not contain lines or lg elements. </s:report>
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"/> </alternate> </content>
Schema Declaration	element l { att.global.attributes, att.metrical.attributes, att.enjamb.attributes, att.fragmentable.attributes, ( text \| model.gLike \| model.phrase \| model.inter \| model.global )* }

1.162. <lacunaEnd>

<lacunaEnd> indicates the end of a lacuna in a mostly complete textual witness. [12.1.5. Fragmentary Witnesses]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.rdgPart (@wit)
Member of	model.rdgPart
Contained by	textcrit: lem rdg
May contain	Empty element
Example	<rdg wit="#X"> <lacunaEnd/>auctorite </rdg>
Content model	<content> <empty/> </content>
Schema Declaration	element lacunaEnd { att.global.attributes, att.rdgPart.attributes, empty }

1.163. <lacunaStart>

<lacunaStart> indicates the beginning of a lacuna in the text of a mostly complete textual witness. [12.1.5. Fragmentary Witnesses]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.rdgPart (@wit)
Member of	model.rdgPart
Contained by	textcrit: lem rdg
May contain	Empty element
Example	<app> <lem wit="#El #Hg">Experience</lem> <rdg wit="#Ha4">Ex<g ref="#per"/> <lacunaStart/> </rdg> </app>
Content model	<content> <empty/> </content>
Schema Declaration	element lacunaStart { att.global.attributes, att.rdgPart.attributes, empty }

1.164. <langKnowledge>

<langKnowledge> (language knowledge) summarizes the state of a person's linguistic knowledge, either as prose or by a list of <langKnown> elements. [13.3.2.1. Personal Characteristics]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.typed (type, @subtype)

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:	listening speaking reading writing

1.165. <langKnown>

<langKnown> (language known) summarizes the state of a person's linguistic competence, i.e., knowledge of a single language. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant)

tag

supplies a valid language tag for the language concerned.

Status	Required
Datatype	teidata.language
Note	The value for this attribute should be a language ‘tag’ as defined in BCP 47.

level

a code indicating the person's level of knowledge for this language

Status	Optional
Datatype	teidata.word

Contained by

namesdates: langKnowledge

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: address choice date email gap hi lb milestone name note pb ref time title

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident tag val

textcrit: app witDetail

transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin

character data

Example

<langKnown tag="en-GB" level="H">British English</langKnown> <langKnown tag="fr" level="M">French</langKnown>

Content model

<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>

Schema Declaration

element langKnown
{
   att.global.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   attribute tag { text },
   attribute level { text }?,
   macro.phraseSeq.limited
}

1.166. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.profileDescPart
Contained by	header: profileDesc
May contain	core: p header: language linking: ab
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> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <elementRef key="language" minOccurs="1" maxOccurs="unbounded"/> </alternate> </content>
Schema Declaration	element langUsage { att.global.attributes, att.declarable.attributes, ( model.pLike+ \| language+ ) }

1.167. <language>

<language> characterizes a single language or sublanguage used within a text. [2.4.2. Language Usage]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (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

usage

specifies the approximate percentage (by volume) of the text which uses this language.

Status	Optional
Datatype	nonNegativeInteger

Contained by

header: langUsage

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: address choice date email gap hi lb milestone name note pb ref time title

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident tag val

textcrit: app witDetail

transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin

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.attributes,
   attribute ident { text },
   attribute usage { text }?,
   macro.phraseSeq.limited
}

1.168. <layout>

<layout> describes how text is laid out on the page or surface of the object, including information about any ruling, pricking, or other evidence of page-preparation techniques. [10.7.2. Writing, Decoration, and Other Notations]

Module

msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

columns

specifies the number of columns per page

Status

Optional

Datatype

1–2 occurrences of teidata.count separated by whitespace

Note

If a single number is given, all pages referenced have this number of columns. If two numbers are given, the number of columns per page varies between the values supplied. Where columns is omitted the number is assumed to be 1.

Columns may be independent of page orientation or reading direction, and a single textual stream may have one or more columns.

streams

(textual streams) indicates the number of streams per page, each of which contains an independent textual stream

Status	Optional
Datatype	1–2 occurrences of teidata.count separated by whitespace
Note	If a single number is given, all pages referenced have this number of textual streams. If two numbers are given, the number of textual streams per page varies between the values supplied. Where streams is omitted the number is assumed to be 1 and unless specified elsewhere the script orientation of the source is identical to that used in the TEI document.

ruledLines

specifies the number of ruled lines per column

Status	Optional
Datatype	1–2 occurrences of teidata.count separated by whitespace
Note	If a single number is given, all columns have this number of ruled lines. If two numbers are given, the number of ruled lines per column varies between the values supplied.

writtenLines

specifies the number of written lines per column

Status	Optional
Datatype	1–2 occurrences of teidata.count separated by whitespace
Note	If a single number is given, all columns have this number of written lines. If two numbers are given, the number of written lines per column varies between the values supplied.

Contained by

msdescription: layoutDesc

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<layout columns="1" ruledLines="25 32">Most pages have between 25 and 32 long lines ruled in lead.</layout>

Example

<layout columns="2" ruledLines="42"> 2 columns of 42 lines ruled in ink, with central rule between the columns. </layout>

Example

<layout columns="1 2" writtenLines="40 50"> Some pages have 2 columns, with central rule between the columns; each column with between 40 and 50 lines of writing. </layout>

Example

Content model

<content>
 <macroRef key="macro.specialPara"/>
</content>

Schema Declaration

element layout
{
   att.global.attributes,
   attribute columns { list { ? } }?,
   attribute streams { list { ? } }?,
   attribute ruledLines { list { ? } }?,
   attribute writtenLines { list { ? } }?,
   macro.specialPara
}

1.169. <layoutDesc>

<layoutDesc> (layout description) collects the set of layout descriptions applicable to a manuscript or other object. [10.7.2. Writing, Decoration, and Other Notations]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: objectDesc
May contain	core: p linking: ab msdescription: layout summary
Example	<layoutDesc> <p>Most pages have between 25 and 32 long lines ruled in lead.</p> </layoutDesc>
Example	<layoutDesc> <layout columns="2" ruledLines="42"> <p> <locus from="f12r" to="f15v"/> 2 columns of 42 lines pricked and ruled in ink, with central rule between the columns.</p> </layout> <layout columns="3"> <p> <locus from="f16"/>Prickings for three columns are visible.</p> </layout> </layoutDesc>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <elementRef key="layout" minOccurs="1" maxOccurs="unbounded"/> </sequence> </alternate> </content>
Schema Declaration	element layoutDesc { att.global.attributes, ( model.pLike+ \| ( summary?, layout+ ) ) }

1.170. <lb>

<lb> (line beginning) marks the beginning of a new (typographic) line in some edition or version of a text. [3.10.3. Milestone Elements 7.2.5. Speech Contents]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.edition (@ed, @edRef) att.spanning (@spanTo) att.breaking (@break)
Member of	model.milestoneLike
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg listBibl name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc subst supplied surface surfaceGrp surplus zone verse: metSym rhyme
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.attributes, att.typed.attributes, att.edition.attributes, att.spanning.attributes, att.breaking.attributes, empty }

1.171. <lem>

<lem> (lemma) contains the lemma, or base text, of a textual variation. [12.1. The Apparatus Entry, Readings, and Witnesses]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.textCritical (@type, @cause, @varSeq, @require) (att.written (@hand)) att.witnessed (@wit)
Contained by	textcrit: app rdgGrp
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app lacunaEnd lacunaStart listApp listWit wit witDetail witEnd witStart textstructure: div transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The term lemma is used in text criticism to describe the reading in the text itself (as opposed to those in the apparatus); this usage is distinct from that of mathematics (where a lemma is a major step in a proof) and natural-language processing (where a lemma is the dictionary form associated with an inflected form in the running text).
Example	<app> <lem wit="#El #Hg">Experience</lem> <rdg wit="#La" type="substantive">Experiment</rdg> <rdg wit="#Ra2" type="substantive">Eryment</rdg> </app>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.divLike"/> <classRef key="model.divPart"/> <classRef key="model.gLike"/> <classRef key="model.phrase"/> <classRef key="model.inter"/> <classRef key="model.global"/> <classRef key="model.rdgPart"/> </alternate> </content>
Schema Declaration	element lem { att.global.attributes, att.textCritical.attributes, att.witnessed.attributes, ( text \| model.divLike \| model.divPart \| model.gLike \| model.phrase \| model.inter \| model.global \| model.rdgPart )* }

1.172. <lg>

<lg> (line group) contains one or more verse lines functioning as a formal unit, e.g. a stanza, refrain, verse paragraph, etc. [3.12.1. Core Tags for Verse 3.12. Passages of Verse or Drama 7.2.5. Speech Contents]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.divLike (@org, @sample) (att.metrical (@met, @real, @rhyme)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.declaring (@decls)
Member of	macro.paraContent model.divPart
Contained by	core: add del head hi lg note p q quote ref reg sic title unclear header: change handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: specGrp textcrit: lem rdg textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: desc gap head l lb lg milestone note pb linking: alt altGrp anchor join joinGrp link linkGrp timeline textcrit: app witDetail textstructure: dateline transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin
Note	contains verse lines or nested line groups only, possibly prefixed by a heading.
Example	<lg type="free"> <l>Let me be my own fool</l> <l>of my own making, the sum of it</l> </lg> <lg type="free"> <l>is equivocal.</l> <l>One says of the drunken farmer:</l> </lg> <lg type="free"> <l>leave him lay off it. And this is</l> <l>the explanation.</l> </lg>
Schematron	<sch:assert test="count(descendant::tei:lg\|descendant::tei:l\|descendant::tei:gap) > 0">An lg element must contain at least one child l, lg, or gap element.</sch:assert>
Schematron	<s:report test="ancestor::tei:l[not(.//tei:note//tei:lg[. = current()])]"> Abstract model violation: Lines may not contain line groups. </s:report>
Content model	<content> <sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.divTop"/> <classRef key="model.global"/> </alternate> <alternate> <classRef key="model.lLike"/> <classRef key="model.stageLike"/> <classRef key="model.labelLike"/> <elementRef key="lg"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.lLike"/> <classRef key="model.stageLike"/> <classRef key="model.labelLike"/> <classRef key="model.global"/> <elementRef key="lg"/> </alternate> <sequence minOccurs="0" maxOccurs="unbounded"> <classRef key="model.divBottom"/> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> </sequence> </sequence> </content>
Schema Declaration	element lg { att.global.attributes, att.divLike.attributes, att.typed.attributes, att.declaring.attributes, ( ( model.divTop \| model.global ), ( model.lLike \| model.stageLike \| model.labelLike \| lg ), ( model.lLike \| model.stageLike \| model.labelLike \| model.global \| lg ), ( model.divBottom, model.global* )* ) }

1.173. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.availabilityPart
Contained by	header: availability
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.pointing.attributes, att.datable.attributes, macro.specialPara }

1.174. <line>

<line> contains the transcription of a topographic line in the source document [11.2.2. Embedded Transcription]
Module	transcr
Attributes	Attributes att.typed (@type, @subtype) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.coordinated (@start, @ulx, @uly, @lrx, @lry, @points) att.written (@hand)
Member of	model.linePart
Contained by	transcr: line surface zone
May contain	analysis: c interp interpGrp pc span spanGrp w certainty: certainty precision respons core: add choice del gap hi lb milestone note pb unclear gaiji: g linking: alt altGrp anchor join joinGrp link linkGrp seg timeline textcrit: app witDetail transcr: addSpan damage damageSpan delSpan fw handShift line listTranspose metamark mod path redo restore retrace space substJoin undo zone character data
Note	This element should be used only to mark up writing which is topographically organized as a series of lines, horizontal or vertical. It should not be used to mark lines of verse (for which use <l>) nor to mark linebreaks within text which has been encoded using structural elements such as <p> (for which use <lb>).
Example	<surface> <zone> <line>Poem</line> <line>As in Visions of — at</line> <line>night —</line> <line>All sorts of fancies running through</line> <line>the head</line> </zone> </surface>
Example	<surface> <zone> <line>Hope you enjoyed</line> <line>Wales, as they said</line> <line>to Mrs FitzHerbert</line> <line>Mama</line> </zone> <zone> <line>Printed in England</line> </zone> </surface>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.global"/> <classRef key="model.gLike"/> <classRef key="model.linePart"/> </alternate> </content>
Schema Declaration	element line { att.typed.attributes, att.global.attributes, att.coordinated.attributes, att.written.attributes, ( text \| model.global \| model.gLike \| model.linePart )* }

1.175. <link>

<link> defines an association or hypertextual link among elements or passages, of some type not more precisely specifiable by other elements. [16.1. Links]
Module	linking
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.typed (@type, @subtype)
Member of	model.global.meta
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab linkGrp seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education event faith floruit forename genName geogFeat geogName langKnown nameLink nationality object objectName occupation offset org orgName persName person personGrp persona place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	Empty element
Note	This element should only be used to encode associations not otherwise provided for by more specific elements. The location of this element within a document has no significance, unless it is included within a <linkGrp>, in which case it may inherit the value of the type attribute from the value given on the <linkGrp>.
Example	<s n="1">The state Supreme Court has refused to release <rs xml:id="R1"> <rs xml:id="R2">Rahway State Prison</rs> inmate</rs> <rs xml:id="R3">James Scott</rs> on bail.</s> <s n="2"> <rs xml:id="R4">The fighter</rs> is serving 30-40 years for a 1975 armed robbery conviction in <rs xml:id="R5">the penitentiary</rs>. </s> <!-- ... --> <linkGrp type="periphrasis"> <link target="#R1 #R3 #R4"/> <link target="#R2 #R5"/> </linkGrp>
Schematron	<sch:assert test="contains(normalize-space(@target),' ')">You must supply at least two values for @target or on <sch:name/> </sch:assert>
Content model	<content> <empty/> </content>
Schema Declaration	element link { att.global.attributes, att.pointing.attributes, att.typed.attributes, empty }

1.176. <linkGrp>

<linkGrp> (link group) defines a collection of associations or hypertextual links. [16.1. Links]
Module	linking
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing.group (@domains, @targFunc) (att.pointing (@targetLang, @target, @evaluate)) (att.typed (@type, @subtype))
Member of	model.global.meta
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education event faith floruit forename genName geogFeat geogName langKnown nameLink nationality object objectName occupation offset org orgName persName person personGrp persona place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	linking: link
Note	May contain one or more <link> or <ptr> elements. A web or link group is an administrative convenience, which should be used to collect a set of links together for any purpose, not simply to supply a default value for the type attribute.
Example	<linkGrp type="translation"> <link target="#CCS1 #SW1"/> <link target="#CCS2 #SW2"/> <link target="#CCS #SW"/> </linkGrp> <div type="volume" xml:id="CCS" xml:lang="fr"> <p> <s xml:id="CCS1">Longtemps, je me suis couché de bonne heure.</s> <s xml:id="CCS2">Parfois, à peine ma bougie éteinte, mes yeux se fermaient si vite que je n'avais pas le temps de me dire : "Je m'endors."</s> </p> <!-- ... --> </div> <div type="volume" xml:id="SW" xml:lang="en"> <p> <s xml:id="SW1">For a long time I used to go to bed early.</s> <s xml:id="SW2">Sometimes, when I had put out my candle, my eyes would close so quickly that I had not even time to say "I'm going to sleep."</s> </p> <!-- ... --> </div>
Content model	<content> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="link"/> <elementRef key="ptr"/> </alternate> </content>
Schema Declaration	element linkGrp { att.global.attributes, att.pointing.group.attributes, ( link \| ptr )+ }

1.177. <list>

<list>
Module	header
Contained by	header: keywords revisionDesc
May contain	Empty element

1.178. <listApp>

<listApp> (list of apparatus entries) contains a list of apparatus entries. [12.2. Linking the Apparatus to the Text]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.declarable (@default) att.typed (@type, @subtype)
Member of	model.listLike
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation textcrit: lem listApp rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head textcrit: app listApp
Note	<listApp> elements would normally be located in the <back> part of a document, but they may appear elsewhere.
Example	In the following example from the exegetical Yasna, the base text is encoded in the <body> of the document, and two separate <listApp> elements are used in the <back>, containing variant readings written in different scripts. <body> <div> <lg type="stanza" xml:id="Y-36.01" xml:lang="pal-Avst" rend="italic"> <l xml:id="Y-36.01_L-1"> <w xml:id="Y-36.01_L1_W-01">ahiiā</w> <w xml:id="Y-36.01_L1_W-02">ϑβā</w> <w xml:id="Y-36.01_L1_W-03">āϑrō</w> <w xml:id="Y-36.01_L1_W-04">vərəzə̄nā</w> <w xml:id="Y-36.01_L1_W-05">paouruiiē</w> <w xml:id="Y-36.01_L1_W-06">pairijasāmaiδē</w> <w xml:id="Y-36.01_L1_W-07">mazdā</w> <w xml:id="Y-36.01_L1_W-08">ahurā</w> </l> <!-- ... --> </lg> </div> </body> <!-- ... --> <back> <div> <listApp xml:id="CA_Y-36" xml:lang="pal-Avst"> <head>Variants from witnesses in Avestan script</head> <app from="#Y-36.01_L1_W-01"> <rdg wit="#Pt4 #F2 #J2 #M1">ahiiā</rdg> </app> <app from="#Y-36.01_L1_W-02"> <rdg wit="#Pt4 #F2 #J2 #M1">ϑβā</rdg> </app> <app from="#Y-36.01_L1_W-03"> <rdg wit="#Pt4 #J2 #M1">āϑrō</rdg> <rdg wit="#F2">āϑrōi</rdg> </app> <!-- ... --> </listApp> <listApp xml:id="CA_PY-36" xml:lang="pal-Phlv"> <head>Variants from witnesses written in Pahlavi script</head> <app from="#PY-36.01_L1_W-01"> <rdg wit="#Pt4 #F2 #J2 #M1">ʾytwnˈ</rdg> </app> <app from="#PY-36.01_L1_W-02"> <rdg wit="#Pt4 #F2 #J2 #M1">ʾwˈ</rdg> </app> <app from="#PY-36.01_L1_W-03"> <rdg wit="#Pt4 #F2 #J2 #M1">ḤNʾ</rdg> </app> <!-- ... --> </listApp> </div> </back>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="app"/> <elementRef key="listApp"/> </alternate> </sequence> </content>
Schema Declaration	element listApp { att.global.attributes, att.sortable.attributes, att.declarable.attributes, att.typed.attributes, ( model.headLike, desc, ( app \| listApp )+ ) }

1.179. <listBibl>

<listBibl> (citation list) contains a list of bibliographic citations of any kind. [3.11.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.declarable (@default) att.typed (@type, @subtype)
Member of	model.biblLike model.frontPart
Contained by	core: add del desc head hi l listBibl note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote sourceDesc tagUsage taxonomy linking: ab seg msdescription: accMat acquisition additional additions collation condition custEvent decoNote filiation foliation layout msItem msItemStruct musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: climate event location object occupation org person personGrp persona place population state terrain trait textcrit: lem rdg witness textstructure: body div front transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: bibl desc head lb listBibl milestone pb header: biblFull linking: anchor msdescription: msDesc namesdates: listRelation relation transcr: fw
Example	<listBibl> <head>Works consulted</head> <bibl>Blain, Clements and Grundy: Feminist Companion to Literature in English (Yale, 1990) </bibl> <biblStruct> <analytic> <title>The Interesting story of the Children in the Wood</title> </analytic> <monogr> <title>The Penny Histories</title> <author>Victor E Neuberg</author> <imprint> <publisher>OUP</publisher> <date>1968</date> </imprint> </monogr> </biblStruct> </listBibl>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.biblLike"/> <classRef key="model.milestoneLike"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listBibl { att.global.attributes, att.sortable.attributes, att.declarable.attributes, att.typed.attributes, ( model.headLike, desc, ( model.biblLike \| model.milestoneLike )+, ( relation \| listRelation )* ) }

1.180. <listChange>

<listChange> groups a number of change descriptions associated with either the creation of a source text or the revision of an encoded text. [2.6. The Revision Description 11.7. Identifying Changes and Revisions]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.typed (@type, @subtype)

ordered

indicates whether the ordering of its child <change> elements is to be considered significant or not

Status	Optional
Datatype	teidata.truthValue
Default	true

Contained by

header: creation listChange revisionDesc

May contain

core: desc

header: change listChange

Note

When this element appears within the <creation> element it documents the set of revision campaigns or stages identified during the evolution of the original text. When it appears within the <revisionDesc> element, it documents only changes made during the evolution of the encoded representation of that text.

Example

<revisionDesc> <listChange> <change when="1991-11-11" who="#LB"> deleted chapter 10 </change> <change when="1991-11-02" who="#MSM"> completed first draft </change> </listChange> </revisionDesc>

Example

<profileDesc> <creation> <listChange ordered="true"> <change xml:id="CHG-1">First stage, written in ink by a writer</change> <change xml:id="CHG-2">Second stage, written in Goethe's hand using pencil</change> <change xml:id="CHG-3">Fixation of the revised passages and further revisions by Goethe using ink</change> <change xml:id="CHG-4">Addition of another stanza in a different hand, probably at a later stage</change> </listChange> </creation> </profileDesc>

Content model

<content>
 <sequence>
  <elementRef key="desc" minOccurs="0"
   maxOccurs="unbounded"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <elementRef key="listChange"/>
   <elementRef key="change"/>
  </alternate>
 </sequence>
</content>

Schema Declaration

element listChange
{
   att.global.attributes,
   att.sortable.attributes,
   att.typed.attributes,
   attribute ordered { text }?,
   ( desc*, ( listChange | change )+ )
}

1.181. <listEvent>

<listEvent> (list of events) contains a list of descriptions, each of which provides information about an identifiable event. [13.3.1. Basic Principles]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declarable (@default) att.sortable (@sortKey)
Member of	model.eventLike model.listLike
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listEvent occupation org person personGrp persona place textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head namesdates: event listEvent listRelation relation
Example	<listEvent> <head>Battles of the American Civil War: Kentucky</head> <event xml:id="event01" when="1861-09-19"> <label>Barbourville</label> <desc>The Battle of Barbourville was one of the early engagements of the American Civil War. It occurred September 19, 1861, in Knox County, Kentucky during the campaign known as the Kentucky Confederate Offensive. The battle is considered the first Confederate victory in the commonwealth, and threw a scare into Federal commanders, who rushed troops to central Kentucky in an effort to repel the invasion, which was finally thwarted at the <ref target="#event02">Battle of Camp Wildcat</ref> in October.</desc> </event> <event xml:id="event02" when="1861-10-21"> <label>Camp Wild Cat</label> <desc>The Battle of Camp Wildcat (also known as Wildcat Mountain and Camp Wild Cat) was one of the early engagements of the American Civil War. It occurred October 21, 1861, in northern Laurel County, Kentucky during the campaign known as the Kentucky Confederate Offensive. The battle is considered one of the very first Union victories, and marked the first engagement of troops in the commonwealth of Kentucky.</desc> </event> <event xml:id="event03" from="1864-06-11" to="1864-06-12"> <label>Cynthiana</label> <desc>The Battle of Cynthiana (or Kellar’s Bridge) was an engagement during the American Civil War that was fought on June 11 and 12, 1864, in Harrison County, Kentucky, near the town of Cynthiana. A part of Confederate Brigadier General John Hunt Morgan's 1864 Raid into Kentucky, the battle resulted in a victory by Union forces over the raiders and saved the town from capture.</desc> </event> </listEvent>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.eventLike" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listEvent { att.global.attributes, att.typed.attributes, att.declarable.attributes, att.sortable.attributes, ( model.headLike, desc, model.eventLike+, ( relation \| listRelation )* ) }

1.182. <listNym>

<listNym> (list of canonical names) contains a list of nyms, that is, standardized names for any thing. [13.3.6. Names and Nyms]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declarable (@default) att.sortable (@sortKey)
Member of	model.listLike
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listNym occupation textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head namesdates: listNym listRelation nym relation
Note	The type attribute may be used to distinguish lists of names of a particular type if convenient.
Example	<listNym type="floral"> <nym xml:id="ROSE"> <form>Rose</form> </nym> <nym xml:id="DAISY"> <form>Daisy</form> <etym>Contraction of <mentioned>day's eye</mentioned> </etym> </nym> <nym xml:id="HTHR"> <form>Heather</form> </nym> </listNym>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="nym"/> <elementRef key="listNym"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listNym { att.global.attributes, att.typed.attributes, att.declarable.attributes, att.sortable.attributes, ( model.headLike, desc, ( nym \| listNym )+, ( relation \| listRelation )* ) }

1.183. <listObject>

<listObject> (list of objects) contains a list of descriptions, each of which provides information about an identifiable physical object. [13.3.5. Objects]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declarable (@default) att.sortable (@sortKey)
Member of	model.listLike model.objectLike
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listObject occupation textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head namesdates: listObject listRelation object relation
Note	The type attribute may be used to distinguish different types of objects.
Example	<listObject> <object xml:id="AlfredJewel"> <objectIdentifier> <country>United Kingdom</country> <region>Oxfordshire</region> <settlement>Oxford</settlement> <institution>University of Oxford</institution> <repository>Ashmolean Museum</repository> <collection>English Treasures</collection> <idno type="ashmolean">AN1836p.135.371</idno> <idno type="wikipedia">https://en.wikipedia.org/wiki/Alfred_Jewel</idno> <objectName>Alfred Jewel</objectName> </objectIdentifier> <physDesc> <p> The Alfred Jewel is about 6.4 cm in length and is made of combination of filigreed <material>gold</material> surrounding a polished teardrop shaped piece of transparent <material>quartz</material>. Underneath the rock crystal is a cloisonné enamel image of a man with ecclesiastical symbols. The sides of the jewel holding the crystal in place contain an openwork inscription saying "AELFRED MEC HEHT GEWYRCAN", meaning 'Alfred ordered me made'. </p> </physDesc> <history> <origin>It is generally accepted that the Alfred Jewel dates from the <origDate>late 9th Century</origDate> and was most likely made in <origPlace>England</origPlace>. </origin> <provenance when="1693">The jewel was discovered in 1693 at Petherton Park, North Petherton in the English county of Somerset, on land owned by Sir Thomas Wroth. North Petherton is about 8 miles away from Athelney, where King Alfred founded a monastery. </provenance> <provenance when="1698">A description of the Alfred Jewel was first published in 1698, in the Philosophical Transactions of the Royal Society.</provenance> <acquisition> It was bequeathed to Oxford University by Colonel Nathaniel Palmer (c. 1661-1718) and today is in the Ashmolean Museum in Oxford. </acquisition> </history> </object> </listObject>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.objectLike" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listObject { att.global.attributes, att.typed.attributes, att.declarable.attributes, att.sortable.attributes, ( model.headLike, desc, model.objectLike+, ( relation \| listRelation )* ) }

1.184. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declarable (@default) att.sortable (@sortKey)
Member of	model.listLike model.orgPart
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listOrg occupation org textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head namesdates: listOrg listRelation org relation
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> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="org"/> <elementRef key="listOrg"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listOrg { att.global.attributes, att.typed.attributes, att.declarable.attributes, att.sortable.attributes, ( model.headLike, desc, ( org \| listOrg )+, ( relation \| listRelation )* ) }

1.185. <listPerson>

<listPerson> (list of persons) contains a list of descriptions, each of which provides information about an identifiable person or a group of people, for example the participants in a language interaction, or the people referred to in a historical source. [13.3.2. The Person Element 15.2. Contextual Information 2.4. The Profile Description 15.3.2. Declarable Elements]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declarable (@default) att.sortable (@sortKey)
Member of	model.listLike model.orgPart
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listPerson occupation org textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head namesdates: listPerson listRelation org person personGrp relation
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> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.personLike"/> <elementRef key="listPerson"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listPerson { att.global.attributes, att.typed.attributes, att.declarable.attributes, att.sortable.attributes, ( model.headLike, desc, ( model.personLike \| listPerson )+, ( relation \| listRelation )* ) }

1.186. <listPlace>

<listPlace> (list of places) contains a list of places, optionally followed by a list of relationships (other than containment) defined amongst them. [2.2.7. The Source Description 13.3.4. Places]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declarable (@default) att.sortable (@sortKey)
Member of	model.listLike model.orgPart
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listPlace occupation org place textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head namesdates: listPlace listRelation place relation
Example	<listPlace type="offshoreIslands"> <place> <placeName>La roche qui pleure</placeName> </place> <place> <placeName>Ile aux cerfs</placeName> </place> </listPlace>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.placeLike"/> <elementRef key="listPlace"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </sequence> </content>
Schema Declaration	element listPlace { att.global.attributes, att.typed.attributes, att.declarable.attributes, att.sortable.attributes, ( model.headLike, desc, ( model.placeLike \| listPlace )+, ( relation \| listRelation )* ) }

1.187. <listPrefixDef>

<listPrefixDef> (list of prefix definitions) contains a list of definitions of prefixing schemes used in data.pointer values, showing how abbreviated URIs using each scheme may be expanded into full URIs. [16.2.3. Using Abbreviated Pointers]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.encodingDescPart
Contained by	header: encodingDesc listPrefixDef
May contain	core: desc header: listPrefixDef prefixDef
Example	In this example, two private URI scheme prefixes are defined and patterns are provided for dereferencing them. Each prefix is also supplied with a human-readable explanation in a <p> element. <listPrefixDef> <prefixDef ident="psn" matchPattern="([A-Z]+)" replacementPattern="personography.xml#$1"> <p> Private URIs using the <code>psn</code> prefix are pointers to <gi>person</gi> elements in the personography.xml file. For example, <code>psn:MDH</code> dereferences to <code>personography.xml#MDH</code>. </p> </prefixDef> <prefixDef ident="bibl" matchPattern="([a-z]+[a-z0-9]*)" replacementPattern="http://www.example.com/getBibl.xql?id=$1"> <p> Private URIs using the <code>bibl</code> prefix can be expanded to form URIs which retrieve the relevant bibliographical reference from www.example.com. </p> </prefixDef> </listPrefixDef>
Content model	<content> <sequence> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="prefixDef"/> <elementRef key="listPrefixDef"/> </alternate> </sequence> </content>
Schema Declaration	element listPrefixDef { att.global.attributes, ( desc*, ( prefixDef \| listPrefixDef )+ ) }

1.188. <listRef>

<listRef> (list of references) supplies a list of significant references to places where this element is discussed, in the current document or elsewhere.
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.oddDecl
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: classSpec dataSpec elementSpec macroSpec moduleSpec schemaSpec specGrp textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc ref
Example	<listRef> <ptr target="#ddc12"/> </listRef>
Content model	<content> <sequence> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.ptrLike" minOccurs="1" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element listRef { att.global.attributes, att.typed.attributes, ( desc*, model.ptrLike+ ) }

1.189. <listRelation>

<listRelation> provides information about relationships identified amongst people, places, and organizations, either informally as prose or as formally expressed relation links. [13.3.2.3. Personal Relationships]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.sortable (@sortKey)
Member of	model.biblPart model.listLike
Contained by	core: add bibl del desc head hi l listBibl note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation occupation textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head p linking: ab namesdates: listRelation 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> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="relation"/> <elementRef key="listRelation"/> </alternate> </alternate> </sequence> </content>
Schema Declaration	element listRelation { att.global.attributes, att.typed.attributes, att.sortable.attributes, ( model.headLike, desc, ( model.pLike \| ( relation \| listRelation )+ ) ) }

1.190. <listTranspose>

<listTranspose> supplies a list of transpositions, each of which is indicated at some point in a document typically by means of metamarks. [11.3.4.5. Transpositions]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.global.meta model.profileDescPart
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal profileDesc scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	core: desc transcr: transpose
Example	<listTranspose> <transpose> <ptr target="#ib02"/> <ptr target="#ib01"/> </transpose> </listTranspose> This example might be used for a source document which indicates in some way that the elements identified by `ib02` and code `ib01` should be read in that order (ib02 followed by ib01), rather than in the reading order in which they are presented in the source.
Content model	<content> <sequence> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="transpose" minOccurs="1" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element listTranspose { att.global.attributes, ( desc*, transpose+ ) }

1.191. <listWit>

<listWit> (witness list) lists definitions for all the witnesses referred to by a critical apparatus, optionally grouped hierarchically. [12.1. The Apparatus Entry, Readings, and Witnesses]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey)
Member of	model.listLike
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: abstract change handNote licence rendition scriptNote sourceDesc tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation textcrit: lem listWit rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc head textcrit: listWit witness
Note	May contain a series of <witness> or <listWit> elements. The provision of a <listWit> element simplifies the automatic processing of the apparatus, e.g. the reconstruction of the readings for all witnesses from an exhaustive apparatus. Situations commonly arise where there are many more or less fragmentary witnesses, such that there may be quite distinct groups of witnesses for different parts of a text or collection of texts. Such groups may be given separately, or nested within a single <listWit> element at the beginning of the file listing all the witnesses, partial and complete, for the text, with the attestation of fragmentary witnesses indicated within the apparatus by use of the <witStart> and <witEnd> elements described in section 12.1.5. Fragmentary Witnesses. Note however that a given witness can only be defined once, and can therefore only appear within a single <listWit> element.
Example	<listWit> <witness xml:id="HL26">Ellesmere, Huntingdon Library 26.C.9</witness> <witness xml:id="PN392">Hengwrt, National Library of Wales, Aberystwyth, Peniarth 392D</witness> <witness xml:id="RP149">Bodleian Library Rawlinson Poetic 149 (see further <ptr target="#MSRP149"/>)</witness> </listWit>
Content model	<content> <sequence> <classRef key="model.headLike" minOccurs="0"/> <elementRef key="desc" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="witness"/> <elementRef key="listWit"/> </alternate> </sequence> </content>
Schema Declaration	element listWit { att.global.attributes, att.sortable.attributes, ( model.headLike?, desc*, ( witness \| listWit )+ ) }

1.192. <localName>

<localName> (locally-defined property name) contains a locally defined name for some property. [5.2.1. Character Properties]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	gaiji: charProp
May contain	Character data only
Note	No definitive list of local names is proposed. However, the name entity is recommended as a means of naming the property identifying the recommended character entity name for this character or glyph.
Example	<localName>daikanwa</localName> <localName>entity</localName>
Content model	<content> <textNode/> </content>
Schema Declaration	element localName { att.global.attributes, text }

1.193. <location>

<location> defines the location of a place as a set of geographical coordinates, in terms of other named geo-political entities, or as an address. [13.3.4. Places]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant)
Member of	model.placeStateLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	certainty: precision core: address bibl desc email listBibl note header: biblFull msdescription: depth dim height msDesc width namesdates: affiliation bloc country district geo geogFeat geogName offset placeName region settlement
Example	<place> <placeName>Abbey Dore</placeName> <location> <geo>51.969604 -2.893146</geo> </location> </place>
Example	<place xml:id="BGbuilding" type="building"> <placeName>Brasserie Georges</placeName> <location> <country key="FR"/> <settlement type="city">Lyon</settlement> <district type="arrondissement">IIème</district> <district type="quartier">Perrache</district> <placeName type="street"> <num>30</num>, Cours de Verdun</placeName> </location> </place>
Example	<place type="imaginary"> <placeName>Atlantis</placeName> <location> <offset>beyond</offset> <placeName>The Pillars of <persName>Hercules</persName> </placeName> </location> </place>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="precision"/> <classRef key="model.labelLike"/> <classRef key="model.placeNamePart"/> <classRef key="model.offsetLike"/> <classRef key="model.measureLike"/> <classRef key="model.addressLike"/> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> </content>
Schema Declaration	element location { att.global.attributes, att.typed.attributes, att.datable.attributes, att.editLike.attributes, ( precision \| model.labelLike \| model.placeNamePart \| model.offsetLike \| model.measureLike \| model.addressLike \| model.noteLike \| model.biblLike )* }

1.194. <locus>

<locus> defines a location within a manuscript, manuscript part, or other object typically as a (possibly discontinuous) sequence of folio references. [10.3.5. References to Locations within a Manuscript]

Module msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.typed (@type, @subtype)

scheme

identifies the foliation scheme in terms of which the location is being specified by pointing to some <foliation> element defining it, or to some other equivalent resource.

Status	Optional
Datatype	teidata.pointer

from

specifies the starting point of the location in a normalized form, typically a page number.

Status	Optional
Datatype	teidata.word

to

specifies the end-point of the location in a normalized form, typically as a page number.

Status	Optional
Datatype	teidata.word

Member of

model.pPart.msdesc

Contained by

analysis: cl phr s span

core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

core: hi

gaiji: g

msdescription: locus

character data

Note

The target attribute should only be used to point to elements that contain or indicate a transcription of the locus being described, as in the first example above. To associate a <locus> element with a page image or other comparable representation, the global facs attribute should be used instead, as shown in the second example. Use of the target attribute to indicate an image is strongly deprecated. The facs attribute may be used to indicate one or more image files, as above, or alternatively it may point to one or more appropriate XML elements, such as the <surface>, <zone> element, <graphic>, or <binaryObject> elements.

Note

When a single page is being cited, use the from and to attributes with an identical value. When no clear endpoint is provided, the from attribute may be used without to; for example a citation such as ‘p. 3ff’ might be encoded <biblScope from="3">p. 3ff<biblScope>.

Example

<msItem n="1"> <locus target="#F1r #F1v #F2r" from="1r" to="2r">ff. 1r-2r</locus> <author>Ben Jonson</author> <title>Ode to himself</title> <rubric rend="italics"> An Ode<lb/> to him selfe.</rubric> <incipit>Com leaue the loathed stage</incipit> <explicit>And see his chariot triumph ore his wayne.</explicit> <bibl> <name>Beal</name>, <title>Index 1450-1625</title>, JnB 380</bibl> </msItem>  <pb xml:id="F1r"/>  <pb xml:id="F1v"/>  <pb xml:id="F2r"/>

Example

The facs attribute is available globally when the transcr module is included in a schema. It may be used to point directly to an image file, as in the following example:

<msItem> <locus facs="images/08v.jpg images/09r.jpg images/09v.jpg images/10r.jpg images/10v.jpg">fols. 8v-10v</locus> <title>Birds Praise of Love</title> <bibl> <title>IMEV</title> <biblScope>1506</biblScope> </bibl> </msItem>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <elementRef key="hi"/>
  <elementRef key="locus"/>
 </alternate>
</content>

Schema Declaration

element locus
{
   att.global.attributes,
   att.pointing.attributes,
   att.typed.attributes,
   attribute scheme { text }?,
   attribute from { text }?,
   attribute to { text }?,
   ( text | model.gLike | hi | locus )*
}

1.195. <locusGrp>

<locusGrp> groups a number of locations which together form a distinct but discontinuous item within a manuscript, manuscript part, or other object. [10.3.5. References to Locations within a Manuscript]

Module

msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

scheme

identifies the foliation scheme in terms of which all the locations contained by the group are specified by pointing to some <foliation> element defining it, or to some other equivalent resource.

Status	Optional
Datatype	teidata.pointer

Member of

model.pPart.msdesc

Contained by

analysis: cl phr s span

core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

msdescription: locus

Example

<msItem> <locusGrp> <locus from="13" to="26">Bl. 13--26</locus> <locus from="37" to="58">37--58</locus> <locus from="82" to="96">82--96</locus> </locusGrp> <note>Stücke von Daniel Ecklin’s Reise ins h. Land</note> </msItem>

Content model

<content>
 <elementRef key="locus" minOccurs="1"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element locusGrp { att.global.attributes, attribute scheme { text }?, locus+ }

1.196. <m>

<m> (morpheme) represents a grammatical morpheme. [17.1. Linguistic Segment Categories]

Module

analysis

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation)

baseForm

supplies the morpheme's base form.

Status	Optional
Datatype	teidata.word

Member of

model.segLike

Contained by

analysis: cl m phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c interp interpGrp m span spanGrp

certainty: certainty precision respons

core: gap hi lb milestone note pb

gaiji: g

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

textcrit: app witDetail

transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin

character data

Note

The type attribute may be used to indicate the type of morpheme, taking values such as clitic, prefix, stem, etc. as appropriate.

Example

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.hiLike"/>
  <elementRef key="seg"/>
  <elementRef key="m"/>
  <elementRef key="c"/>
  <classRef key="model.global"/>
 </alternate>
</content>

Schema Declaration

element m
{
   att.global.attributes,
   att.segLike.attributes,
   att.typed.attributes,
   att.notated.attributes,
   attribute baseForm { text }?,
   ( text | model.gLike | model.hiLike | seg | m | c | model.global )*
}

1.197. <macroRef>

<macroRef> points to the specification for some pattern which is to be included in a schema [22.7. Macro Specifications]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

key

the identifier used for the required pattern within the source indicated.

Status	Required
Datatype	teidata.xmlName

Member of

Contained by

tagdocs: alternate content schemaSpec sequence specGrp

May contain

Empty element

Note

Patterns or macros are identified by the name supplied as value for the ident attribute on the <macroSpec> element in which they are declared. All TEI macro names are unique.

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element macroRef { att.global.attributes, attribute key { text }, empty }

1.198. <macroSpec>

<macroSpec> (macro specification) documents the function and implementation of a pattern. [22.3. Specification Elements 22.7. Macro Specifications]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) )
Member of	model.oddDecl
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: schemaSpec specGrp textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc tagdocs: altIdent constraintSpec content equiv exemplum listRef remarks valList
Example	<macroSpec module="tei" ident="macro.phraseSeq"> <content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.gLike"/> <classRef key="model.phrase"/> <classRef key="model.global"/> </alternate> </content> </macroSpec>
Content model	<content> <sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.glossLike"/> <classRef key="model.descLike"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="content"/> <elementRef key="valList"/> </alternate> <elementRef key="constraintSpec" minOccurs="0" maxOccurs="unbounded"/> <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 macroSpec { att.global.attributes, att.identified.attributes, ( ( model.glossLike \| model.descLike ), ( content \| valList ), constraintSpec, exemplum, remarks, listRef ) }

1.199. <mapping>

<mapping> (character mapping) contains one or more characters which are related to the parent character or glyph in some respect, as specified by the type attribute. [5.2. Markup Constructs for Representation of Characters and Glyphs]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Contained by	gaiji: char glyph
May contain	gaiji: g character data
Note	Suggested values for the type attribute include exact for exact equivalences, uppercase for uppercase equivalences, lowercase for lowercase equivalences, and simplified for simplified characters. The <g> elements contained by this element can point to either another <char> or <glyph>element or contain a character that is intended to be the target of this mapping.
Example	<mapping type="modern">r</mapping> <mapping type="standard">人</mapping>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element mapping { att.global.attributes, att.typed.attributes, macro.xtext }

1.200. <material>

<material> contains a word or phrase describing the material of which the object being described is composed. [10.3.2. Material and Object Type]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.pPart.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The ref attribute may be used to point to one or more items within a taxonomy of types of material, defined either internally or externally.
Example	<physDesc> <p> <material>Parchment</material> leaves with a <material>sharkskin</material> binding.</p> </physDesc>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element material { att.global.attributes, att.canonical.attributes, macro.phraseSeq }

1.201. <memberOf>

<memberOf> specifies class membership of the documented element or class. [22.4.3. Classification of Components]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

key

specifies the identifier for a class of which the documented element or class is a member or subclass

Status	Optional
Datatype	teidata.name

mode

specifies the effect of this declaration on its parent module.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	add this declaration is added to the current definitions[Default] delete this declaration and all of its children are removed from the current setup

max

supplies the maximum number of times the element can occur in elements which use this model class in their content model

Status	Optional
Datatype	teidata.numeric

min

supplies the minumum number of times the element must occur in elements which use this model class in their content model

Status	Optional
Datatype	teidata.numeric

Contained by

tagdocs: classes

May contain

gaiji: g

character data

Note

Elements or classes which are members of multiple (unrelated) classes will have more than one <memberOf> element, grouped by a <classes> element. If an element is a member of a class C1, which is itself a subclass of a class C2, there is no need to state this, other than in the documentation for class C1.

Any additional comment or explanation of the class membership may be provided as content for this element.

Example

This element will appear in any content model which references model.divLike, and will have attributes defined in att.identified (in addition to any defined explicitly for this element).

Content model

<content>
 <macroRef key="macro.xtext"/>
</content>

Schema Declaration

element memberOf
{
   att.global.attributes,
   attribute key { text }?,
   attribute mode { "add" | "delete" }?,
   attribute max { text }?,
   attribute min { text }?,
   macro.xtext
}

1.202. <metDecl>

<metDecl> (metrical notation declaration) documents the notation employed to represent a metrical pattern when this is specified as the value of a met, real, or rhyme attribute on any structural element of a metrical text (e.g. <lg>, <l>, or <seg>). [6.6. Metrical Notation Declaration 6.4. Rhyme and Metrical Analysis]

Module

verse

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

type

indicates whether the notation conveys the abstract metrical form, its actual prosodic realization, or the rhyme scheme, or some combination thereof.

Status	Optional
Datatype	1–3 occurrences of teidata.enumerated separated by whitespace
Legal values are:	met (met attribute) declaration applies to the abstract metrical form recorded on the met attribute real (real attribute) declaration applies to the actual realization of the conventional metrical structure recorded on the real attribute rhyme declaration applies to the rhyme scheme recorded on the rhyme attribute
Note	By default, the <metDecl> element documents the notation used for metrical pattern and realization. It may also be used to document the notation used for rhyme scheme information; if not otherwise documented, the rhyme scheme notation defaults to the traditional ‘abab’ notation.

pattern

(regular expression pattern) specifies a regular expression defining any value that is legal for this notation.

Status	Optional
Datatype	teidata.pattern
Note	The value must be a valid regular expression per the World Wide Web Consortium's XML Schema Part 2: Datatypes Second Edition, Appendix F

Member of

Contained by

header: encodingDesc

May contain

core: note p

linking: ab

verse: metSym

Note

The encoder may choose whether to define the notation formally or informally. However, the two methods may not be mixed. That is, <metDecl> may contain either a sequence of <metSym> elements or, alternately, a series of paragraphs or other components. If the pattern attribute is specified and <metSym> elements are used, then all the codes appearing within the pattern attribute should be documented.

Only usable within the header if the verse module is used.

Example

<metDecl xml:id="ip" type="met" pattern="((SU|US)USUSUSUS/)"> <metSym value="S">stressed syllable</metSym> <metSym value="U">unstressed syllable</metSym> <metSym value="/">metrical line boundary</metSym> </metDecl>

This example is intended for the far more restricted case typified by the Shakespearean iambic pentameter. Only metrical patterns containing exactly ten syllables, alternately stressed and unstressed, (except for the first two which may be in either order) to each metrical line can be expressed using this notation.

Content model

<content>
 <alternate>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.pLike"/>
   <classRef key="model.noteLike"/>
  </alternate>
  <elementRef key="metSym" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>

Schema Declaration

element metDecl
{
   att.global.attributes,
   att.declarable.attributes,
   attribute type
   {
      list
      {
         ( "met" | "real" | "rhyme" ),
         ( "met" | "real" | "rhyme" )?,
         ( "met" | "real" | "rhyme" )?
      }
   }?,
   attribute pattern { text }?,
   ( ( model.pLike | model.noteLike )+ | metSym+ )
}

1.203. <metSym>

<metSym> (metrical notation symbol) documents the intended significance of a particular character or character sequence within a metrical notation, either explicitly or in terms of other <metSym> elements in the same <metDecl>. [6.6. Metrical Notation Declaration]

Module

verse

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

value

specifies the character or character sequence being documented.

Status	Required
Datatype	1–∞ occurrences of teidata.word separated by whitespace

terminal

specifies whether the symbol is defined in terms of other symbols (terminal is set to false) or in prose (terminal is set to true).

Status	Optional
Datatype	teidata.truthValue
Default	true
Note	The value true indicates that the element contains a prose definition of its meaning; the value false indicates that the element contains a definition of its meaning given using symbols defined elsewhere in the same <metDecl> element.

Contained by

verse: metDecl

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: address choice date email gap hi lb milestone name note pb ref time title

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident tag val

textcrit: app witDetail

transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin

character data

Example

<metSym value="x">a stressed syllable</metSym> <metSym value="o">an unstressed syllable</metSym> <metSym value="A" terminal="false">xoo</metSym>

Content model

<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>

Schema Declaration

element metSym
{
   att.global.attributes,
   attribute value { list { + } },
   attribute terminal { text }?,
   macro.phraseSeq.limited
}

1.204. <metamark>

<metamark> contains or describes any kind of graphic or written signal within a document the function of which is to determine how it should be read rather than forming part of the actual content of the document. [11.3.4.2. Metamarks]

Module

transcr

Attributes

Attributes att.spanning (@spanTo) att.placement (@place) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

function

describes the function (for example status, insertion, deletion, transposition) of the metamark.

Status	Optional
Datatype	teidata.word

target

identifies one or more elements to which the metamark applies.

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

Member of

model.global

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<surface> <metamark function="used" rend="line" target="#X2"/> <zone xml:id="zone-X2"> <line>I am that halfgrown <add>angry</add> boy, fallen asleep</line> <line>The tears of foolish passion yet undried</line> <line>upon my cheeks.</line>  <line>I pass through <add>the</add> travels and <del>fortunes</del> of <retrace>thirty</retrace> </line> <line>years and become old,</line> <line>Each in its due order comes and goes,</line> <line>And thus a message for me comes.</line> <line>The</line> </zone> <metamark function="used" target="#zone-X2">Entered - Yes</metamark> </surface>

Content model

<content>
 <macroRef key="macro.specialPara"/>
</content>

Schema Declaration

element metamark
{
   att.spanning.attributes,
   att.placement.attributes,
   att.global.attributes,
   attribute function { text }?,
   attribute target { list { + } }?,
   macro.specialPara
}

1.205. <milestone>

<milestone> marks a boundary point separating any kind of section of a text, typically but not necessarily indicating a point at which some part of a standard reference system changes, where the change is not represented by a structural element. [3.10.3. Milestone Elements]

Module

core

Attributes

Attributes att.milestoneUnit (@unit) 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.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.analytic (@ana) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (resp, @cert) att.global.source (@source) att.typed (type, @subtype)

resp

Status	Required
Legal values are:	#mjk

type

Status	Required
Legal values are:	address matTheory mentDesc motherhood physDesc socHist

part

Status	Optional
Legal values are:	initial medial final

Member of

model.milestoneLike

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg listBibl name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc subst supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

Empty element

Note

For this element, the global n attribute indicates the new number or other value for the unit which changes at this milestone. The special value unnumbered should be used in passages which fall outside the normal numbering scheme, such as chapter or other headings, poem numbers or titles, etc.

The order in which <milestone> elements are given at a given point is not normally significant.

Example

<milestone n="23" ed="La" unit="Dreissiger"/> ... <milestone n="24" ed="AV" unit="verse"/> ...

Content model

<content>
 <empty/>
</content>

Schema Declaration

element milestone
{
   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.linking.attribute.corresp,
   att.global.linking.attribute.synch,
   att.global.linking.attribute.sameAs,
   att.global.linking.attribute.copyOf,
   att.global.linking.attribute.next,
   att.global.linking.attribute.prev,
   att.global.linking.attribute.exclude,
   att.global.linking.attribute.select,
   att.global.analytic.attribute.ana,
   att.global.facs.attribute.facs,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.source.attribute.source,
   att.milestoneUnit.attributes,
   att.typed.attribute.subtype,
   att.edition.attributes,
   att.spanning.attributes,
   att.breaking.attributes,
   attribute resp { "#mjk" },
   attribute type
   {
      "address"
    | "matTheory"
    | "mentDesc"
    | "motherhood"
    | "physDesc"
    | "socHist"
   },
   attribute part { "initial" | "medial" | "final" }?,
   empty
}

1.206. <mod>

<mod> represents any kind of modification identified within a single document. [11.3.4.1. Generic Modification]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.typed (@type, @subtype) att.spanning (@spanTo) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.linePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<mod type="subst"> <add>pleasing</add> <del>agreable</del> </mod>
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element mod { att.global.attributes, att.transcriptional.attributes, att.typed.attributes, att.spanning.attributes, att.dimensions.attributes, macro.paraContent }

1.207. <model>

<model> describes the processing intended for a specified element. [22.5.4.1. The TEI processing model]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

behaviour

names the process or function which this processing model uses in order to produce output.

Status	Required
Datatype	teidata.enumerated
Suggested values include:	alternate (default, alternate) support display of alternative visualisations, for example by displaying the preferred content, by displaying both in parallel, or by toggling between the two. anchor (id) create an identifiable anchor point in the output. block (content) create a block structure body (content) create the body of a document. break (type, label) create a line, column, or page break according to the value of type cell (content) create a table cell cit (content, source) show the content, with an indication of the source document (content) start a new output document figure (title) make a figure with the title as caption glyph (uri) show a character by looking up reference to a chardesc at the given URI graphic (url, width, height, scale, title) if url is present, uses it to display graphic, else display a placeholder image. heading (content, level) creates a heading. index (type) generate list according to type. inline (content, label) creates inline element out of content link (content, uri) create hyperlink list (content) create a list. listItem (content) create a list item. metadata (content) create metadata section note (content, place, label) create a note, often out of line, depending on the value of place; could be margin, footnote, endnote, inline omit do nothing, do not process children paragraph (content) create a paragraph out of content. row (content) create a table row section (content) create a new section of the output document table (content) create a table text (content) create literal text title (content) create document title

predicate

the condition under which this model applies, given as an XPath predicate expression.

Status	Optional
Datatype	teidata.xpath

useSourceRendition

whether to obey any rendition attribute which is present.

Status	Optional
Datatype	teidata.truthValue
Note	If the useSourceRendition attribute is not specified, or has the value false, any renditional information specified in the source document should be ignored.

output

the intended output.

Status	Optional
Datatype	teidata.enumerated
Sample values include:	web the output is intended for presentation in a web format print the output is intended for presentation in a print format plain the output is intended for presentation in a plain text format
Note	If the output attribute is not specified, this model is assumed to apply for all forms of output.

cssClass

the name of a CSS class which should be associated with this element

Status	Optional
Datatype	1–∞ occurrences of teidata.name separated by whitespace

Contained by

tagdocs: elementSpec modelGrp modelSequence

May contain

core: desc

tagdocs: altIdent equiv outputRendition param

Note

The intended output to be generated for a particular behaviour of a processing model may be documented in one or all of the three following ways. Firstly, the cssClass attribute may be used to specify the name of a CSS style in some associated CSS stylesheet which is to be applied to each occurrence of a specified element found (in a given context, for a specified output). Secondly, the attribute useSourceRendition may be used to indicate that the default rendition for occurrences of this element, as defined by a <rendition> element in the document header, should be applied. Thirdly, the styling to be applied may be specified explicitly as content of a child <outputRendition> element. When more than one of these options is used, they are understood to be combined in accordance with the rules for multiple declaration of the styling language used.

Example

Example

<elementSpec mode="change" ident="quote"> <model predicate="ancestor::p" behaviour="inline"> <desc versionDate="2015-08-21" xml:lang="en">If it's inside a paragraph then it's inline</desc> </model> <model predicate="not(ancestor::p)" behaviour="block"> <desc versionDate="2015-08-21" xml:lang="en">If it's not inside a paragraph then it is block level</desc> </model> </elementSpec>

Example

<model predicate="parent::person" behaviour="inline"> <desc versionDate="2015-08-21" xml:lang="en">If it is a child of a person element, treat as inline</desc> </model>

Example

<model behaviour="inline"> <outputRendition>font-weight:bold</outputRendition> </model>

Example

Example

Example

Example

Schematron

It is ambigous to have 2 <model>s that have both the same output and have no predicate (and thus select the same set of nodes).

<sch:rule context="tei:model[ not( parent::tei:modelSequence ) ][ not( @predicate ) ]"> <sch:let name="output" value="normalize-space( @output )"/> <sch:report test="following-sibling::tei:model [ not( @predicate )] [ normalize-space( @output ) eq $output ]"> There are 2 (or more) 'model' elements in this '<sch:value-of select="local-name(..)"/>' that have no predicate, but are targeted to the same output ("<sch:value-of select="( $output, parent::modelGrp/@output, 'all')[1]"/>")</sch:report> </sch:rule>

Schematron

It is ambigous to have 2 <model>s that have both the same output and the same predicate (and thus select the same set of nodes).

<sch:rule context="tei:model[ not( parent::tei:modelSequence ) ][ @predicate ]"> <sch:let name="predicate" value="normalize-space( @predicate )"/> <sch:let name="output" value="normalize-space( @output )"/> <sch:report test="following-sibling::tei:model [ normalize-space( @predicate ) eq $predicate ] [ normalize-space( @output ) eq $output ]"> There are 2 (or more) 'model' elements in this '<sch:value-of select="local-name(..)"/>' that have the same predicate, and are targeted to the same output ("<sch:value-of select="( $output, parent::modelGrp/@output, 'all')[1]"/>")</sch:report> </sch:rule>

Content model

<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="param" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="outputRendition"
   minOccurs="0" maxOccurs="unbounded"/>
 </sequence>
</content>

Schema Declaration

element model
{
   att.global.attributes,
   attribute behaviour
   {
      "alternate"
    | "anchor"
    | "block"
    | "body"
    | "break"
    | "cell"
    | "cit"
    | "document"
    | "figure"
    | "glyph"
    | "graphic"
    | "heading"
    | "index"
    | "inline"
    | "link"
    | "list"
    | "listItem"
    | "metadata"
    | "note"
    | "omit"
    | "paragraph"
    | "row"
    | "section"
    | "table"
    | "text"
    | "title"
   },
   attribute predicate { text }?,
   attribute useSourceRendition { text }?,
   attribute output { text }?,
   attribute cssClass { list { + } }?,
   ( ( model.glossLike | model.descLike )*, param*, outputRendition* )
}

1.208. <modelGrp>

<modelGrp> any grouping of <model> or <modelSequence> elements with a common output method [22.5.4.4. Model Contexts and Outputs]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

useSourceRendition

whether to obey any rendition attribute which is present

Status	Optional
Datatype	teidata.truthValue

output

the intended output method

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	web the output is intended for presentation in a web format print the output is intended for presentation in a print format plaintext the output is intended for presentation in a plain text format

Contained by

tagdocs: elementSpec

May contain

core: desc

tagdocs: altIdent equiv model modelSequence outputRendition

Note

The child <model> elements of a <modelGrp> are always processed independently.

Example

<elementSpec mode="change" ident="abbr"> <modelGrp output="web"> <model predicate="parent::choice" behaviour="omit"/> <model predicate="ancestor::front" behaviour="inline"> <outputRendition>font-style:italic; </outputRendition> </model> <model predicate="not(parent::choice)" behaviour="inline"> <outputRendition scope="before">content: ' ('</outputRendition> <outputRendition scope="after">content: ')'</outputRendition> </model> </modelGrp> <modelGrp output="print"> <model predicate="parent::choice" behaviour="omit"/> <model predicate="not(parent::choice)" behaviour="note"> <param name="place" value="'foot'"/> </model> </modelGrp> </elementSpec>

Example

Content model

<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="outputRendition"
   minOccurs="0"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <elementRef key="modelSequence"/>
   <elementRef key="model"/>
  </alternate>
 </sequence>
</content>

Schema Declaration

element modelGrp
{
   att.global.attributes,
   attribute useSourceRendition { text }?,
   attribute output { "web" | "print" | "plaintext" }?,
   (
      ( model.glossLike | model.descLike )*,
      outputRendition?,
      ( modelSequence | model )+
   )
}

1.209. <modelSequence>

<modelSequence> any sequence of model or <modelSequence> elements which is to be processed as a single set of actions [22.5.4.7. Model sequence]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

predicate

the condition under which this model applies given as an XPath Predicate Expression

Status	Optional
Datatype	teidata.xpath

useSourceRendition

whether to obey any rendition attribute which is present

Status	Optional
Datatype	teidata.truthValue

output

the intended output method

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	web the output is intended for presentation in a web format print the output is intended for presentation in a print format plaintext the output is intended for presentation in a plain text format

Contained by

tagdocs: elementSpec modelGrp

May contain

core: desc

tagdocs: altIdent equiv model

Note

All of the <model> elements inside a <modelSequence> element must be processed. The operations indicated by each <model> child cannot be dependent on any other operation in the sequence. The results must be rendered in the order given by the list of <model>s in the <modelSequence>.

Example

Schematron

<sch:report test="tei:model[@output]" role="warning">The 'model' children of a 'modelSequence' element inherit the @output attribute of the parent 'modelSequence', and thus should not have their own</sch:report>

Content model

<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.glossLike"/>
   <classRef key="model.descLike"/>
  </alternate>
  <elementRef key="model" minOccurs="2"
   maxOccurs="unbounded"/>
 </sequence>
</content>

Schema Declaration

element modelSequence
{
   att.global.attributes,
   attribute predicate { text }?,
   attribute useSourceRendition { text }?,
   attribute output { "web" | "print" | "plaintext" }?,
   ( ( model.glossLike | model.descLike )*, ( model, model, model* ) )
}

1.210. <moduleRef>

<moduleRef> (module reference) references a module which is to be incorporated into a schema. [22.2. Modules and Schemas]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

prefix

specifies a default prefix which will be prepended to all patterns from the imported module

Status	Optional
Datatype	0–1 occurrences of teidata.xmlName separated by whitespace
Schematron	<s:rule context="tei:moduleRef"> <s:report test="//*[ not( generate-id(.) eq generate-id( current() ) ) ]/@prefix = @prefix">The prefix attribute of <s:name/> should not match that of any other element (it would defeat the purpose)</s:report> </s:rule>
Note	Use of this attribute avoids name collisions (and thus invalid schemas) when the external schema being mixed in with TEI uses a name the TEI or some other included external schema already uses for a pattern.

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

supplies a list of the elements which are not to be copied from the specified module into the schema being defined.

Status	Optional
Datatype	0–∞ occurrences of teidata.xmlName separated by whitespace

key

the name of a TEI module

Status	Optional
Datatype	teidata.xmlName

url

(uniform resource locator) refers to a non-TEI module of RELAX NG code by external location

Status	Optional
Datatype	teidata.pointer

Member of

model.oddRef

Contained by

tagdocs: schemaSpec specGrp

May contain

tagdocs: content

Note

If neither include nor exclude 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 uri 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 uri attribute into the target RELAX NG schema.

Example

This includes all objects available from the linking module.

Example

This includes all elements available from the linking module except for the <link> and <linkGrp> elements.

Example

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.attributes,
   attribute prefix { text }?
   >>
   tei:constraintSpec
   [
      scheme = "schematron"
      ident = "not-same-prefix"
      " "
      "The prefix attribute of "
      " should not match that of any other element (it would defeat the purpose)"
   ],
   ( attribute include { list { * } }? | attribute except { list { * } }? ),
   ( attribute key { text }? | attribute url { text }? ),
   content?
}

1.211. <moduleSpec>

<moduleSpec> (module specification) documents the structure, content, and purpose of a single module, i.e. a named and externally visible group of declarations. [22.2. Modules and Schemas]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) ) att.typed (@type, @subtype)
Member of	model.oddDecl
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: schemaSpec specGrp textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: desc tagdocs: altIdent equiv exemplum listRef remarks
Example	<moduleSpec ident="namesdates"> <altIdent type="FPI">Names and Dates</altIdent> <desc>Additional elements for names and dates</desc> </moduleSpec>
Content model	<content> <sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.glossLike"/> <classRef key="model.descLike"/> </alternate> <elementRef key="exemplum" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="remarks" minOccurs="0"/> <elementRef key="listRef" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element moduleSpec { att.global.attributes, att.identified.attributes, att.typed.attributes, ( ( model.glossLike \| model.descLike ), exemplum, remarks?, listRef* ) }

1.212. <msContents>

<msContents> (manuscript contents) describes the intellectual content of a manuscript, manuscript part, or other object either as a series of paragraphs or as a series of structured manuscript items. [10.6. Intellectual Content]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.msExcerpt (@defective) att.msClass (@class)
Contained by	msdescription: msDesc msFrag msPart namesdates: object
May contain	core: p textLang linking: ab msdescription: msItem msItemStruct summary
Note	Unless it contains a simple prose description, this element should contain at least one of the elements <summary>, <msItem>, or <msItemStruct>. This constraint is not currently enforced by the schema.
Example	<msContents class="#sermons"> <p>A collection of Lollard sermons</p> </msContents>
Example	<msContents> <msItem n="1"> <locus>fols. 5r-7v</locus> <title>An ABC</title> <bibl> <title>IMEV</title> <biblScope>239</biblScope> </bibl> </msItem> <msItem n="2"> <locus>fols. 7v-8v</locus> <title xml:lang="frm">Lenvoy de Chaucer a Scogan</title> <bibl> <title>IMEV</title> <biblScope>3747</biblScope> </bibl> </msItem> <msItem n="3"> <locus>fol. 8v</locus> <title>Truth</title> <bibl> <title>IMEV</title> <biblScope>809</biblScope> </bibl> </msItem> <msItem n="4"> <locus>fols. 8v-10v</locus> <title>Birds Praise of Love</title> <bibl> <title>IMEV</title> <biblScope>1506</biblScope> </bibl> </msItem> <msItem n="5"> <locus>fols. 10v-11v</locus> <title xml:lang="la">De amico ad amicam</title> <title xml:lang="la">Responcio</title> <bibl> <title>IMEV</title> <biblScope>16 & 19</biblScope> </bibl> </msItem> <msItem n="6"> <locus>fols. 14r-126v</locus> <title>Troilus and Criseyde</title> <note>Bk. 1:71-Bk. 5:1701, with additional losses due to mutilation throughout</note> </msItem> </msContents>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <elementRef key="textLang" minOccurs="0"/> <elementRef key="titlePage" minOccurs="0"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="msItem"/> <elementRef key="msItemStruct"/> </alternate> </sequence> </alternate> </content>
Schema Declaration	element msContents { att.global.attributes, att.msExcerpt.attributes, att.msClass.attributes, ( model.pLike+ \| ( summary?, textLang?, titlePage?, ( msItem \| msItemStruct )* ) ) }

1.213. <msDesc>

<msDesc> (manuscript description) contains a description of a single identifiable manuscript or other text-bearing object. [10.1. Overview]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.typed (@type, @subtype) att.declaring (@decls) att.docStatus (@status)
Member of	model.biblLike
Contained by	core: add del desc head hi l listBibl note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote sourceDesc tagUsage taxonomy linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout msItem musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: climate event location object occupation org person personGrp persona place population state terrain trait textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: head p linking: ab msdescription: additional history msContents msFrag msIdentifier msPart physDesc
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> <elementRef key="msIdentifier"/> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="msContents" minOccurs="0"/> <elementRef key="physDesc" minOccurs="0"/> <elementRef key="history" minOccurs="0"/> <elementRef key="additional" minOccurs="0"/> <alternate> <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.attributes, att.sortable.attributes, att.typed.attributes, att.declaring.attributes, att.docStatus.attributes, ( msIdentifier, model.headLike, ( model.pLike+ \| ( msContents?, physDesc?, history?, additional?, ( msPart \| msFrag* ) ) ) ) }

1.214. <msFrag>

<msFrag> (manuscript fragment) contains information about a fragment described in relation to a prior context, typically as a description of a virtual reconstruction of a manuscript or other object whose fragments were catalogued separately [10.11. Manuscript Fragments]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Contained by	msdescription: msDesc
May contain	core: head p linking: ab msdescription: additional altIdentifier history msContents msIdentifier physDesc
Example	<msDesc> <msIdentifier> <msName xml:lang="la">Codex Suprasliensis</msName> </msIdentifier> <msFrag> <msIdentifier> <settlement>Ljubljana</settlement> <repository>Narodna in univerzitetna knjiznica</repository> <idno>MS Kopitar 2</idno> </msIdentifier> <msContents> <summary>Contains ff. 10 to 42 only</summary> </msContents> </msFrag> <msFrag> <msIdentifier> <settlement>Warszawa</settlement> <repository>Biblioteka Narodowa</repository> <idno>BO 3.201</idno> </msIdentifier> </msFrag> <msFrag> <msIdentifier> <settlement>Sankt-Peterburg</settlement> <repository>Rossiiskaia natsional'naia biblioteka</repository> <idno>Q.p.I.72</idno> </msIdentifier> </msFrag> </msDesc>
Content model	<content> <sequence> <alternate> <elementRef key="altIdentifier"/> <elementRef key="msIdentifier"/> </alternate> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="msContents" minOccurs="0"/> <elementRef key="physDesc" minOccurs="0"/> <elementRef key="history" minOccurs="0"/> <elementRef key="additional" minOccurs="0"/> </sequence> </alternate> </sequence> </content>
Schema Declaration	element msFrag { att.global.attributes, att.typed.attributes, ( ( altIdentifier \| msIdentifier ), model.headLike*, ( model.pLike+ \| ( msContents?, physDesc?, history?, additional? ) ) ) }

1.215. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.biblPart
Contained by	core: bibl msdescription: msDesc msFrag msPart
May contain	header: idno msdescription: altIdentifier collection institution msName repository namesdates: bloc country district geogName objectName placeName region 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> <sequence> <classRef key="model.placeNamePart" expand="sequenceOptional"/> <elementRef key="institution" minOccurs="0"/> <elementRef key="repository" minOccurs="0"/> <elementRef key="collection" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="idno" minOccurs="0" maxOccurs="unbounded"/> </sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="msName"/> <elementRef key="objectName"/> <elementRef key="altIdentifier"/> </alternate> </sequence> </content>
Schema Declaration	element msIdentifier { att.global.attributes, ( ( placeName?, bloc?, country?, region?, settlement?, district?, geogName?, institution?, repository?, collection, idno ), ( msName \| objectName \| altIdentifier )* ) }

1.216. <msItem>

<msItem> (manuscript item) describes an individual work or item within the intellectual content of a manuscript, manuscript part, or other object. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.msExcerpt (@defective) att.msClass (@class)
Member of	model.msItemPart
Contained by	msdescription: msContents msItem
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: author bibl editor gap lb listBibl milestone note p pb quote respStmt textLang title header: biblFull funder idno principal sponsor linking: ab alt altGrp anchor join joinGrp link linkGrp timeline msdescription: colophon decoNote explicit filiation finalRubric incipit locus locusGrp msDesc msItem msItemStruct rubric textcrit: app witDetail transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin
Example	<msItem class="#saga"> <locus>ff. 1r-24v</locus> <title>Agrip af Noregs konunga sögum</title> <incipit>regi oc h<ex>ann</ex> setiho <gap reason="illegible" extent="7"/>sc heim se<ex>m</ex> þio</incipit> <explicit>h<ex>on</ex> hev<ex>er</ex> <ex>oc</ex>þa buit hesta .ij. aNan viþ fé enh<ex>on</ex>o<ex>m</ex> aNan til reiþ<ex>ar</ex> </explicit> <textLang mainLang="non">Old Norse/Icelandic</textLang> </msItem>
Content model	<content> <sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="locus"/> <elementRef key="locusGrp"/> </alternate> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.titlepagePart"/> <classRef key="model.msItemPart"/> <classRef key="model.global"/> </alternate> </alternate> </sequence> </content>
Schema Declaration	element msItem { att.global.attributes, att.msExcerpt.attributes, att.msClass.attributes, ( ( locus \| locusGrp )*, ( model.pLike+ \| ( model.titlepagePart \| model.msItemPart \| model.global )+ ) ) }

1.217. <msItemStruct>

<msItemStruct> (structured manuscript item) contains a structured description for an individual work or item within the intellectual content of a manuscript, manuscript part, or other object. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.msExcerpt (@defective) att.msClass (@class)
Member of	model.msItemPart
Contained by	msdescription: msContents msItem msItemStruct
May contain	core: author bibl listBibl note p respStmt textLang title linking: ab msdescription: colophon decoNote explicit filiation finalRubric incipit locus locusGrp msItemStruct rubric
Example	<msItemStruct n="2" defective="false" class="#biblComm"> <locus from="24v" to="97v">24v-97v</locus> <author>Apringius de Beja</author> <title type="uniform" xml:lang="la">Tractatus in Apocalypsin</title> <rubric>Incipit Trac<supplied reason="omitted">ta</supplied>tus in apoka<lb/>lipsin eruditissimi uiri <lb/> Apringi ep<ex>iscop</ex>i Pacensis eccl<ex>esi</ex>e</rubric> <finalRubric>EXPLIC<ex>IT</ex> EXPO<lb/>SITIO APOCALIPSIS QVA<ex>M</ex> EXPOSVIT DOM<lb/>NVS APRINGIUS EP<ex>ISCOPU</ex>S. DEO GR<ex>ACI</ex>AS AGO. FI<lb/>NITO LABORE ISTO.</finalRubric> <bibl> <ref target="http://amiBibl.xml#Apringius1900">Apringius</ref>, ed. Férotin</bibl> <textLang mainLang="la">Latin</textLang> </msItemStruct>
Content model	<content> <sequence> <alternate minOccurs="0"> <elementRef key="locus"/> <elementRef key="locusGrp"/> </alternate> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="author" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="respStmt" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="title" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="rubric" minOccurs="0"/> <elementRef key="incipit" minOccurs="0"/> <elementRef key="msItemStruct" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="explicit" minOccurs="0"/> <elementRef key="finalRubric" minOccurs="0"/> <elementRef key="colophon" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="decoNote" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="listBibl" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="bibl"/> <elementRef key="biblStruct"/> </alternate> <elementRef key="filiation" minOccurs="0"/> <classRef key="model.noteLike" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="textLang" minOccurs="0"/> </sequence> </alternate> </sequence> </content>
Schema Declaration	element msItemStruct { att.global.attributes, att.msExcerpt.attributes, att.msClass.attributes, ( ( locus \| locusGrp )?, ( model.pLike+ \| ( author, respStmt, title, rubric?, incipit?, msItemStruct, explicit?, finalRubric?, colophon, decoNote, listBibl, ( bibl \| biblStruct ), filiation?, model.noteLike*, textLang? ) ) ) }

1.218. <msName>

<msName> (alternative name) contains any form of unstructured alternative name used for a manuscript or other object, such as an ‘ocellus nominum’, or nickname. [10.4. The Manuscript Identifier]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Contained by	msdescription: msIdentifier namesdates: objectIdentifier
May contain	core: name gaiji: g character data
Example	<msName>The Vercelli Book</msName>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.gLike"/> <elementRef key="rs"/> <elementRef key="name"/> </alternate> </content>
Schema Declaration	element msName { att.global.attributes, att.typed.attributes, ( text \| model.gLike \| rs \| name )* }

1.219. <msPart>

<msPart> (manuscript part) contains information about an originally distinct manuscript or part of a manuscript, which is now part of a composite manuscript. [10.10. Manuscript Parts]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Contained by	msdescription: msDesc msPart
May contain	core: head p linking: ab msdescription: additional history msContents msIdentifier msPart physDesc
Note	As this last example shows, for compatibility reasons the identifier of a manuscript part may be supplied as a simple <altIdentifier> rather than using the more structured <msIdentifier> element. This usage is however deprecated.
Example	<msPart> <msIdentifier> <idno>A</idno> <altIdentifier type="catalog"> <collection>Becker</collection> <idno>48, Nr. 145</idno> </altIdentifier> <altIdentifier type="catalog"> <collection>Wiener Liste</collection> <idno>4°5</idno> </altIdentifier> </msIdentifier> <head> <title xml:lang="la">Gregorius: Homiliae in Ezechielem</title> <origPlace key="tgn_7008085">Weissenburg (?)</origPlace> <origDate notBefore="0801" notAfter="0815">IX. Jh., Anfang</origDate> </head> </msPart>
Example	<msDesc> <msIdentifier> <settlement>Amiens</settlement> <repository>Bibliothèque Municipale</repository> <idno>MS 3</idno> <msName>Maurdramnus Bible</msName> </msIdentifier> <msContents> <summary xml:lang="lat">Miscellany of various texts; Prudentius, Psychomachia; Physiologus de natura animantium</summary> <textLang mainLang="lat">Latin</textLang> </msContents> <physDesc> <objectDesc form="composite_manuscript"/> </physDesc> <msPart> <msIdentifier> <idno>ms. 10066-77 ff. 140r-156v</idno> </msIdentifier> <msContents> <summary xml:lang="lat">Physiologus</summary> <textLang mainLang="lat">Latin</textLang> </msContents> </msPart> <msPart> <msIdentifier> <altIdentifier> <idno>MS 6</idno> </altIdentifier> </msIdentifier> <!-- other information specific to this part here --> </msPart> <!-- more parts here --> </msDesc>
Content model	<content> <sequence> <elementRef key="msIdentifier"/> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="msContents" minOccurs="0"/> <elementRef key="physDesc" minOccurs="0"/> <elementRef key="history" minOccurs="0"/> <elementRef key="additional" minOccurs="0"/> <elementRef key="msPart" minOccurs="0" maxOccurs="unbounded"/> </sequence> </alternate> </sequence> </content>
Schema Declaration	element msPart { att.global.attributes, att.typed.attributes, ( msIdentifier, model.headLike, ( model.pLike+ \| ( msContents?, physDesc?, history?, additional?, msPart ) ) ) }

1.220. <musicNotation>

<musicNotation> contains description of type of musical notation. [10.7.2. Writing, Decoration, and Other Notations]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.physDescPart
Contained by	msdescription: physDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<musicNotation> <p>Square notation of 4-line red staves.</p> </musicNotation>
Example	<musicNotation>Neumes in <term>campo aperto</term> of the St. Gall type. </musicNotation>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element musicNotation { att.global.attributes, macro.specialPara }

1.221. <name>

<name> (name, proper noun) contains a proper noun or noun phrase. [3.5.1. Referring Strings]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.typed (@type, @subtype)
Member of	model.nameLike.agent model.personPart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp respStmt sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msName musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.personal.attributes, att.datable.attributes, att.editLike.attributes, att.typed.attributes, macro.phraseSeq }

1.222. <nameLink>

<nameLink> (name link) contains a connecting phrase or link used within a name but not regarded as part of it, such as van der or of. [13.2.1. Personal Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
Member of	model.persNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<persName> <forename>Frederick</forename> <nameLink>van der</nameLink> <surname>Tronck</surname> </persName>
Example	<persName> <forename>Alfred</forename> <nameLink>de</nameLink> <surname>Musset</surname> </persName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element nameLink { att.global.attributes, att.typed.attributes, macro.phraseSeq }

1.223. <namespace>

<namespace> supplies the formal name of the namespace to which the elements documented by its children belong. [2.3.4. The Tagging Declaration]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

name

specifies the full formal name of the namespace concerned.

Status	Required
Datatype	teidata.namespace

Contained by

header: tagsDecl

May contain

header: tagUsage

Example

<namespace name="http://www.tei-c.org/ns/1.0"> <tagUsage gi="hi" occurs="28" withId="2"> Used only to mark English words italicized in the copy text </tagUsage> </namespace>

Content model

<content>
 <elementRef key="tagUsage" minOccurs="1"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element namespace { att.global.attributes, attribute name { text }, tagUsage+ }

1.224. <nationality>

<nationality> contains an informal description of a person's present or past nationality or citizenship. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	birth naturalised self-assigned

Member of

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<nationality key="US" notBefore="1966"> Obtained US Citizenship in 1966</nationality>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element nationality
{
   att.global.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.phraseSeq
}

1.225. <normalization>

<normalization> indicates the extent of normalization or regularization of the original source carried out in converting it to electronic form. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

method

indicates the method adopted to indicate normalizations within the text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	silent normalization made silently[Default] markup normalization represented using markup

Member of

model.correspActionPart model.correspContextPart model.correspDescPart model.noteLike

Contained by

header: editorialDecl

May contain

core: p

linking: ab

Example

<editorialDecl> <normalization method="markup"> Where both upper- and lower-case i, j, u, v, and vv have been normalized, to modern 20th century typographical practice, the <gi>choice</gi> element has been used to enclose <gi>orig</gi> and <gi>reg</gi> elements giving the original and new values respectively. ... </normalization> <normalization method="silent"> Spacing between words and following punctuation has been regularized to zero spaces; spacing between words has been regularized to one space. </normalization> <normalization source="http://www.dict.sztaki.hu/webster"> Spelling converted throughout to Modern American usage, based on Websters 9th Collegiate dictionary. </normalization> </editorialDecl>

Content model

<content>
 <classRef key="model.pLike" minOccurs="1"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element normalization
{
   att.global.attributes,
   att.declarable.attributes,
   attribute method { "silent" | "markup" }?,
   model.pLike+
}

1.226. <note>

<note> contains a note or annotation. [3.8.1. Notes and Simple Annotation 2.2.6. The Notes Statement 3.11.2.8. Notes and Statement of Language 9.3.5.4. Notes within Entries]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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 (@targetLang, @target, @evaluate) att.typed (@type, @subtype) att.written (@hand)

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

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().

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp respStmt sic textLang time title unclear

gaiji: char glyph

header: authority change classCode correspAction correspContext correspDesc distributor edition extent funder geoDecl handNote language licence notesStmt principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: app lem rdg rdgGrp wit witDetail witness

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metDecl metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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.  <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,
   attribute anchored { text }?,
   attribute targetEnd { list { + } }?,
   macro.specialPara
}

1.227. <notesStmt>

<notesStmt> (notes statement) collects together any notes providing information about a text additional to that recorded in other parts of the bibliographic description. [2.2.6. The Notes Statement 2.2. The File Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: biblFull fileDesc
May contain	core: note
Note	Information of different kinds should not be grouped together into the same note.
Example	<notesStmt> <note>Historical commentary provided by Mark Cohen</note> <note>OCR scanning done at University of Toronto</note> </notesStmt>
Content model	<content> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <elementRef key="relatedItem"/> </alternate> </content>
Schema Declaration	element notesStmt { att.global.attributes, ( model.noteLike \| relatedItem )+ }

1.228. <nym>

<nym> (canonical name) contains the definition for a canonical name or name component of any kind. [13.3.6. Names and Nyms]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.sortable (@sortKey)

parts

points to constituent nyms

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

Contained by

namesdates: listNym nym

May contain

core: p

header: idno

linking: ab

namesdates: nym

Example

Content model

<content>
 <sequence>
  <elementRef key="idno" minOccurs="0"
   maxOccurs="unbounded"/>
  <classRef key="model.entryPart"
   minOccurs="0" maxOccurs="unbounded"/>
  <classRef key="model.pLike" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="nym" minOccurs="0"
   maxOccurs="unbounded"/>
 </sequence>
</content>

Schema Declaration

element nym
{
   att.global.attributes,
   att.typed.attributes,
   att.sortable.attributes,
   attribute parts { list { + } }?,
   ( idno*, model.entryPart*, model.pLike*, nym* )
}

1.229. <object>

<object> contains a description of a single identifiable physical object. [13.3.5. Objects]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.typed (@type, @subtype) att.declaring (@decls) att.docStatus (@status) att.canonical (@key, @ref)
Member of	model.objectLike
Contained by	namesdates: listObject object
May contain	core: bibl head listBibl note p header: biblFull linking: ab link linkGrp msdescription: additional history msContents msDesc physDesc namesdates: object objectIdentifier
Note	The <object> element is a recent addition to the TEI P5 Guidelines as of version 3.5.0 and as such may be more prone to further revision in the next few releases as its use develops. This may be particularly evident where its contents have been borrowed from <msDesc> and have yet to be generalized from their use in the context of manuscript descriptions.
Example	<listObject> <object xml:id="Alfred_Jewel"> <objectIdentifier> <country>United Kingdom</country> <region>Oxfordshire</region> <settlement>Oxford</settlement> <institution>University of Oxford</institution> <repository>Ashmolean Museum</repository> <collection>English Treasures</collection> <idno type="ashmolean">AN1836p.135.371</idno> <idno type="wikipedia">https://en.wikipedia.org/wiki/Alfred_Jewel</idno> <objectName>Alfred Jewel</objectName> </objectIdentifier> <physDesc> <p> The Alfred Jewel is about 6.4 cm in length and is made of combination of filigreed <material>gold</material> surrounding a polished teardrop shaped piece of transparent <material>quartz</material>. Underneath the rock crystal is a cloisonné enamel image of a man with ecclesiastical symbols. The sides of the jewel holding the crystal in place contain an openwork inscription saying "AELFRED MEC HEHT GEWYRCAN", meaning 'Alfred ordered me made'. </p> </physDesc> <history> <origin>It is generally accepted that the Alfred Jewel dates from the <origDate>late 9th Century</origDate> and was most likely made in <origPlace>England</origPlace>. </origin> <provenance when="1693">The jewel was discovered in 1693 at Petherton Park, North Petherton in the English county of Somerset, on land owned by Sir Thomas Wroth. North Petherton is about 8 miles away from Athelney, where King Alfred founded a monastery. </provenance> <provenance when="1698">A description of the Alfred Jewel was first published in 1698, in the Philosophical Transactions of the Royal Society.</provenance> <acquisition> It was bequeathed to Oxford University by Colonel Nathaniel Palmer (c. 1661-1718) and today is in the Ashmolean Museum in Oxford. </acquisition> </history> </object> </listObject> <!-- Elsewhere in document --> <p> The <objectName ref="#MinsterLovellJewel">Minster Lovell Jewel</objectName> is probably the most similar to the <objectName ref="#Alfred_Jewel">Alfred Jewel</objectName> and was found in <placeName ref="#MinsterLovell">Minster Lovell</placeName> in <placeName ref="#Oxfordshire">Oxfordshire</placeName> and is kept at the <orgName ref="#AshmoleanMuseum">Ashmolean Museum</orgName>. </p>
Example	<listObject> <object xml:id="MaskOfTutankhamun"> <objectIdentifier> <objectName xml:lang="en">Mask of Tutankhamun</objectName> <idno type="carter">256a</idno> <idno type="JournalD'Entrée">60672</idno> <idno type="exhibition">220</idno> <institution>Museum of Egyptian Antiquities</institution> <address> <street>15 Meret Basha</street> <district>Ismailia</district> <settlement>Cairo</settlement> <country>Egypt</country> <location> <geo>30.047778, 31.233333</geo> </location> </address> </objectIdentifier> <msContents> <p>The back and shoulders of the mask is inscribed with a protective spell in Egyptian hieroglyphs formed of ten vertical and horizontal lines. This spell first appeared on masks in the Middle Kingdom at least 500 years before Tutankhamun, and comes from chapter 151 of the <title>Book of the Dead</title>.</p> </msContents> <physDesc> <p> The mask of Tutankhamun is 54cm x 39.3cm x 49cm. It is constructed from two layers of high-karat gold that varies in thickness from 1.5-3mm. It weighs approximately 10.23kg and x-ray crystallography shows that it is composed of two alloys of gold with a lighter 18.4 karat shade being used for the face and neck while a heavier 22.5 karat gold was used for the rest of the mask.</p> <p>In the mask Tutankhamun wears a nemes headcloth which has the royal insignia of a cobra (Wadjet) and vulture (Nekhbet) on it. These are thought respectively to symbolise Tutankhamun's rule of both Lower Egypt and Upper Egypt. His ears are pierced for earrings. The mask has rich inlays of coloured glass and gemstones, including lapis lazuli surrounding the eye and eyebrows, quartz for the eyes, obsidian for the pupils. The broad collar is made up of carnelian, feldspar, turquoise, amazonite, faience and other stones.</p> </physDesc> <history> <origin> <p>The mask of Tutankhamun was created in <origPlace>Egypt</origPlace> around <origDate when="-1323" type="circa">1323 BC</origDate>. It is a death mask of the 18th-dynasty ancient Egyptian Pharaoh Tutankhamun who reigned 1332–1323 BC. </p> </origin> <provenance> <p>The mask of Tutankhamun was found in his burial chamber at Theban Necropolis in the Valley of the Kings in 1922. On 28 October 1925 the excavation team led by English archaeologist Howard Carter opened the heavy sarcophagus and three coffins and were the first people in around 3,250 years to see the mask of Tutankhamun. Carter wrote in his diary: <quote> The pins removed, the lid was raised. The penultimate scene was disclosed – a very neatly wrapped mummy of the young king, with golden mask of sad but tranquil expression, symbolizing Osiris … the mask bears that god's attributes, but the likeness is that of Tut.Ankh.Amen – placid and beautiful, with the same features as we find upon his statues and coffins. The mask has fallen slightly back, thus its gaze is straight up to the heavens. </quote> </p> </provenance> <acquisition> In December 1925, the mask was removed from the tomb, placed in a crate and transported 635 kilometres (395 mi) to the Egyptian Museum in Cairo, where it remains on public display. </acquisition> </history> <additional> <adminInfo> <custodialHist> <custEvent when="1944">When it was discovered in 1925, the 2.5kg narrow gold beard was no longer attached to the mask and was reattached to the chin by use of a wooden dowel in 1944.</custEvent> <custEvent when="2014-08"> In August 2014 when the mask was removed from its display case for cleaning, the beard fell off again. Those working in the museum unadvisedly used a quick-drying epoxy to attempt to fix it, but left the beard off-centre. </custEvent> <custEvent when="2015-01">The damage was noticed and repaired in January 2015 by a German-Egyptian team who used beeswax, a material known to be used as adhesives by the ancient Egyptians.</custEvent> </custodialHist> </adminInfo> </additional> </object> </listObject>
Content model	<content> <sequence> <elementRef key="objectIdentifier" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> <sequence> <elementRef key="msContents" minOccurs="0"/> <elementRef key="physDesc" minOccurs="0"/> <elementRef key="history" minOccurs="0"/> <elementRef key="additional" minOccurs="0"/> </sequence> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> <elementRef key="linkGrp"/> <elementRef key="link"/> </alternate> <elementRef key="object" minOccurs="0"/> </sequence> </content>
Schema Declaration	element object { att.global.attributes, att.sortable.attributes, att.typed.attributes, att.declaring.attributes, att.docStatus.attributes, att.canonical.attributes, ( objectIdentifier+, model.headLike, ( model.pLike \| ( msContents?, physDesc?, history?, additional? ) ), ( model.noteLike \| model.biblLike \| linkGrp \| link )*, object? ) }

1.230. <objectDesc>

<objectDesc> contains a description of the physical components making up the object which is being described. [10.7.1. Object Description]

Module

msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

form

a short project-specific name identifying the physical form of the carrier, for example as a codex, roll, fragment, partial leaf, cutting etc.

Status	Optional
Datatype	teidata.enumerated
Note	Definitions for the terms used may typically be provided by a <valList> element in the project schema specification.

Member of

model.physDescPart

Contained by

msdescription: physDesc

May contain

core: p

linking: ab

msdescription: layoutDesc supportDesc

Example

<objectDesc form="codex"> <supportDesc material="mixed"> Early modern <material>parchment</material> and <material>paper</material>. </supportDesc> <layoutDesc> <layout ruledLines="25 32"/> </layoutDesc> </objectDesc>

Content model

<content>
 <alternate>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <sequence>
   <elementRef key="supportDesc"
    minOccurs="0"/>
   <elementRef key="layoutDesc"
    minOccurs="0"/>
  </sequence>
 </alternate>
</content>

Schema Declaration

element objectDesc
{
   att.global.attributes,
   attribute form { text }?,
   ( model.pLike+ | ( supportDesc?, layoutDesc? ) )
}

1.231. <objectIdentifier>

<objectIdentifier> (object identifier) groups one or more identifiers or pieces of locating information concerning a single object. [13.3.5. Objects]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.biblPart
Contained by	core: bibl namesdates: object
May contain	core: address header: idno msdescription: altIdentifier collection institution msName repository namesdates: bloc country district geogName objectName placeName region settlement
Example	<objectIdentifier> <country>United Kingdom</country> <region>Oxfordshire</region> <settlement>Oxford</settlement> <institution>University of Oxford</institution> <repository>Ashmolean Museum</repository> <collection>English Treasures</collection> <idno type="ashmolean">AN1836p.135.371</idno> <idno type="wikipedia">https://en.wikipedia.org/wiki/Alfred_Jewel</idno> <objectName>Alfred Jewel</objectName> </objectIdentifier>
Example	<object xml:id="Excalibur-MultipleNames"> <objectIdentifier> <objectName type="main">Excalibur</objectName> <objectName type="alt">Caliburn</objectName> <objectName xml:lang="cy">Caledfwlch</objectName> <objectName xml:lang="cor">Calesvol</objectName> <objectName xml:lang="br">Kaledvoulc'h</objectName> <objectName xml:lang="la">Caliburnus</objectName> <country>Wales</country> </objectIdentifier> <p>Excalibur is the name for the legendary sword of King Arthur, in Welsh it is called Caledfwlch, in Cornish it is called Calesvol, in Breton it is called Kaledvoulc'h, and in Latin it is called Caliburnus. In some versions Excalibur's blade was engraved with phrases on opposite sides which in translation read: "Take me up" and "Cast me away" (or similar).</p> </object>
Schematron	<s:report test="not(count(*) gt 0)">An objectIdentifier must contain at minimum a single piece of locating or identifying information.</s:report>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.placeNamePart"/> <elementRef key="institution"/> <elementRef key="repository"/> <elementRef key="collection"/> <elementRef key="idno"/> <elementRef key="msName"/> <elementRef key="objectName"/> <elementRef key="altIdentifier"/> <elementRef key="address"/> </alternate> </content>
Schema Declaration	element objectIdentifier { att.global.attributes, ( model.placeNamePart \| institution \| repository \| collection \| idno \| msName \| objectName \| altIdentifier \| address )* }

1.232. <objectName>

<objectName> (name of an object) contains a proper noun or noun phrase used to refer to an object. [13.2.4. Object Names]
Module	namesdates
Attributes	Attributes att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Member of	model.nameLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectIdentifier objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<p> The <objectName ref="#MinsterLovellJewel">Minster Lovell Jewel</objectName> is probably the most similar to the <objectName ref="#AlfredJewel">Alfred Jewel</objectName> and was found in <placeName ref="#MinsterLovell">Minster Lovell</placeName> in <placeName ref="#Oxfordshire">Oxfordshire</placeName> and is kept at the <orgName ref="#AshmoleanMuseum">Ashmolean Museum</orgName>. </p>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element objectName { att.datable.attributes, att.editLike.attributes, att.global.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq }

1.233. <objectType>

<objectType> contains a word or phrase describing the type of object being referred to. [10.3.2. Material and Object Type]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.pPart.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The ref attribute may be used to point to one or more items within a taxonomy of types of object, defined either internally or externally.
Example	<physDesc> <p> Paper and vellum <objectType>codex</objectType> in modern cloth binding.</p> </physDesc>
Example	<physDesc> <p>Fragment of a re-used marble <objectType>funerary stele</objectType>. </p> </physDesc>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element objectType { att.global.attributes, att.canonical.attributes, macro.phraseSeq }

1.234. <occupation>

<occupation> contains an informal description of a person's trade, profession or occupation. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	primary other paid unpaid

scheme

indicates the classification system or taxonomy in use, for example by supplying the identifier of a <taxonomy> element, or pointing to some other resource.

Status	Optional
Datatype	teidata.pointer

code

identifies an occupation code defined within the classification system or taxonomy defined by the scheme attribute.

Status	Optional
Datatype	teidata.pointer

Member of

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   attribute scheme { text }?,
   attribute code { text }?,
   macro.specialPara
}

1.235. <offset>

<offset> marks that part of a relative temporal or spatial expression which indicates the direction of the offset between the two place names, dates, or times involved in the expression. [13.2.3. Place Names]
Module	namesdates
Attributes	Attributes att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.offsetLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<placeName key="NRPA1"> <offset>50 metres below the summit of</offset> <geogName> <geogFeat>Mount</geogFeat> <name>Sinai</name> </geogName> </placeName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element offset { att.datable.attributes, att.editLike.attributes, att.global.attributes, att.naming.attributes, att.typed.attributes, att.dimensions.attributes, macro.phraseSeq }

1.236. <org>

<org> (organization) provides information about an identifiable organization such as a business, a tribe, or any other grouping of people. [13.2.2. Organizational Names]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.editLike (@evidence, @instant) att.sortable (@sortKey)

role

specifies a primary role or classification for the organization.

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as artist, employer, family group, or political party, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

Member of

model.personLike

Contained by

namesdates: listOrg listPerson org

May contain

core: bibl desc head lb listBibl milestone name note p pb

header: biblFull idno

linking: ab anchor link linkGrp

msdescription: msDesc

transcr: fw

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>
 <sequence>
  <classRef key="model.headLike"
   minOccurs="0" maxOccurs="unbounded"/>
  <alternate>
   <classRef key="model.pLike"
    minOccurs="0" maxOccurs="unbounded"/>
   <alternate minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.labelLike"/>
    <classRef key="model.nameLike"/>
    <classRef key="model.placeLike"/>
    <classRef key="model.orgPart"/>
    <classRef key="model.milestoneLike"/>
   </alternate>
  </alternate>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.noteLike"/>
   <classRef key="model.biblLike"/>
   <elementRef key="linkGrp"/>
   <elementRef key="link"/>
   <elementRef key="ptr"/>
  </alternate>
  <classRef key="model.personLike"
   minOccurs="0" maxOccurs="unbounded"/>
 </sequence>
</content>

Schema Declaration

element org
{
   att.global.attributes,
   att.typed.attributes,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute role { list { + } }?,
   (
      model.headLike*,
      (
         model.pLike*
       | (
            model.labelLike
          | model.nameLike
          | model.placeLike
          | model.orgPart
          | model.milestoneLike
         )*
      ),
      ( model.noteLike | model.biblLike | linkGrp | link | ptr )*,
      model.personLike*
   )
}

1.237. <orgName>

<orgName> (organization name) contains an organizational name. [13.2.2. Organizational Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Member of	model.nameLike.agent
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp respStmt sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.datable.attributes, att.editLike.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq }

1.238. <origDate>

<origDate> (origin date) contains any form of date, used to identify the date of origin for a manuscript, manuscript part, or other object. [10.3.1. Origination]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.editLike (@evidence, @instant) att.typed (@type, @subtype)
Member of	model.pPart.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<origDate notBefore="-0300" notAfter="-0200">3rd century BCE</origDate>
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 origDate { att.global.attributes, att.datable.attributes, att.dimensions.attributes, att.editLike.attributes, att.typed.attributes, ( text \| model.gLike \| model.phrase \| model.global )* }

1.239. <origPlace>

<origPlace> (origin place) contains any form of place name, used to identify the place of origin for a manuscript, manuscript part, or other object. [10.3.1. Origination]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.typed (@type, @subtype)
Member of	model.pPart.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The type attribute may be used to distinguish different kinds of ‘origin’, for example original place of publication, as opposed to original place of printing.
Example	<origPlace>Birmingham</origPlace>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element origPlace { att.global.attributes, att.naming.attributes, att.datable.attributes, att.editLike.attributes, att.typed.attributes, macro.phraseSeq }

1.240. <origin>

<origin> contains any descriptive or other information concerning the origin of a manuscript, manuscript part, or other object. [10.8. History]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Contained by	msdescription: history
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<origin notBefore="1802" notAfter="1845" evidence="internal" resp="#AMH">Copied in <name type="origPlace">Derby</name>, probably from an old Flemish original, between 1802 and 1845, according to <persName xml:id="AMH">Anne-Mette Hansen</persName>. </origin>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element origin { att.global.attributes, att.editLike.attributes, att.datable.attributes, macro.specialPara }

1.241. <outputRendition>

<outputRendition> describes the rendering or appearance intended for all occurrences of an element in a specified context for a specified type of output.

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

scope

provides a way of defining ‘pseudo-elements’, that is, styling rules applicable to specific sub-portions of an element.

Status	Optional
Datatype	teidata.enumerated
Sample values include:	first-line styling applies to the first line of the target element. first-letter styling applies to the first character of the target element. before styling should be applied immediately before the content of the target element. after styling should be applied immediately after the content of the target element.

Member of

model.linePart model.segLike

Contained by

core: add del desc head hi l note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote tagUsage

linking: ab seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: model modelGrp schemaSpec specGrp

textcrit: lem rdg witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

Character data only

Note

This component of an element specification describes the rendering or appearance intended for all occurrences of the element in a specified context for a specified type of output. The <rendition> element, by contrast, describes the actual rendering or appearance of all occurrences of the specified element in a source document. The useSourceRendition attribute may however be used to indicate that formatting information provided by a <rendition> element is to be combined with any provided by an <outputRendition> element.

It is strongly recommended that the W3C Cascading Stylesheet language (CSS2 or later) be used to express the required formatting information.

Example

<model predicate="ancestor::p" behaviour="inline"> <outputRendition>font-style: italic;</outputRendition> </model> <model behaviour="block"> <outputRendition>left-margin: 2em;</outputRendition> </model>

Content model

<content>
 <textNode/>
</content>

Schema Declaration

element outputRendition
{
   att.global.attributes,
   attribute scope { text }?,
   text
}

1.242.

<p> (paragraph) marks paragraphs in prose. [3.1. Paragraphs 7.2.5. Speech Contents]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls) att.fragmentable (@part) att.written (@hand)
Member of	model.pLike
Contained by	core: note q quote header: abstract application availability cRefPattern calendar change correction correspAction correspContext correspDesc editionStmt editorialDecl encodingDesc handNote hyphenation interpretation langUsage licence normalization prefixDef projectDesc publicationStmt punctuation quotation refsDecl samplingDecl scriptNote segmentation seriesStmt sourceDesc stdVals styleDefDecl msdescription: accMat acquisition additions binding bindingDesc collation condition custEvent custodialHist decoDesc decoNote filiation foliation handDesc history layout layoutDesc msContents msDesc msFrag msItem msItemStruct msPart musicNotation objectDesc origin physDesc provenance recordHist scriptDesc seal sealDesc signatures source summary support supportDesc surrogates typeDesc typeNote namesdates: climate event langKnowledge listRelation nym object occupation org person personGrp persona place population state terrain trait tagdocs: exemplum remarks specGrp textcrit: lem rdg textstructure: body div front transcr: metamark verse: metDecl
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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	<s:report test="not(ancestor::tei:floatingText) and (ancestor::tei:p or ancestor::tei:ab) and not(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. </s:report>
Schematron	<s:report test="ancestor::tei:l[not(.//tei:note//tei:p[. = current()])]"> Abstract model violation: Lines may not contain higher-level structural elements such as div, p, or ab. </s:report>
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element p { att.global.attributes, att.declaring.attributes, att.fragmentable.attributes, att.written.attributes, macro.paraContent }

1.243. <param>

<param> provides a parameter for a model behaviour by supplying its name and an XPath expression identifying the location of its content. [22.5.4.5. Behaviours and their parameters]

Module tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

name

a name for the parameter being supplied

Status	Required
Datatype	teidata.enumerated
Suggested values include:	alternate when used with behaviour alternate, a parameter of this name supplies one of the pair of possible values; for example the regularized form rather than the original form within a <choice> element. default when used with behaviour alternate, a parameter of this name supplies one of the pair of possible values; for example the original form rather than the regularized form within a <choice> element. height when used with behaviour graphic, a parameter of this name supplies a value for the height of the graphic e.g. "300px", "50%". id a parameter of this name should supply a unique identifier for the element being processed; as for example with the anchor behaviour label a parameter of this name should supply an expression to be used to label something, for example `concat('Page ', @n)` for a page break or `@n` for a footnote reference; typically used with the note or break behaviours level when used with the heading behaviour, a parameter of this name supplies a positive integer indicating the hierarchic level of a heading. link when used with the link behaviour, a parameter of this name should supply a URL to be used as the target of a link. place when used with the note behaviour, a parameter of this name should provide a string which describes the intended placement of some text; typical values include "margin", "footnote", "endnote", "inline", "bottom" type a parameter of this name can be used to categorize the specified behaviour in any way; for example the kind of break (when used with the break behaviour) or the kind of index to be generated (if used with the index behaviour) etc. url when used with behaviour graphic, a parameter of this name supplies a a URL indicating the graphic intended. width when used with behaviour graphic, a parameter of this name supplies a value for the width of the graphic e.g. "400px", "70%".

value

supplies an XPath expression which when evaluated provides the value for the parameter

Status	Required
Datatype	teidata.xpath

Contained by

tagdocs: model

May contain Empty element

Note

An implementation may require parameters other than those listed here, and is not required to follow this partial specification.

The names and datatypes of the expected parameters should be documented in the corresponding customization using a <paramSpec> element. Literal strings provided in an XPath expression should be quoted.

Example

In this example, which will be processed for a <choice> element which has both <sic> and <corr> child elements, the default parameter will provide the value of the child <corr> element, and the alternate parameter will provide that of the child <sic> elements. If neither <param> element was supplied, both elements would still be available to an application, but the application would need to distinguish them for itself.

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element param
{
   att.global.attributes,
   attribute name
   {
      "alternate"
    | "default"
    | "height"
    | "id"
    | "label"
    | "level"
    | "link"
    | "place"
    | "type"
    | "url"
    | "width"
   },
   attribute value { text },
   empty
}

1.244. <paramList>

<paramList> list of parameter specifications
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	tagdocs: valItem
May contain	tagdocs: paramSpec
Note	The <paramList> element provides a a mechanism to document parameter specifications using child <paramSpec> elements.
Example	<valItem ident="alternate"> <desc versionDate="2015-08-21" xml:lang="en">create a specialized display of alternating elements for displaying the preferred version and an alternative, both at once or by some method of toggling between the two.</desc> <paramList> <paramSpec ident="default"> <desc>preferred content</desc> </paramSpec> <paramSpec ident="alternate"> <desc>alternate content</desc> </paramSpec> </paramList> </valItem>
Content model	<content> <elementRef minOccurs="0" maxOccurs="unbounded" key="paramSpec"/> </content>
Schema Declaration	element paramList { att.global.attributes, paramSpec* }

1.245. <paramSpec>

<paramSpec> supplies specification for one parameter of a model behaviour [22.5.4.8. Defining a processing model]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) )
Contained by	tagdocs: paramList
May contain	core: desc tagdocs: altIdent equiv
Note	Where a model behaviour uses more than one parameter, individual <paramSpec> elements should be grouped together using a <paramList> element, as above. Parameter specifications are provided within the <valItem> used to define a particular behaviour, which forms part of the specification of a <model> element's behaviour attribute. In the example above, the behaviour link has two parameters: content and link. Using a <desc> element within a <paramSpec> is optional but recommended practice.
Example	<valItem ident="link"> <desc>create a hyperlink</desc> <paramList> <paramSpec ident="content"> <desc>supplies the location of some content describing the link</desc> </paramSpec> <paramSpec ident="link"> <desc>supplies the location of the intended URL</desc> </paramSpec> </paramList> </valItem>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.glossLike"/> <classRef key="model.descLike"/> </alternate> </content>
Schema Declaration	element paramSpec { att.global.attributes, att.identified.attributes, ( model.glossLike \| model.descLike )* }

1.246. <path>

<path> defines any line passing through two or more points within a <surface> element. [11.1. Digital Facsimiles 11.2.2. Embedded Transcription]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.written (@hand) att.coordinated (points, @start, @ulx, @uly, @lrx, @lry)

points

identifies a line within the container or bounding box specified by the parent element by means of a series of two or more pairs of numbers, each of which gives the x,y coordinates of a point on the line.

Derived from	att.coordinated
Status	Optional
Datatype	2–∞ occurrences of teidata.point separated by whitespace

Member of

model.linePart

Contained by

transcr: line surface zone

May contain

Empty element

Note

Although the simplest form of a path is a straight line between two points, a line with more than two points may bend at any point. The order of coordinates in points is significant, because the line follows the coordinate sequence.

Note

To specify a closed polygon, use the <zone> element rather than the <path> element.

Example

Schematron

<sch:rule context="tei:path[@points]"> <sch:let name="firstPair" value="tokenize( normalize-space( @points ), ' ')[1]"/> <sch:let name="lastPair" value="tokenize( normalize-space( @points ), ' ')[last()]"/> <sch:let name="firstX" value="xs:float( substring-before( $firstPair, ',') )"/> <sch:let name="firstY" value="xs:float( substring-after( $firstPair, ',') )"/> <sch:let name="lastX" value="xs:float( substring-before( $lastPair, ',') )"/> <sch:let name="lastY" value="xs:float( substring-after( $lastPair, ',') )"/> <sch:report test="$firstX eq $lastX and $firstY eq $lastY">The first and last elements of this path are the same. To specify a closed polygon, use the zone element rather than the path element. </sch:report> </sch:rule>

Content model

<content>
 <empty/>
</content>

Schema Declaration

element path
{
   att.global.attributes,
   att.coordinated.attribute.start,
   att.coordinated.attribute.ulx,
   att.coordinated.attribute.uly,
   att.coordinated.attribute.lrx,
   att.coordinated.attribute.lry,
   att.typed.attributes,
   att.written.attributes,
   attribute points { list { * } }?,
   empty
}

1.247. <pb>

<pb> (page beginning) marks the beginning of a new page in a paginated document. [3.10.3. Milestone Elements]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.edition (@ed, @edRef) att.spanning (@spanTo) att.breaking (@break)
Member of	model.milestoneLike
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg listBibl name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc subst supplied surface surfaceGrp surplus zone verse: metSym rhyme
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.typed.attributes, att.edition.attributes, att.spanning.attributes, att.breaking.attributes, empty }

1.248. <pc>

<pc> (punctuation character) contains a character or string of characters regarded as constituting a single punctuation mark. [17.1.2. Below the Word Level 17.4.2. Lightweight Linguistic Annotation]

Module

analysis

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.linguistic (@lemma, @lemmaRef, @pos, @msd, @join)

force

indicates the extent to which this punctuation mark conventionally separates words or phrases

Status	Optional
Datatype	teidata.enumerated
Legal values are:	strong the punctuation mark is a word separator weak the punctuation mark is not a word separator inter the punctuation mark may or may not be a word separator

unit

provides a name for the kind of unit delimited by this punctuation mark.

Status	Optional
Datatype	teidata.enumerated

pre

indicates whether this punctuation mark precedes or follows the unit it delimits.

Status	Optional
Datatype	teidata.truthValue

Member of

Contained by

analysis: cl phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: damage fw line metamark mod restore retrace secl supplied surplus zone

verse: rhyme

May contain

analysis: c

core: add choice del reg sic unclear

gaiji: g

transcr: am damage ex handShift mod redo restore retrace secl subst supplied surplus undo

character data

Example

<phr> <w>do</w> <w>you</w> <w>understand</w> <pc type="interrogative">?</pc> </phr>

Example

Example encoding of the German sentence Wir fahren in den Urlaub., encoded with attributes from att.linguistic discussed in section [[undefined AILALW]].

<s> <w pos="PPER" msd="1.Pl.*.Nom">Wir</w> <w pos="VVFIN" msd="1.Pl.Pres.Ind">fahren</w> <w pos="APPR" msd="--">in</w> <w pos="ART" msd="Def.Masc.Akk.Sg.">den</w> <w pos="NN" msd="Masc.Akk.Sg.">Urlaub</w> <pc pos="$." msd="--" join="left">.</pc> </s>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <elementRef key="c"/>
  <classRef key="model.pPart.edit"/>
 </alternate>
</content>

Schema Declaration

element pc
{
   att.global.attributes,
   att.segLike.attributes,
   att.typed.attributes,
   att.linguistic.attributes,
   attribute force { "strong" | "weak" | "inter" }?,
   attribute unit { text }?,
   attribute pre { text }?,
   ( text | model.gLike | c | model.pPart.edit )*
}

1.249. <persName>

<persName> (personal name) contains a proper noun or proper-noun phrase referring to a person, possibly including one or more of the person's forenames, surnames, honorifics, added names, etc. [13.2.1. Personal Names]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.typed (@type, @subtype) att.personal (@full, @sort) att.naming (@role, @nymRef) att.canonical (ref, @key)

ref

Status

Required

Legal values are:

#mjk
#ebb
#ama
#amp
#Elizabeth_Stevenson_Gaskell
#Wm_Gaskell
#MA_Gaskell_Holland
#Meta_Gaskell
#Hannah_Holland_Lumb
#Abigail_Holland
#Bessy_Holland
#Margaret_Gaskell_Dimock
#Elizabeth_Gaskell_Holland
#Sam_Gaskell
#Richard_Deane
#MaryAnn_Deane
#Edward_Deane
#Emily_Deane
#Mrs_Collins
#James_Partington
#Betsy_household
#Fanny_household
#Elizabeth_Barlow_household
#Mme_DeSaussure
#Andrew_Combe
#Florence_Gaskell_Crompton
#Julia_Gaskell
#William_Gaskell_son
#William_Stevenson
#Elizabeth_Holland_Stevenson
#John_Stevenson
#Catherine_Thompson_Stevenson
#Marianne_Lumb
#Anne_Gaskell
#Robert_Gaskell
#Edward_Dimock
#William_Gaskell_Senior
#God
#Peter_Holland
#Caroline_Bowles_Southey
#Holbrook_Gaskell
#Queen_Victoria
#William_Howitt

Member of

model.nameLike.agent model.persStateLike

Contained by

analysis: cl phr s span

core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp respStmt sic textLang time title unclear

header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.personal.attribute.full,
   att.personal.attribute.sort,
   att.naming.attribute.role,
   att.naming.attribute.nymRef,
   att.canonical.attribute.key,
   att.typed.attributes,
   attribute ref
   {
      "#mjk"
    | "#ebb"
    | "#ama"
    | "#amp"
    | "#Elizabeth_Stevenson_Gaskell"
    | "#Wm_Gaskell"
    | "#MA_Gaskell_Holland"
    | "#Meta_Gaskell"
    | "#Hannah_Holland_Lumb"
    | "#Abigail_Holland"
    | "#Bessy_Holland"
    | "#Margaret_Gaskell_Dimock"
    | "#Elizabeth_Gaskell_Holland"
    | "#Sam_Gaskell"
    | "#Richard_Deane"
    | "#MaryAnn_Deane"
    | "#Edward_Deane"
    | "#Emily_Deane"
    | "#Mrs_Collins"
    | "#James_Partington"
    | "#Betsy_household"
    | "#Fanny_household"
    | "#Elizabeth_Barlow_household"
    | "#Mme_DeSaussure"
    | "#Andrew_Combe"
    | "#Florence_Gaskell_Crompton"
    | "#Julia_Gaskell"
    | "#William_Gaskell_son"
    | "#William_Stevenson"
    | "#Elizabeth_Holland_Stevenson"
    | "#John_Stevenson"
    | "#Catherine_Thompson_Stevenson"
    | "#Marianne_Lumb"
    | "#Anne_Gaskell"
    | "#Robert_Gaskell"
    | "#Edward_Dimock"
    | "#William_Gaskell_Senior"
    | "#God"
    | "#Peter_Holland"
    | "#Caroline_Bowles_Southey"
    | "#Holbrook_Gaskell"
    | "#Queen_Victoria"
    | "#William_Howitt"
   },
   macro.phraseSeq
}

1.250. <person>

<person> provides information about an identifiable individual, for example a participant in a language interaction, or a person referred to in a historical source. [13.3.2. The Person Element 15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.sortable (@sortKey)

role

specifies a primary role or classification for the person.

Status	Optional
Datatype	1–∞ occurrences of teidata.enumerated separated by whitespace
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as artist, employer, author, relative, or servant, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

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.

age

specifies an age group for the person.

Status	Optional
Datatype	teidata.enumerated
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as infant, child, teen, adult, or senior, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

Member of

model.personLike

Contained by

namesdates: listPerson org

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: bibl gap lb listBibl milestone name note p pb

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: msDesc

namesdates: affiliation age birth death education event faith floruit langKnowledge listEvent nationality occupation persName persona residence sex socecStatus state trait

textcrit: app witDetail

transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin

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"> Female respondent, well-educated, born in Shropshire UK, 12 Jan 1950, of unknown occupation. Speaks French fluently. Socio-Economic status B2. </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>
  <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.attributes,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute role { list { + } }?,
   attribute sex { list { + } }?,
   attribute age { text }?,
   ( model.pLike+ | ( model.personPart | model.global | ptr )* )
}

1.251. <personGrp>

<personGrp> (personal group) describes a group of individuals treated as a single person for analytic purposes. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey)

role

specifies the role of this group of participants in the interaction.

Status	Optional
Datatype	teidata.enumerated
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as movement, employers, relatives, or servants, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

sex

specifies the sex of the participant group.

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. For a mixed group, a value such as "mixed" may also be supplied.

age

specifies the age group of the participants.

Status	Optional
Datatype	teidata.enumerated
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as infant, child, teen, adult, or senior, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

size

describes informally the size or approximate size of the group for example by means of a number and an indication of accuracy e.g. approx 200.

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace

Member of

model.personLike

Contained by

namesdates: listPerson org

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: bibl gap lb listBibl milestone name note p pb

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: msDesc

namesdates: affiliation age birth death education event faith floruit langKnowledge listEvent nationality occupation persName persona residence sex socecStatus state trait

textcrit: app witDetail

transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin

Note

May contain a prose description organized as paragraphs, or any sequence of demographic elements in any combination.

The global xml:id attribute should be used to identify each speaking participant in a spoken text if the who attribute is specified on individual utterances.

Example

Content model

<content>
 <alternate>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.personPart"/>
   <classRef key="model.global"/>
  </alternate>
 </alternate>
</content>

Schema Declaration

element personGrp
{
   att.global.attributes,
   att.sortable.attributes,
   attribute role { text }?,
   attribute sex { list { + } }?,
   attribute age { text }?,
   attribute size { list { + } }?,
   ( model.pLike+ | ( model.personPart | model.global )* )
}

1.252. <persona>

<persona> provides information about one of the personalities identified for a given individual, where an individual has multiple personalities. [13.3.2. The Person Element]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.sortable (@sortKey)

role

specifies a primary role or classification for the persona.

Status	Optional
Datatype	1–∞ occurrences of teidata.enumerated separated by whitespace
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as artist, employer, author, relative, or servant, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

sex

specifies the sex of the persona.

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.

age

specifies an age group for the persona.

Status	Optional
Datatype	teidata.enumerated
Note	Values for this attribute may be locally defined by a project, using arbitrary keywords such as infant, child, teen, adult, or senior, each of which should be associated with a definition. Such local definitions will typically be provided by a <valList> element in the project schema specification.

Member of

model.certLike model.global.meta

Contained by

namesdates: person personGrp persona

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: bibl gap lb listBibl milestone name note p pb

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: msDesc

namesdates: affiliation age birth death education event faith floruit langKnowledge listEvent nationality occupation persName persona residence sex socecStatus state trait

textcrit: app witDetail

transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin

Note

Note that a persona is not the same as a role. A role may be assumed by different people on different occasions, whereas a persona is unique to a particular person, even though it may resemble others. Similarly, when an actor takes on or enacts the role of a historical person, they do not thereby acquire a new persona.

Example

<person sex="M" age="adult"> <persona sex="M"> <persName>Dr Henry Jekyll</persName> </persona> <persona sex="M" age="youth"> <persName>Edward Hyde</persName> </persona> </person>

Content model

<content>
 <alternate>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.personPart"/>
   <classRef key="model.global"/>
  </alternate>
 </alternate>
</content>

Schema Declaration

element persona
{
   att.global.attributes,
   att.editLike.attributes,
   att.sortable.attributes,
   attribute role { list { + } }?,
   attribute sex { list { + } }?,
   attribute age { text }?,
   ( model.pLike+ | ( model.personPart | model.global )* )
}

1.253. <phr>

<phr> (phrase) represents a grammatical phrase. [17.1. Linguistic Segment Categories]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation)
Member of	model.segLike
Contained by	analysis: cl phr s core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The type attribute may be used to indicate the type of phrase, taking values such as noun, verb, preposition, etc. as appropriate.
Example	<phr type="verb" function="extraposted_modifier">To talk <phr type="preposition" function="complement">of <phr type="noun" function="object">many things</phr> </phr> </phr>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element phr { att.global.attributes, att.segLike.attributes, att.typed.attributes, att.notated.attributes, macro.phraseSeq }

1.254. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: msDesc msFrag msPart namesdates: object
May contain	core: p linking: ab msdescription: accMat additions bindingDesc decoDesc handDesc musicNotation objectDesc scriptDesc sealDesc typeDesc
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> <sequence> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.physDescPart" expand="sequenceOptional"/> </sequence> </content>
Schema Declaration	element physDesc { att.global.attributes, ( model.pLike*, objectDesc?, handDesc?, typeDesc?, scriptDesc?, musicNotation?, decoDesc?, additions?, bindingDesc?, sealDesc?, accMat? ) }

1.255. <place>

<place> contains data about a geographic location [13.3.4. Places]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.editLike (@evidence, @instant) att.sortable (@sortKey)
Member of	model.placeLike
Contained by	namesdates: listPlace org place
May contain	core: bibl desc head listBibl note p header: biblFull idno linking: ab link linkGrp msdescription: msDesc namesdates: bloc climate country district event geogName listEvent listPlace location place placeName population region settlement state terrain trait
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> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.labelLike"/> <classRef key="model.placeStateLike"/> <classRef key="model.eventLike"/> </alternate> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> <elementRef key="idno"/> <elementRef key="ptr"/> <elementRef key="linkGrp"/> <elementRef key="link"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.placeLike"/> <elementRef key="listPlace"/> </alternate> </sequence> </content>
Schema Declaration	element place { att.global.attributes, att.typed.attributes, att.editLike.attributes, att.sortable.attributes, ( model.headLike, ( model.pLike \| ( model.labelLike \| model.placeStateLike \| model.eventLike )* ), ( model.noteLike \| model.biblLike \| idno \| ptr \| linkGrp \| link ), ( model.placeLike \| listPlace ) ) }

1.256. <placeName>

<placeName> contains an absolute or relative place name. [13.2.3. Place Names]

Module

namesdates

Attributes

Attributes att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.personal (@full, @sort) att.naming (@role, @nymRef) att.canonical (ref, @key)

ref

Status	Required
Legal values are:	#Knutsford #London #Alton #Warrington #ProspectHill #Grange #Crosby #Wales #InfantSchool #Latchford #Geneva #Edinburgh #Savannah #Berwick #Manchester #CloptonHall #CrossStreetChapel #SankeyStreetChapel #England #Chelsea #Porthmadog #Heathside #Sandlebridge #PlasynPenhryn #ChurchHouse

Member of

model.placeNamePart

Contained by

analysis: cl phr s span

core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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.attributes,
   att.editLike.attributes,
   att.global.attributes,
   att.personal.attribute.full,
   att.personal.attribute.sort,
   att.naming.attribute.role,
   att.naming.attribute.nymRef,
   att.canonical.attribute.key,
   att.typed.attributes,
   attribute ref
   {
      "#Knutsford"
    | "#London"
    | "#Alton"
    | "#Warrington"
    | "#ProspectHill"
    | "#Grange"
    | "#Crosby"
    | "#Wales"
    | "#InfantSchool"
    | "#Latchford"
    | "#Geneva"
    | "#Edinburgh"
    | "#Savannah"
    | "#Berwick"
    | "#Manchester"
    | "#CloptonHall"
    | "#CrossStreetChapel"
    | "#SankeyStreetChapel"
    | "#England"
    | "#Chelsea"
    | "#Porthmadog"
    | "#Heathside"
    | "#Sandlebridge"
    | "#PlasynPenhryn"
    | "#ChurchHouse"
   },
   macro.phraseSeq
}

1.257. <population>

<population> contains information about the population of a place. [13.3.4.3. States, Traits, and Events]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.placeStateLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName place placeName population region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	certainty: precision core: bibl desc head listBibl note p header: biblFull linking: ab msdescription: msDesc namesdates: population
Example	<population when="2001-04" resp="#UKCensus"> <population type="white"> <desc>54153898</desc> </population> <population type="asian"> <desc>11811423</desc> </population> <population type="black"> <desc>1148738</desc> </population> <population type="mixed"> <desc>677117</desc> </population> <population type="chinese"> <desc>247403</desc> </population> <population type="other"> <desc>230615</desc> </population> </population>
Content model	<content> <sequence> <elementRef key="precision" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <sequence minOccurs="0"> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.labelLike" minOccurs="1" maxOccurs="unbounded"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> </sequence> <elementRef key="population" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element population { att.global.attributes, att.datable.attributes, att.editLike.attributes, att.naming.attributes, att.typed.attributes, att.dimensions.attributes, ( precision, model.headLike, ( ( model.pLike+ \| model.labelLike+ ), ( model.noteLike \| model.biblLike )* )?, population* ) }

1.258. <precision>

<precision> indicates the numerical accuracy or precision associated with some aspect of the text markup. [21.2. Indications of Precision]

Module

certainty

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.scoping (@target, @match) att.ranging (@atLeast, @atMost, @min, @max, @confidence) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))

precision

characterizes the precision of the element or attribute pointed to by the <precision> element.

Status	Optional
Datatype	teidata.certainty

stdDeviation

supplies a standard deviation associated with the value in question

Status	Optional
Datatype	teidata.numeric

Member of

Contained by

analysis: cl interp m phr s span w

certainty: certainty precision respons

core: add address author bibl biblScope date del editor email gap head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab join seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc space substJoin supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

certainty: certainty precision respons

core: desc

Example

<date xml:id="date001" notBefore="0014" notAfter="0064">Within about 50 years of the death of Augustus</date> <precision target="#date001" match="@notBefore" precision="high"/> <precision target="#date001" match="@notAfter" precision="low"/>

Example

<date notBefore="1632" notAfter="1642">Not more than ten years before the start of the Civil War <precision match="@notBefore" precision="low"/> <precision match="@notAfter" precision="high"/> </date>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>

Schema Declaration

element precision
{
   att.global.attributes,
   att.scoping.attributes,
   att.ranging.attributes,
   att.datable.attributes,
   attribute precision { text }?,
   attribute stdDeviation { text }?,
   ( model.descLike | model.certLike )*
}

1.259. <prefixDef>

<prefixDef> (prefix definition) defines a prefixing scheme used in data.pointer values, showing how abbreviated URIs using the scheme may be expanded into full URIs. [16.2.3. Using Abbreviated Pointers]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.patternReplacement (@matchPattern, @replacementPattern)

ident

supplies a name which functions as the prefix for an abbreviated pointing scheme such as a private URI scheme. The prefix constitutes the text preceding the first colon.

Status	Required
Datatype	teidata.prefix
Note	The value is limited to teidata.prefix so that it may be mapped directly to a URI prefix.

Contained by

header: listPrefixDef

May contain

core: p

linking: ab

Note

The abbreviated pointer may be dereferenced to produce either an absolute or a relative URI reference. In the latter case it is combined with the value of xml:base in force at the place where the pointing attribute occurs to form an absolute URI in the usual manner as prescribed by XML Base.

Example

<prefixDef ident="ref" matchPattern="([a-z]+)" replacementPattern="../../references/references.xml#$1"> In the context of this project, private URIs with the prefix "ref" point to <gi>div</gi> elements in the project's global references.xml file. </prefixDef>

Content model

<content>
 <classRef key="model.pLike" minOccurs="0"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element prefixDef
{
   att.global.attributes,
   att.patternReplacement.attributes,
   attribute ident { text },
   model.pLike*
}

1.260. <principal>

<principal> (principal researcher) supplies the name of the principal researcher responsible for the creation of an electronic text. [2.2.1. The Title Statement]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.respLike
Contained by	core: bibl header: editionStmt titleStmt msdescription: msItem
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: address choice date email gap hi lb milestone name note pb ref time title header: idno linking: alt altGrp anchor join joinGrp link linkGrp timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val textcrit: app witDetail transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data
Example	<principal ref="http://viaf.org/viaf/105517912">Gary Taylor</principal>
Content model	<content> <macroRef key="macro.phraseSeq.limited"/> </content>
Schema Declaration	element principal { att.global.attributes, att.canonical.attributes, macro.phraseSeq.limited }

1.261. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.teiHeaderPart
Contained by	header: biblFull teiHeader
May contain	header: abstract calendarDesc correspDesc creation langUsage textClass transcr: handNotes listTranspose
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.attributes, model.profileDescPart* }

1.262. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	core: p linking: ab
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.attributes, att.declarable.attributes, model.pLike+ }

1.263. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.typed (@type, @subtype)
Contained by	msdescription: history
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<provenance>Listed as the property of Lawrence Sterne in 1788.</provenance> <provenance>Sold at Sothebys in 1899.</provenance>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element provenance { att.global.attributes, att.datable.attributes, att.typed.attributes, macro.specialPara }

1.264. <pubPlace>

<pubPlace> (publication place) contains the name of the place where a bibliographic item was published. [3.11.2.4. Imprint, Size of a Document, and Reprint Information]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Member of	model.imprintPart model.publicationStmtPart.detail
Contained by	core: bibl header: publicationStmt
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<publicationStmt> <publisher>Oxford University Press</publisher> <pubPlace>Oxford</pubPlace> <date>1989</date> </publicationStmt>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element pubPlace { att.global.attributes, att.naming.attributes, macro.phraseSeq }

1.265. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: biblFull fileDesc
May contain	core: address date p pubPlace publisher ref header: authority availability distributor idno linking: ab
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 & 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> <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.attributes, ( ( model.publicationStmtPart.agency, model.publicationStmtPart.detail* )+ \| model.pLike+ ) }

1.266. <publisher>

<publisher> provides the name of the organization responsible for the publication or distribution of a bibliographic item. [3.11.2.4. Imprint, Size of a Document, and Reprint Information 2.2.4. Publication, Distribution, Licensing, etc.]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.imprintPart model.publicationStmtPart.agency
Contained by	core: bibl header: publicationStmt
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
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> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element publisher { att.global.attributes, att.canonical.attributes, macro.phraseSeq }

1.267. <punctuation>

<punctuation> specifies editorial practice adopted with respect to punctuation marks in the original. [2.3.3. The Editorial Practices Declaration 3.2. Treatment of Punctuation]

Module

header

Attributes

Attributes att.declarable (@default) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

marks

indicates whether or not punctation marks have been retained as content within the text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	none no punctuation marks have been retained some some punctuation marks have been retained all all punctuation marks have been retained

placement

indicates the positioning of punctuation marks that are associated with marked up text as being encoded within the element surrounding the text or immediately before or after it.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	internal punctuation marks found at the start or end of a marked up text component are included within its surrounding element; external punctuation marks found at the start or end of a marked up text component appear immediately before or after the surrounding element

Member of

Contained by

header: editorialDecl

May contain

core: p

linking: ab

Example

<punctuation marks="all" placement="internal"> All punctuation marks in the source text have been retained and represented using the appropriate Unicode code point. In cases where a punctuation mark and nearby markup convey the same information (for example, a sentence ends with a question mark and is also tagged as <gi>s</gi>) the punctuation mark is captured as content within the element. </punctuation>

Example

External placement of punctuation:

I would agree with Saint Augustine that “<quote>An unjust law is no law at all</quote>.”

Example

Internal placement of punctuation:

I would agree with Saint Augustine that <quote>“An unjust law is no law at all.”</quote>

Content model

<content>
 <classRef key="model.pLike" minOccurs="0"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element punctuation
{
   att.declarable.attributes,
   att.global.attributes,
   attribute marks { "none" | "some" | "all" }?,
   attribute placement { "internal" | "external" }?,
   model.pLike*
}

1.268. <q>

<q> (quoted) contains material which is distinguished from the surrounding text using quotation marks or a similar method, for any one of a variety of reasons including, but not limited to: direct speech or thought, technical terms or jargon, authorial distance, quotations from elsewhere, and passages that are mentioned but not used. [3.3.3. Quotation]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.ascribed.directed (@toWhom) (att.ascribed (@who))

type

may be used to indicate whether the offset passage is spoken or thought, or to characterize it more finely.

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	spoken representation of speech thought representation of thought, e.g. internal monologue written quotation from a written source soCalled authorial distance foreign distinct linguistically distinct term technical term emph rhetorically emphasized mentioned refering to itself, not its normal referent

Member of

model.qLike

Contained by

analysis: cl phr s

core: add author biblScope del desc editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang title unclear

header: change distributor edition extent geoDecl handNote licence rendition scriptNote tagUsage

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witness

textstructure: body div

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Note

May be used to indicate that a passage is distinguished from the surrounding text for reasons concerning which no claim is made. When used in this manner, <q> may be thought of as syntactic sugar for <hi> with a value of rend that indicates the use of such mechanisms as quotation marks.

Example

It is spelled <q>Tübingen</q> — to enter the letter <q>u</q> with an umlaut hold down the <q>option</q> key and press <q>0 0 f c</q>

Content model

<content>
 <macroRef key="macro.specialPara"/>
</content>

Schema Declaration

element q
{
   att.global.attributes,
   att.ascribed.directed.attributes,
   attribute type
   {
      "spoken"
    | "thought"
    | "written"
    | "soCalled"
    | "foreign"
    | "distinct"
    | "term"
    | "emph"
    | "mentioned"
   }?,
   macro.specialPara
}

1.269. <quotation>

<quotation> specifies editorial practice adopted with respect to quotation marks in the original. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)

marks

(quotation marks) indicates whether or not quotation marks have been retained as content within the text.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	none no quotation marks have been retained some some quotation marks have been retained all all quotation marks have been retained

Member of

model.linePart model.pPart.transcriptional

Contained by

header: editorialDecl

May contain

core: p

linking: ab

Example

<quotation marks="none"> No quotation marks have been retained. Instead, the <att>rend</att> attribute on the <gi>q</gi> element is used to specify what kinds of quotation mark was used, according to the following list: <list type="gloss"> <label>dq</label> <item>double quotes, open and close</item> <label>sq</label> <item>single quotes, open and close</item> <label>dash</label> <item>long dash open, no close</item> <label>dg</label> <item>double guillemets, open and close</item> </list> </quotation>

Example

<quotation marks="all"> All quotation marks are retained in the text and are represented by appropriate Unicode characters. </quotation>

Schematron

<s:report test="not(@marks) and not (tei:p)">On <s:name/>, either the @marks attribute should be used, or a paragraph of description provided</s:report>

Content model

<content>
 <classRef key="model.pLike" minOccurs="0"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element quotation
{
   att.global.attributes,
   att.declarable.attributes,
   attribute marks { "none" | "some" | "all" }?,
   model.pLike*
}

1.270. <quote>

<quote> (quotation) contains a phrase or passage attributed by the narrator or author to some agency external to the text. [3.3.3. Quotation 4.3.1. Grouped Texts]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.msExcerpt (@defective) att.notated (@notation)
Member of	model.quoteLike
Contained by	analysis: cl phr s core: add author biblScope del desc editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang title unclear header: change distributor edition extent geoDecl handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witness textstructure: body div transcr: damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	If a bibliographic citation is supplied for the source of a quotation, the two may be grouped using the <cit> element.
Example	Lexicography has shown little sign of being affected by the work of followers of J.R. Firth, probably best summarized in his slogan, <quote>You shall know a word by the company it keeps</quote> <ref>(Firth, 1957)</ref>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element quote { att.global.attributes, att.typed.attributes, att.msExcerpt.attributes, att.notated.attributes, macro.specialPara }

1.271. <rdg>

<rdg> (reading) contains a single reading within a textual variation. [12.1. The Apparatus Entry, Readings, and Witnesses]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.textCritical (@type, @cause, @varSeq, @require) (att.written (@hand)) att.witnessed (@wit)
Member of	model.rdgLike
Contained by	textcrit: app rdgGrp
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app lacunaEnd lacunaStart listApp listWit wit witDetail witEnd witStart textstructure: div transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<rdg wit="#Ra2">Eryment</rdg>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.divLike"/> <classRef key="model.divPart"/> <classRef key="model.gLike"/> <classRef key="model.phrase"/> <classRef key="model.inter"/> <classRef key="model.global"/> <classRef key="model.rdgPart"/> </alternate> </content>
Schema Declaration	element rdg { att.global.attributes, att.textCritical.attributes, att.witnessed.attributes, ( text \| model.divLike \| model.divPart \| model.gLike \| model.phrase \| model.inter \| model.global \| model.rdgPart )* }

1.272. <rdgGrp>

<rdgGrp> (reading group) within a textual variation, groups two or more readings perceived to have a genetic relationship or other affinity. [12.1. The Apparatus Entry, Readings, and Witnesses]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.textCritical (@type, @cause, @varSeq, @require) (att.written (@hand))
Contained by	textcrit: app rdgGrp
May contain	core: note textcrit: lem rdg rdgGrp wit witDetail
Note	May contain readings and nested reading groups. Usually, only one <lem> element should appear within a single apparatus entry, whether it appears outside a <rdgGrp> element or within it.
Example	<app> <lem wit="#El #Ra2">though</lem> <rdgGrp type="orthographic"> <rdg wit="#Hg">thogh</rdg> <rdg wit="#La">thouhe</rdg> </rdgGrp> </app>
Schematron	<sch:assert test="count(tei:lem) < 2">Only one <lem> element may appear within a <rdgGrp></sch:assert>
Content model	<content> <sequence> <elementRef key="lem" minOccurs="0"/> <alternate maxOccurs="unbounded" minOccurs="0"> <classRef key="model.rdgLike"/> <classRef key="model.noteLike"/> <elementRef key="witDetail"/> <elementRef key="wit"/> <elementRef key="rdgGrp"/> </alternate> </sequence> </content>
Schema Declaration	element rdgGrp { att.global.attributes, att.textCritical.attributes, ( lem?, ( model.rdgLike \| model.noteLike \| witDetail \| wit \| rdgGrp )* ) }

1.273. <recordHist>

<recordHist> (recorded history) provides information about the source and revision status of the parent manuscript or object description itself. [10.9.1. Administrative Information]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: adminInfo
May contain	core: p header: change linking: ab msdescription: source
Example	<recordHist> <source> <p>Derived from <ref target="#IMEV">IMEV 123</ref> with additional research by P.M.W.Robinson</p> </source> <change when="1999-06-23"> <name>LDB</name> (editor) checked examples against DTD version 3.6 </change> </recordHist>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="source"/> <elementRef key="change" minOccurs="0" maxOccurs="unbounded"/> </sequence> </alternate> </content>
Schema Declaration	element recordHist { att.global.attributes, ( model.pLike+ \| ( source, change* ) ) }

1.274. <redo>

<redo> indicates one or more cancelled interventions in a document which have subsequently been marked as reaffirmed or repeated. [11.3.4.4. Confirmation, Cancellation, and Reinstatement of Modifications]

Module transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.spanning (@spanTo) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

target

points to one or more elements representing the interventions which are being reasserted.

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

Member of

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone

verse: rhyme

May contain Empty element

Example

<line> <redo hand="#g_t" target="#redo-1" cause="fix"/> <mod xml:id="redo-1" rend="strikethrough" spanTo="#anchor-1" hand="#g_bl"/>Ihr hagren, triſten, krummgezog<mod rend="strikethrough">nen</mod>ener Nacken </line> <line>Wenn ihr nur piepſet iſt die Welt ſchon matt.<anchor xml:id="anchor-1"/> </line>

This encoding represents the following sequence of events:

"Ihr hagren, triſten, krummgezog nenener Nacken/ Wenn ihr nur piepſet iſt die Welt ſchon matt." is written
the redundant letters "nen" in "nenener" are deleted
the whole passage is deleted by hand g_bl using strikethrough
the deletion is reasserted by another hand (identified here as g_t)

Content model

<content>
 <empty/>
</content>

Schema Declaration

element redo
{
   att.global.attributes,
   att.spanning.attributes,
   att.transcriptional.attributes,
   att.dimensions.attributes,
   attribute target { list { + } }?,
   empty
}

1.275. <ref>

<ref> (reference) defines a reference to another location, possibly modified by additional text or comment. [3.6. Simple Links and Cross-References 16.1. Links]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.internetMedia (@mimeType) att.typed (@type, @subtype) att.declaring (@decls) att.cReferencing (@cRef)
Member of	model.ptrLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: application authority catDesc change classCode correspContext creation distributor edition extent funder geoDecl handNote language licence principal publicationStmt rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg listRef valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.global.attributes, att.pointing.attributes, att.internetMedia.attributes, att.typed.attributes, att.declaring.attributes, att.cReferencing.attributes, macro.paraContent }

1.276. <refState>

<refState> (reference state) specifies one component of a canonical reference defined by the milestone method. [2.3.6.3. Milestone Method 2.3.6. The Reference System Declaration]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.milestoneUnit (@unit) att.edition (@ed, @edRef)

length

specifies the fixed length of the reference component.

Status

Optional

Datatype

teidata.count

Note

When constructing a reference, if the reference component found is of numeric type, the length is made up by inserting leading zeros; if it is not, by inserting trailing blanks. In either case, reference components are truncated if necessary at the right hand side.

When seeking a reference, the length indicates the number of characters which should be compared. Values longer than this will be regarded as matching, if they start correctly. If no value is provided, the length is unlimited and goes to the next delimiter or to the end of the value.

delim

(delimiter) supplies a delimiting string following the reference component.

Status	Optional
Datatype	teidata.text

Contained by

header: refsDecl

May contain

Empty element

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element refState
{
   att.global.attributes,
   att.milestoneUnit.attributes,
   att.edition.attributes,
   attribute length { text }?,
   attribute delim { text }?,
   empty
}

1.277. <refsDecl>

<refsDecl> (references declaration) specifies how canonical references are constructed for this text. [2.3.6.3. Milestone Method 2.3. The Encoding Description 2.3.6. The Reference System Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	core: p header: cRefPattern refState linking: ab
Example	<refsDecl> <cRefPattern matchPattern="([A-Za-z0-9]+) ([0-9]+):([0-9]+)" replacementPattern="#xpath(//body/div[@n='$1']/div[$2]/div3[$3])"/> </refsDecl> This example is a formal representation for the referencing scheme described informally in the following example.
Example	<refsDecl> <p>References are made up by concatenating the value for the <att>n</att> attribute on the highest level <gi>div</gi> element, followed by a space, followed by the sequential number of the next level <gi>div</gi> followed by a colon followed by the sequential number of the next (and lowest) level <gi>div</gi>.</p> </refsDecl>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <elementRef key="cRefPattern" minOccurs="1" maxOccurs="unbounded"/> <elementRef key="refState" minOccurs="1" maxOccurs="unbounded"/> </alternate> </content>
Schema Declaration	element refsDecl { att.global.attributes, att.declarable.attributes, ( model.pLike+ \| cRefPattern+ \| refState+ ) }

1.278. <reg>

<reg> (regularization) contains a reading which has been regularized or normalized in some sense. [3.4.2. Regularization and Normalization 12. Critical Apparatus]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.typed (@type, @subtype)
Member of	model.choicePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope choice date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	If all that is desired is to call attention to the fact that the copy text has been regularized, <reg> may be used alone: <q>Please <reg>knock</reg> if an <reg>answer</reg> is <reg>required</reg> </q>
Example	It is also possible to identify the individual responsible for the regularization, and, using the <choice> and <orig> elements, to provide both the original and regularized readings: <q>Please <choice> <reg resp="#LB">knock</reg> <orig>cnk</orig> </choice> if an <choice> <reg>answer</reg> <orig>nsr</orig> </choice> is <choice> <reg>required</reg> <orig>reqd</orig> </choice> </q>
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element reg { att.global.attributes, att.editLike.attributes, att.typed.attributes, macro.paraContent }

1.279. <region>

<region> contains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country. [13.2.3. Place Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.placeNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef linking: ab seg msdescription: accMat acquisition additions altIdentifier catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<placeName> <region type="state" n="IL">Illinois</region> </placeName>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element region { att.global.attributes, att.naming.attributes, att.typed.attributes, att.datable.attributes, macro.phraseSeq }

1.280. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.canonical (@key, @ref) att.sortable (@sortKey) att.typed (@type, @subtype)

name

supplies a name for the kind of relationship of which this is an instance.

Status	Optional
Datatype	teidata.enumerated

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

supplies a list of participants amongst all of whom the relationship holds equally.

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

passive

identifies the ‘passive’ participants in a non-mutual relationship.

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

Contained by

core: listBibl

namesdates: listEvent listNym listObject listOrg listPerson listPlace 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

This indicates that the person with identifier p1 is supervisor of persons p2, p3, and p4.

Example

This indicates that p2, p3, and p4 are all friends.

Example

This indicates that there is a relation, defined by CIDOC CRM, between two resources identified by URLs.

Example

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.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.canonical.attributes,
   att.sortable.attributes,
   att.typed.attributes,
   attribute name { text }?,
   ( attribute active { list { + } }? | attribute mutual { list { + } }? ),
   attribute passive { list { + } }?,
   desc?
}

1.281. <remarks>

<remarks> contains any commentary or discussion about the usage of an element, attribute, class, or entity not otherwise documented within the containing element. [22.5. Element Specifications 22.5.3. Attribute List Specification 22.6. Class Specifications 22.7. Macro Specifications]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.translatable (@versionDate)
Contained by	tagdocs: attDef classSpec dataSpec elementSpec macroSpec moduleSpec valItem
May contain	core: p linking: ab
Note	Contains at least one paragraph, unless it is empty. As defined in ODD, must contain paragraphs; should be special.para
Example	<remarks> <p>This element is probably redundant.</p> </remarks>
Content model	<content> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element remarks { att.global.attributes, att.translatable.attributes, model.pLike+ }

1.282. <rendition>

<rendition> supplies information about the rendition or appearance of one or more elements in the source text. [2.3.4. The Tagging Declaration]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.styleDef (@scheme, @schemeVersion)

scope

where CSS is used, provides a way of defining ‘pseudo-elements’, that is, styling rules applicable to specific sub-portions of an element.

Status	Optional
Datatype	teidata.enumerated
Sample values include:	first-line styling applies to the first line of the target element first-letter styling applies to the first letter of the target element before styling should be applied immediately before the content of the target element after styling should be applied immediately after the content of the target element

selector

contains a selector or series of selectors specifying the elements to which the contained style description applies, expressed in the language specified in the scheme attribute.

Status	Optional
Datatype	teidata.text
<rendition scheme="css" selector="text, front, back, body, div, p, ab"> display: block; </rendition>
<rendition scheme="css" selector="[rend=italic]"> font-style: italic; </rendition>
Note	Since the default value of the scheme attribute is assumed to be CSS, the default expectation for this attribute, in the absence of scheme, is that CSS selector syntax will be used.
Note	While rendition is used to point from an element in the transcribed source to a <rendition> element in the header which describes how it appears, the selector attribute allows the encoder to point in the other direction: from a <rendition> in the header to a collection of elements which all share the same renditional features. In both cases, the intention is to record the appearance of the source text, not to prescribe any particular output rendering.

Contained by

header: tagsDecl

May contain

core: address bibl choice date desc email hi listBibl name q quote ref time title

header: biblFull idno

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specGrp specGrpRef tag val

textcrit: listApp listWit

transcr: am ex subst

character data

Example

<tagsDecl> <rendition xml:id="r-center" scheme="css">text-align: center;</rendition> <rendition xml:id="r-small" scheme="css">font-size: small;</rendition> <rendition xml:id="r-large" scheme="css">font-size: large;</rendition> <rendition xml:id="initcaps" scope="first-letter" scheme="css">font-size: xx-large</rendition> </tagsDecl>

Content model

<content>
 <macroRef key="macro.limitedContent"/>
</content>

Schema Declaration

element rendition
{
   att.global.attributes,
   att.styleDef.attributes,
   attribute scope { text }?,
   attribute selector { text }?,
   macro.limitedContent
}

1.283. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref))
Contained by	msdescription: altIdentifier msIdentifier namesdates: objectIdentifier
May contain	gaiji: g 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.xtext"/> </content>
Schema Declaration	element repository { att.global.attributes, att.naming.attributes, macro.xtext }

1.284. <residence>

<residence> describes a person's present or past places of residence. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	primary secondary temporary permanent

Member of

model.certLike model.global.meta

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<residence>Childhood in East Africa and long term resident of Glasgow, Scotland.</residence>

Example

<residence notAfter="1997">Mbeni estate, Dzukumura region, Matabele land</residence> <residence notBefore="1903" notAfter="1996"> <placeName> <settlement>Glasgow</settlement> <region>Scotland</region> </placeName> </residence>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element residence
{
   att.global.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   macro.phraseSeq
}

1.285. <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.11.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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Contained by	core: respStmt
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: address choice date email gap hi lb milestone name note pb ref time title header: idno linking: alt altGrp anchor join joinGrp link linkGrp timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val textcrit: app witDetail transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin 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.attributes, att.canonical.attributes, att.datable.attributes, macro.phraseSeq.limited }

1.286. <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.11.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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.respLike
Contained by	core: bibl header: editionStmt seriesStmt titleStmt msdescription: msItem msItemStruct
May contain	core: name note resp namesdates: orgName persName
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> <sequence> <alternate> <sequence> <elementRef key="resp" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.nameLike.agent" minOccurs="1" maxOccurs="unbounded"/> </sequence> <sequence> <classRef key="model.nameLike.agent" minOccurs="1" maxOccurs="unbounded"/> <elementRef key="resp" minOccurs="1" maxOccurs="unbounded"/> </sequence> </alternate> <elementRef key="note" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element respStmt { att.global.attributes, att.canonical.attributes, ( ( ( resp+, model.nameLike.agent+ ) \| ( model.nameLike.agent+, resp+ ) ), note* ) }

1.287. <respons>

<respons> (responsibility) identifies the individual(s) responsible for some aspect of the content or markup of particular element(s). [21.3. Attribution of Responsibility]

Module

certainty

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.scoping (@target, @match)

locus

indicates the specific aspect of the encoding (markup or content) for which responsibility is being assigned.

Status	Required
Datatype	1–∞ occurrences of teidata.enumerated separated by whitespace
Legal values are:	name responsibility is being assigned concerning the name of the element or attribute used. start responsibility is being assigned concerning the start of the element concerned. end responsibility is being assigned concerning the end of the element concerned. location responsibility is being assigned concerning the location of the element concerned. value responsibility is being assigned concerning the content (for an element) or the value (for an attribute)

Member of

Contained by

analysis: cl interp m phr s span w

certainty: certainty precision respons

core: add address author bibl biblScope date del editor email gap head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab join seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc space substJoin supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

certainty: certainty precision respons

core: desc

Note

The <respons> element is designed for cases in which fine-grained information about specific aspects of the markup of a text is desirable for whatever reason. Global responsibility for certain aspects of markup is usually more simply indicated in the TEI header, using the <respStmt> element within the title statement, edition statement, or change log.

Example

Example

In this (partially fictional) example the entire document was transcribed and encoded by a single encoder, except for one passage which was transcribed and encoded by the proofreader.

<respStmt xml:id="enc01"> <name>C. Colin Backslash</name> <resp>transcription</resp> <resp>encoding</resp> </respStmt> <respStmt xml:id="prf01"> <name>Erin Spelling</name> <resp>proofreading</resp> </respStmt>  Θερινὴ τροπή <lb/> <foreign xml:lang="heb" xml:id="mp0a8"> ת <supplied reason="undefined">קו</supplied> <unclear>פ</unclear> ת תמוז </foreign>  <respons target="#mp0a8" locus="name value" resp="#prf01"/>

Example

In this (partially fictional) example an initial encoder (‘across.dta’) encoded most of the document; a later encoder (‘rcapolung.ewo’) encoded a particular passage; and a third encoder (‘sbauman.emt’) fixed some of that encoding.

<respStmt xml:id="enc03"> <persName ref="../contextual/persons.xml#across.dta"/> <resp>encoding</resp> </respStmt>  <spGrp rend="braced(atonce1)" xml:id="sgrp05"> <sp who="#mo"> <speaker rend="align(left)slant(italic)"> <persName>Mor</persName>.</speaker> So, so, so! </sp> <sp who="#hg"> <speaker rend="align(left)slant(italic)"> <persName>Mr. H</persName>.</speaker> What, without my Leave! </sp> <sp who="#la"> <speaker rend="align(left)slant(italic)"> <persName>Lady D</persName>.</speaker> Amazing! </sp> </spGrp> <stage rend="align(right)slant(italic)" type="delivery" xml:id="atonce1">All together.</stage>  <respons target="sgrp05" locus="name" resp="../contextual/persons.xml#rcapolung.ewo"> <desc>Ashley did not know what to do with this; I have decided it best fits as a braced <gi>spGrp</gi> </desc> </respons> <respons target="sgrp05" match=".//@rend" locus="value" resp="../contextual/persons.xml#sbauman.emt"> <desc>fixed <att>rend</att> attributes</desc> </respons>

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>

Schema Declaration

element respons
{
   att.global.attributes,
   att.scoping.attributes,
   attribute locus
   {
      list { ( "name" | "start" | "end" | "location" | "value" )+ }
   },
   ( model.descLike | model.certLike )*
}

1.288. <restore>

<restore> indicates restoration of text to an earlier state by cancellation of an editorial or authorial marking or instruction. [11.3.1.6. Cancellation of Deletions and Other Markings]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.linePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	On this element, the type attribute categorizes the way that the cancelled intervention has been indicated in some way, for example by means of a marginal note, over-inking, additional markup, etc.
Example	For I hate this <restore hand="#dhl" type="marginalStetNote"> <del>my</del> </restore> body
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element restore { att.global.attributes, att.transcriptional.attributes, att.typed.attributes, att.dimensions.attributes, macro.paraContent }

1.289. <retrace>

<retrace> contains a sequence of writing which has been retraced, for example by over-inking, to clarify or fix it. [11.3.4.3. Fixation and Clarification]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.spanning (@spanTo) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.linePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	Multiple retraces are indicated by nesting one <retrace> within another. In principle, a retrace differs from a substitution in that second and subsequent rewrites do not materially alter the content of an element. Where minor changes have been made during the retracing action however these may be marked up using <del>, <add>, etc. with an appropriate value for the change attribute.
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element retrace { att.global.attributes, att.spanning.attributes, att.transcriptional.attributes, att.dimensions.attributes, macro.paraContent }

1.290. <revisionDesc>

<revisionDesc> (revision description) summarizes the revision history for a file. [2.6. The Revision Description 2.1.1. The TEI Header and Its Components]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.docStatus (@status)
Contained by	header: teiHeader
May contain	header: change list listChange
Note	If present on this element, the status attribute should indicate the current status of the document. The same attribute may appear on any <change> to record the status at the time of that change. Conventionally <change> elements should be given in reverse date order, with the most recent change at the start of the list.
Example	<revisionDesc status="embargoed"> <change when="1991-11-11" who="#LB"> deleted chapter 10 </change> </revisionDesc>
Content model	<content> <alternate> <elementRef key="list"/> <elementRef key="listChange"/> <elementRef key="change" minOccurs="1" maxOccurs="unbounded"/> </alternate> </content>
Schema Declaration	element revisionDesc { att.global.attributes, att.docStatus.attributes, ( list \| listChange \| change+ ) }

1.291. <rhyme>

<rhyme> marks the rhyming part of a metrical line. [6.5. Rhyme]

Module

verse

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)

label

provides a label (usually a single letter) to identify which part of a rhyme scheme this rhyming string instantiates.

Status	Recommended
Datatype	teidata.word
Note	Within a particular scope, all <rhyme> elements with the same value for their label attribute are assumed to rhyme with each other. The scope is defined by the nearest ancestor element for which the rhyme attribute has been supplied.

Member of

model.lPart

Contained by

analysis: cl phr s w

core: add author biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<lg rhyme="abababcc"> <l>'Tis pity learned virgins ever <rhyme label="a">wed</rhyme> </l> <l>With persons of no sort of edu<rhyme label="b">cation</rhyme>,</l> <l>Or gentlemen, who, though well born and <rhyme label="a">bred</rhyme>,</l> <l>Grow tired of scientific conver<rhyme label="b">sation</rhyme>:</l> <l>I don't choose to say much on this <rhyme label="a">head</rhyme>,</l> <l>I'm a plain man, and in a single <rhyme label="b">station</rhyme>,</l> <l>But — Oh! ye lords of ladies inte<rhyme label="c">llectual</rhyme>,</l> <l>Inform us truly, have they not hen-<rhyme label="c">peck'd you all</rhyme>?</l> </lg>

Example

<lg> <l>Tyger! Tyger! burning <rhyme label="a">bright</rhyme> </l> <l>In the forests of the <rhyme label="a">night</rhyme>,</l> <l>What immortal hand or <rhyme label="b">eye</rhyme> </l> <l>Could frame thy fearful <rhyme label="b" type="eye-rhyme">symmetry</rhyme>?</l> </lg>

Example

<lg> <l>"Hark! Lakshman! Hark, again that <rhyme label="a">cry</rhyme>!</l> <l>It is, -- it is my husband's <rhyme label="b">voice</rhyme>!</l> <l>hasten, to his succour <rhyme label="a">fly</rhyme>,</l> <l>No more hast thou, dear friend, a <rhyme label="b">choice</rhyme>.</l> <l>He calls on thee, perhaps his <rhyme label="c">foes</rhyme> </l> <l>Environ him on all sides <rhyme label="d">round</rhyme>,</l> <l>That wail, -- it means death's final <rhyme label="c">throes</rhyme>!</l> <l>Why standest thou, as magic-<rhyme label="d">bound</rhyme>?</l> </lg>

Content model

<content>
 <macroRef key="macro.paraContent"/>
</content>

Schema Declaration

element rhyme
{
   att.global.attributes,
   att.typed.attributes,
   attribute label { text }?,
   macro.paraContent
}

1.292. <roleName>

<roleName> contains a name component which indicates that the referent has a particular role or position in society, such as an official title or rank. [13.2.1. Personal Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Member of	model.persNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	A <roleName> may be distinguished from an <addName> by virtue of the fact that, like a title, it typically exists independently of its holder.
Example	<persName> <forename>William</forename> <surname>Poulteny</surname> <roleName>Earl of Bath</roleName> </persName>
Example	<p>The <roleName role="#solicitor_general">S.G.</roleName> is the only national public official, including the Supreme Court justices, required by statute to be “learned in the law.”</p>
Example	<p> <persName ref="#NJF"> <roleName role="#solicitor_general">Solicitor General</roleName> Noel J. Francisco</persName>, representing the administration, asserted in rebuttal that there was nothing to disavow (...) <persName ref="#NJF">Francisco</persName> had violated the scrupulous standard of candor about the facts and the law that <roleName role="#solicitor_general">S.G.s</roleName>, in Republican and Democratic administrations alike, have repeatedly said they must honor. </p>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element roleName { att.global.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq }

1.293. <rubric>

<rubric> contains the text of any rubric or heading attached to a particular manuscript item, that is, a string of words through which a manuscript or other object signals the beginning of a text division, often with an assertion as to its author and title, which is in some way set off from the text itself, typically in red ink, or by use of different size or type of script, or some other such visual device. [10.6.1. The msItem and msItemStruct Elements]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.msExcerpt (@defective)
Member of	model.msQuoteLike
Contained by	msdescription: msItem msItemStruct
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<rubric>Nu koma Skyckiu Rym<ex>ur</ex>.</rubric> <rubric>Incipit liber de consciencia humana a beatissimo Bernardo editus.</rubric> <rubric> <locus>16. f. 28v in margin: </locus>Dicta Cassiodori </rubric>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element rubric { att.global.attributes, att.typed.attributes, att.msExcerpt.attributes, macro.phraseSeq }

1.294. <s>

<s> (s-unit) contains a sentence-like division of a text. [17.1. Linguistic Segment Categories 8.4.1. Segmentation]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation)
Member of	model.segLike
Contained by	analysis: cl phr s core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The <s> element may be used to mark orthographic sentences, or any other segmentation of a text, provided that the segmentation is end-to-end, complete, and non-nesting. For segmentation which is partial or recursive, the <seg> should be used instead. The type attribute may be used to indicate the type of segmentation intended, according to any convenient typology.
Example	<head> <s>A short affair</s> </head> <s>When are you leaving?</s> <s>Tomorrow.</s>
Schematron	<s:report test="tei:s">You may not nest one s element within another: use seg instead</s:report>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element s { att.global.attributes, att.segLike.attributes, att.typed.attributes, att.notated.attributes, macro.phraseSeq }

1.295. <samplingDecl>

<samplingDecl> (sampling declaration) contains a prose description of the rationale and methods used in sampling texts in the creation of a corpus or collection. [2.3.2. The Sampling Declaration 2.3. The Encoding Description 15.3.2. Declarable Elements]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	core: p linking: ab
Note	This element records all information about systematic inclusion or omission of portions of the text, whether a reflection of sampling procedures in the pure sense or of systematic omission of material deemed either too difficult to transcribe or not of sufficient interest.
Example	<samplingDecl> <p>Samples of up to 2000 words taken at random from the beginning, middle, or end of each text identified as relevant by respondents.</p> </samplingDecl>
Content model	<content> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element samplingDecl { att.global.attributes, att.declarable.attributes, model.pLike+ }

1.296. <schemaRef>

<schemaRef> (schema reference) describes or points to a related customization or schema file [2.3.10. The Schema Specification]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.resourced (@url)

key

the identifier used for the customization or schema

Status	Optional
Datatype	teidata.xmlName

Member of

model.divPart model.encodingDescPart

Contained by

header: encodingDesc

May contain

core: desc

Example

Content model

<content>
 <classRef key="model.descLike"
  minOccurs="0"/>
</content>

Schema Declaration

element schemaRef
{
   att.global.attributes,
   att.typed.attributes,
   att.resourced.attributes,
   attribute key { text }?,
   model.descLike?
}

1.297. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.identified (@ident, @predeclare, @module) (att.combinable (@mode) (att.deprecated (@validUntil)) ) att.namespaceable (@ns) att.docStatus (@status)

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

prefix

specifies a default prefix which will be prepended to all patterns relating to TEI elements, unless otherwise stated.

Status	Optional
Datatype	0–1 occurrences of teidata.xmlName separated by whitespace
Note	Use of this attribute allows an external schema which has an element with the same local name as a TEI element to be mixed in.

targetLang

(target language) specifies which language to use when creating the objects in a schema if names for elements or attributes are available in more than one language

Status	Optional
Datatype	teidata.language

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

defaultExceptions

(default namespace exclusions) provides a list of namespaces and/or prefixed element names to be excluded by default from anyName in RELAX NG schemas

Status	Recommended
Datatype	1–∞ occurrences of teidata.namespaceOrName separated by whitespace
Default	http://www.tei-c.org/ns/1.0 teix:egXML
Note	Specifies defaults for the except attribute of <anyElement>. RELAX NG validation (unless DTD Compatibility Mode is turned off) requires that any elements which may take an xml:id be excluded from the content of anyName name classes. For normal TEI purposes, this includes anything in the TEI namespace and the <egXML> element. The defaultExceptions attribute sets the global defaults for these exclusions. Element prefixes must be declared using a namespace declaration on the parent or an ancestor element.

Member of

Contained by

core: note q quote

header: change encodingDesc handNote licence scriptNote

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: specGrp

textcrit: lem rdg

textstructure: body div

transcr: metamark

May contain

core: desc

tagdocs: altIdent classRef classSpec constraintSpec dataRef dataSpec elementRef elementSpec equiv listRef macroRef macroSpec moduleRef moduleSpec outputRendition specGrp specGrpRef

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 contains or references. Different ODD processors may generate schemas and documentation using different concrete syntaxes.

The source may be specified in the form of a private URI, for which the form recommended 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 context 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

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

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>
  <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"/>
  </alternate>
 </sequence>
</content>

Schema Declaration

element schemaSpec
{
   att.global.attributes,
   att.identified.attributes,
   att.namespaceable.attributes,
   att.docStatus.attributes,
   attribute start { list { + } }?,
   attribute prefix { text }?,
   attribute targetLang { text }?,
   attribute docLang { list { + } }?,
   attribute defaultExceptions { list { + } }?,
   ( ( model.glossLike | model.descLike )*, ( model.oddRef | model.oddDecl )* )
}

1.298. <scriptDesc>

<scriptDesc> contains a description of the scripts used in a manuscript or other object. [10.7.2.1. Writing]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.physDescPart
Contained by	msdescription: physDesc
May contain	core: p header: scriptNote linking: ab msdescription: summary
Example	<scriptDesc> <p/> </scriptDesc>
Example	<scriptDesc> <summary>Contains two distinct styles of scripts </summary> <scriptNote xml:id="style-1">.</scriptNote> <scriptNote xml:id="style-2">.</scriptNote> </scriptDesc>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <elementRef key="scriptNote" minOccurs="1" maxOccurs="unbounded"/> </sequence> </alternate> </content>
Schema Declaration	element scriptDesc { att.global.attributes, ( model.pLike+ \| ( summary?, scriptNote+ ) ) }

1.299. <scriptNote>

<scriptNote> describes a particular script distinguished within the description of a manuscript or similar resource. [10.7.2. Writing, Decoration, and Other Notations]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.handFeatures (@scribe, @scribeRef, @script, @scriptRef, @medium, @scope)
Contained by	msdescription: scriptDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<scriptNote scope="sole"/>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element scriptNote { att.global.attributes, att.handFeatures.attributes, macro.specialPara }

1.300. <seal>

<seal> contains a description of one seal or similar applied to the object described [10.7.3.2. Seals]

Module

msdescription

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))

contemporary

specifies whether or not the seal is contemporary with the item to which it is affixed

Status	Optional
Datatype	teidata.xTruthValue

Contained by

msdescription: sealDesc

May contain

core: p

linking: ab

msdescription: decoNote

Example

<seal n="2" type="pendant" subtype="cauda_duplex"> The seal of <name>Jens Olufsen</name> in black wax. (<ref>DAS 1061</ref>). Legend: <q>S IOHANNES OLAVI</q>. Parchment tag on which is written: <q>Woldorp Iohanne G</q>. </seal>

Content model

<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <classRef key="model.pLike"/>
  <elementRef key="decoNote"/>
 </alternate>
</content>

Schema Declaration

element seal
{
   att.global.attributes,
   att.typed.attributes,
   att.datable.attributes,
   attribute contemporary { text }?,
   ( model.pLike | decoNote )+
}

1.301. <sealDesc>

<sealDesc> (seal description) describes the seals or similar items related to the object described, either as a series of paragraphs or as a series of <seal> elements. [10.7.3.2. Seals]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.physDescPart
Contained by	msdescription: physDesc
May contain	core: p linking: ab msdescription: condition decoNote seal summary
Example	<sealDesc> <seal type="pendant" contemporary="true"> <p>Green wax vertical oval seal attached at base.</p> </seal> </sealDesc>
Example	<sealDesc> <p>Parchment strip for seal in place; seal missing.</p> </sealDesc>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="decoNote"/> <elementRef key="seal"/> <elementRef key="condition"/> </alternate> </sequence> </alternate> </content>
Schema Declaration	element sealDesc { att.global.attributes, ( model.pLike+ \| ( summary?, ( decoNote \| seal \| condition )+ ) ) }

1.302. <secFol>

<secFol> (second folio) marks the word or words taken from a fixed point in a codex (typically the beginning of the second leaf) in order to provide a unique identifier for it. [10.3.7. Catchwords, Signatures, Secundo Folio]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<secFol>(con-)versio morum</secFol>
Schematron	<sch:assert test="ancestor::tei:msDesc or ancestor::tei:egXML">The <sch:name/> element should not be used outside of msDesc.</sch:assert>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element secFol { att.global.attributes, macro.phraseSeq }

1.303. <secl>

<secl> (secluded text) Secluded. Marks text present in the source which the editor believes to be genuine but out of its original place (which is unknown). [11.3.1.7. Text Omitted from or Supplied in the Transcription]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

reason

one or more words indicating why this text has been secluded, e.g. interpolated etc.

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace

Member of

model.pPart.transcriptional

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

<rdg source="#Pescani"> <secl> <l n="15" xml:id="l15">Alphesiboea suos ulta est pro coniuge fratres,</l> <l n="16" xml:id="l16">sanguinis et cari vincula rupit amor.</l> </secl> </rdg> <note>secl. Pescani</note>

Content model

<content>
 <macroRef key="macro.paraContent"/>
</content>

Schema Declaration

element secl
{
   att.global.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   attribute reason { list { + } }?,
   macro.paraContent
}

1.304. <seg>

<seg> (arbitrary segment) represents any segmentation of text below the ‘chunk’ level. [16.3. Blocks, Segments, and Anchors 6.2. Components of the Verse Line 7.2.5. Speech Contents]
Module	linking
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.written (@hand) att.notated (@notation)
Member of	model.choicePart model.linePart model.segLike
Contained by	analysis: cl m phr s w core: add author bibl biblScope choice date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	The <seg> element may be used at the encoder's discretion to mark any segments of the text of interest for processing. One use of the element is to mark text features for which no appropriate markup is otherwise defined. Another use is to provide an identifier for some segment which is to be pointed at by some other element—i.e. to provide a target, or a part of a target, for a <ptr> or other similar element.
Example	<seg>When are you leaving?</seg> <seg>Tomorrow.</seg>
Example	<s> <seg rend="caps" type="initial-cap">So father's only</seg> glory was the ballfield. </s>
Example	<seg type="preamble"> <seg>Sigmund, <seg type="patronym">the son of Volsung</seg>, was a king in Frankish country.</seg> <seg>Sinfiotli was the eldest of his sons ...</seg> <seg>Borghild, Sigmund's wife, had a brother ... </seg> </seg>
Content model	<content> <macroRef key="macro.paraContent"/> </content>
Schema Declaration	element seg { att.global.attributes, att.segLike.attributes, att.typed.attributes, att.written.attributes, att.notated.attributes, macro.paraContent }

1.305. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.editorialDeclPart
Contained by	header: editorialDecl
May contain	core: p linking: ab
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.attributes, att.declarable.attributes, model.pLike+ }

1.306. <sequence>

<sequence> indicates that the constructs referenced by its children form a sequence [22.5.1. Defining Content Models]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.repeatable (@minOccurs, @maxOccurs)

preserveOrder

if true, indicates that the order in which component elements of a sequence appear in a document must correspond to the order in which they are given in the content model.

Status	Optional
Datatype	teidata.truthValue

Member of

model.contentPart

Contained by

tagdocs: alternate content sequence

May contain

tagdocs: alternate anyElement classRef dataRef elementRef empty macroRef sequence textNode valList

Example

This example content model matches a sequence consisting of either a <name> or a <persName> followed by nothing, or by a sequence of up to five <placeName> elements.

Schematron

<sch:assert test="count(*)>1">The sequence element must have at least two child elements</sch:assert>

Content model

<content>
 <classRef key="model.contentPart"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element sequence
{
   att.global.attributes,
   att.repeatable.attributes,
   attribute preserveOrder { text }?,
   model.contentPart+
}

1.307. <seriesStmt>

<seriesStmt> (series statement) groups information about the series, if any, to which a publication belongs. [2.2.5. The Series Statement 2.2. The File Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: biblFull fileDesc
May contain	core: biblScope editor p respStmt title header: idno linking: ab
Example	<seriesStmt> <title>Machine-Readable Texts for the Study of Indian Literature</title> <respStmt> <resp>ed. by</resp> <name>Jan Gonda</name> </respStmt> <biblScope unit="volume">1.2</biblScope> <idno type="ISSN">0 345 6789</idno> </seriesStmt>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="title" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="editor"/> <elementRef key="respStmt"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="idno"/> <elementRef key="biblScope"/> </alternate> </sequence> </alternate> </content>
Schema Declaration	element seriesStmt { att.global.attributes, ( model.pLike+ \| ( title+, ( editor \| respStmt ), ( idno \| biblScope ) ) ) }

1.308. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.placeNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage unitDef linking: ab seg msdescription: accMat acquisition additions altIdentifier catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msIdentifier musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.naming.attributes, att.typed.attributes, att.datable.attributes, macro.phraseSeq }

1.309. <sex>

<sex> specifies the sex of a person. [13.3.2.1. Personal Characteristics]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.typed (type, @subtype)

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:	explicit implicit

value

supplies a coded value for sex

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

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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

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.attributes,
   att.editLike.attributes,
   att.datable.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   attribute value { list { + } }?,
   macro.phraseSeq
}

1.310. <sic>

<sic> (Latin for thus or so) contains text reproduced although apparently incorrect or inaccurate. [3.4.1. Apparent Errors]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.choicePart model.pPart.transcriptional
Contained by	analysis: cl pc phr s w core: add author bibl biblScope choice date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: am damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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 }

1.311. <signatures>

<signatures> contains discussion of the leaf or quire signatures found within a codex or similar object. [10.3.7. Catchwords, Signatures, Secundo Folio]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<signatures>Quire and leaf signatures in letters, [b]-v, and roman numerals; those in quires 10 (1) and 17 (s) in red ink and different from others; every third quire also signed with red crayon in arabic numerals in the center lower margin of the first leaf recto: "2" for quire 4 (f. 19), "3" for quire 7 (f. 43); "4," barely visible, for quire 10 (f. 65), "5," in a later hand, for quire 13 (f. 89), "6," in a later hand, for quire 16 (f. 113).</signatures>
Schematron	<sch:assert test="ancestor::tei:msDesc or ancestor::tei:egXML">The <sch:name/> element should not be used outside of msDesc.</sch:assert>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element signatures { att.global.attributes, macro.specialPara }

1.312. <socecStatus>

<socecStatus> (socio-economic status) contains an informal description of a person's perceived social or economic status. [15.2.2. The Participant Description]

Module

namesdates

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)

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:	atBirth atDeath dependent inherited independent

scheme

identifies the classification system or taxonomy in use, for example by pointing to a locally-defined <taxonomy> element or by supplying a URI for an externally-defined system.

Status	Optional
Datatype	teidata.pointer

code

identifies a status code defined within the classification system or taxonomy defined by the scheme attribute.

Status	Optional
Datatype	teidata.pointer

Member of

Contained by

namesdates: person personGrp persona

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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

Example

<socecStatus>Status AB1 in the RG Classification scheme</socecStatus>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element socecStatus
{
   att.global.attributes,
   att.datable.attributes,
   att.editLike.attributes,
   att.naming.attributes,
   att.typed.attribute.subtype,
   attribute type { text }?,
   attribute scheme { text }?,
   attribute code { text }?,
   macro.phraseSeq
}

1.313. <source>

<source> describes the original source for the information contained with a manuscript or object description. [10.9.1.1. Record History]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: recordHist
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<source>Derived from <ref>Stanley (1960)</ref> </source>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element source { att.global.attributes, macro.specialPara }

1.314. <sourceDesc>

<sourceDesc> (source description) describes the source from which an electronic text was derived or generated, typically a bibliographic description in the case of a digitized text, or a phrase such as "born digital" for a text which has no previous existence. [2.2.7. The Source Description]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Contained by	header: biblFull fileDesc
May contain	core: bibl listBibl p header: biblFull linking: ab msdescription: msDesc namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation textcrit: listApp listWit
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> <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.attributes, att.declarable.attributes, ( model.pLike+ \| ( model.biblLike \| model.sourceDescPart \| model.listLike )+ ) }

1.315. <sourceDoc>

<sourceDoc> contains a transcription or other representation of a single source document potentially forming part of a dossier génétique or collection of sources. [11.1. Digital Facsimiles 11.2.2. Embedded Transcription]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls)
Member of	model.resourceLike
Contained by	textstructure: TEI
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: gap lb milestone note pb linking: alt altGrp anchor join joinGrp link linkGrp timeline textcrit: app witDetail transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin surface surfaceGrp
Note	This element may be used as an alternative to <facsimile> for TEI documents containing only page images, or for documents containing both images and transcriptions. Transcriptions may be provided within the <surface> elements making up a source document, in parallel with them as part of a <text> element, or in both places if the encoder wishes to distinguish these two modes of transcription.
Example	<sourceDoc> <surfaceGrp n="leaf1"> <surface facs="page1.png"> <zone>All the writing on page 1</zone> </surface> <surface> <graphic url="page2-highRes.png"/> <graphic url="page2-lowRes.png"/> <zone> <line>A line of writing on page 2</line> <line>Another line of writing on page 2</line> </zone> </surface> </surfaceGrp> </sourceDoc>
Content model	<content> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.global"/> <classRef key="model.graphicLike"/> <elementRef key="surface"/> <elementRef key="surfaceGrp"/> </alternate> </content>
Schema Declaration	element sourceDoc { att.global.attributes, att.declaring.attributes, ( model.global \| model.graphicLike \| surface \| surfaceGrp )+ }

1.316. <space>

<space> indicates the location of a significant space in the text. [11.5.1. Space]

Module

transcr

Attributes

Attributes att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (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.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.analytic (@ana) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (resp, @cert) att.global.source (@source)

resp

(responsible party) (responsible party) indicates the individual responsible for identifying and measuring the space

Derived from	att.global.responsibility
Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

dim

(dimension) indicates whether the space is horizontal or vertical.

Status	Recommended
Datatype	teidata.enumerated
Legal values are:	horizontal the space is horizontal. vertical the space is vertical.
Note	For irregular shapes in two dimensions, the value for this attribute should reflect the more important of the two dimensions. In conventional left-right scripts, a space with both vertical and horizontal components should be classed as vertical.

Member of

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

certainty: certainty precision respons

core: desc

Note

This element should be used wherever it is desired to record an unusual space in the source text, e.g. space left for a word to be filled in later, for later rubrication, etc. It is not intended to be used to mark normal inter-word space or the like.

Example

By god if wommen had writen storyes As <space quantity="7" unit="minims"/> han within her oratoryes

Example

στρατηλάτ<space quantity="1" unit="chars"/>ου

Content model

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>

Schema Declaration

element space
{
   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.linking.attribute.corresp,
   att.global.linking.attribute.synch,
   att.global.linking.attribute.sameAs,
   att.global.linking.attribute.copyOf,
   att.global.linking.attribute.next,
   att.global.linking.attribute.prev,
   att.global.linking.attribute.exclude,
   att.global.linking.attribute.select,
   att.global.analytic.attribute.ana,
   att.global.facs.attribute.facs,
   att.global.change.attribute.change,
   att.global.responsibility.attribute.cert,
   att.global.source.attribute.source,
   att.typed.attributes,
   att.dimensions.attributes,
   attribute resp { list { + } }?,
   attribute dim { "horizontal" | "vertical" }?,
   ( model.descLike | model.certLike )*
}

1.317.

associates an interpretative annotation directly with a span of text. [17.3. Spans and Interpretations]

Module

analysis

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.interpLike (@type, @inst) att.pointing (@targetLang, @target, @evaluate)

from

gives the identifier of the node which is the starting point of the span of text being annotated; if not accompanied by a to attribute, gives the identifier of the node of the entire span of text being annotated.

Status	Optional
Datatype	teidata.pointer

to

gives the identifier of the node which is the end-point of the span of text being annotated.

Status	Optional
Datatype	teidata.pointer

Member of

Contained by

analysis: cl m phr s span spanGrp w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: address choice date email gap hi lb milestone name note pb ref time title

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident tag val

textcrit: app witDetail

transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin

character data

Example

(The "aftermath" starts here) (The "aftermath" continues here) (The "aftermath" ends in this paragraph)  aftermath

Schematron

<s:report test="@from and @target">Only one of the attributes @target and @from may be supplied on <s:name/> </s:report>

Schematron

<s:report test="@to and @target">Only one of the attributes @target and @to may be supplied on <s:name/> </s:report>

Schematron

<s:report test="@to and not(@from)">If @to is supplied on <s:name/>, @from must be supplied as well</s:report>

Schematron

<s:report test="contains(normalize-space(@to),' ') or contains(normalize-space(@from),' ')">The attributes @to and @from on <s:name/> may each contain only a single value</s:report>

Content model

<content>
 <macroRef key="macro.phraseSeq.limited"/>
</content>

Schema Declaration

element span
{
   att.global.attributes,
   att.interpLike.attributes,
   att.pointing.attributes,
   attribute from { text }?,
   attribute to { text }?,
   macro.phraseSeq.limited
}

1.318. <spanGrp>

<spanGrp> (span group) collects together span tags. [17.3. Spans and Interpretations]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.interpLike (@type, @inst)
Member of	model.global.meta
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	analysis: span
Example	<u xml:id="UU1">Can I have ten oranges and a kilo of bananas please?</u> <u xml:id="UU2">Yes, anything else?</u> <u xml:id="UU3">No thanks.</u> <u xml:id="UU4">That'll be dollar forty.</u> <u xml:id="UU5">Two dollars</u> <u xml:id="UU6">Sixty, eighty, two dollars. <anchor xml:id="UU6e"/>Thank you.<anchor xml:id="UU6f"/> </u> <spanGrp type="transactions"> <span from="#UU1">sale request</span> <span from="#UU2" to="#UU3">sale compliance</span> <span from="#UU4">sale</span> <span from="#UU5" to="#UU6">purchase</span> <span from="#UU6e" to="#UU6f">purchase closure</span> </spanGrp>
Content model	<content> <elementRef key="span" minOccurs="0" maxOccurs="unbounded"/> </content>
Schema Declaration	element spanGrp { att.global.attributes, att.interpLike.attributes, span* }

1.319. <specDesc>

<specDesc> (specification description) indicates that a description of the specified element or class should be included at this point within a document. [22.1.2. Element and Attribute Descriptions]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

key

(identifier) supplies the identifier of the documentary element or class for which a description is to be obtained.

Status	Optional
Datatype	teidata.name
<specDesc key="emph"/>

atts

(attributes) supplies attribute names for which descriptions should additionally be obtained.

Status	Recommended
Datatype	0–∞ occurrences of teidata.name separated by whitespace
<specDesc key="foreign" atts="usage xml:lang"/>
Note	The attribute names listed may include both attributes inherited from a class and those defined explicitly for the associated element.

Member of

model.specDescLike

Contained by

analysis: cl phr s

core: add author biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg specList

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

Empty element

Note

The description is usually displayed as a label and an item. The list of attributes may include some which are inherited by virtue of an element's class membership; descriptions for such attributes may also be retrieved using another <specDesc>, this time pointing at the relevant class.

Example

Example

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element specDesc
{
   att.global.attributes,
   attribute key { text }?,
   attribute atts { list { * } }?,
   empty
}

1.320. <specGrp>

<specGrp> (specification group) contains any convenient grouping of specifications for use within the current module. [22.2. Modules and Schemas]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.oddDecl
Contained by	core: add del desc head hi l note p q quote ref reg sic title unclear header: change handNote licence rendition scriptNote tagUsage linking: ab seg msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote namesdates: occupation tagdocs: schemaSpec specGrp textcrit: lem rdg witness textstructure: body div transcr: damage metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	core: l lg p linking: ab tagdocs: classRef classSpec constraintSpec dataRef dataSpec elementRef elementSpec listRef macroRef macroSpec moduleRef moduleSpec outputRendition schemaSpec specGrp specGrpRef
Note	A specification group is referenced by means of its xml:id attribute. The declarations it contains may be included in a <schemaSpec> or <moduleSpec> element only by reference (using a <specGrpRef> element): it may not be nested within a <moduleSpec> element. Different ODD processors may generate representations of the specifications contained by a <specGrp> in different concrete syntaxes.
Example	<specGrp xml:id="xDAILC"> <elementSpec ident="s"> <!-- ... --> </elementSpec> <elementSpec ident="cl"> <!-- ... --> </elementSpec> <elementSpec ident="w"> <!-- ... --> </elementSpec> <elementSpec ident="m"> <!-- ... --> </elementSpec> <elementSpec ident="c"> <!-- ... --> </elementSpec> </specGrp> This specification group with identifier xDAILC contains specifications for the elements <s>,<cl>,<w>, etc.
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.oddDecl"/> <classRef key="model.oddRef"/> <classRef key="model.divPart"/> </alternate> </content>
Schema Declaration	element specGrp { att.global.attributes, ( model.oddDecl \| model.oddRef \| model.divPart )* }

1.321. <specGrpRef>

<specGrpRef> (reference to a specification group) indicates that the declarations contained by the <specGrp> referenced should be inserted at this point. [22.2. Modules and Schemas]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

target

points at the specification group which logically belongs here.

Status	Required
Datatype	teidata.pointer

Member of

model.choicePart model.pPart.transcriptional

Contained by

core: add del desc head hi l note p q quote ref reg sic title unclear

header: change handNote licence rendition scriptNote tagUsage

linking: ab seg

msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote

namesdates: occupation

tagdocs: schemaSpec specGrp

textcrit: lem rdg witness

textstructure: body div

transcr: damage metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

Empty element

Note

In ODD documentation processing, a <specGrpRef> usually produces a comment indicating that a set of declarations printed in another section will be inserted at this point in the <specGrp> being discussed. In schema processing, the contents of the specified <specGrp> are made available for inclusion in the generated schema.

The specification group identified by the target attribute will normally be part of the current ODD document.

Example

This part of the module contains declarations for names of persons, places, and organisations: <specGrpRef target="#names.pers"/> <specGrpRef target="#names.place"/> <specGrpRef target="#names.org"/>  <specGrp xml:id="names.pers">  </specGrp>  <specGrp xml:id="names.place">  </specGrp>  <specGrp xml:id="names.org">  </specGrp>

Content model

<content>
 <empty/>
</content>

Schema Declaration

element specGrpRef { att.global.attributes, attribute target { text }, empty }

1.322. <specList>

<specList> (specification list) marks where a list of descriptions is to be inserted into the prose documentation. [22.1.2. Element and Attribute Descriptions]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.specDescLike
Contained by	analysis: cl phr s core: add author biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: rhyme
May contain	tagdocs: specDesc
Example	<specList> <specDesc key="refState" atts="delim length"/> <specDesc key="div"/> </specList>
Content model	<content> <elementRef key="specDesc" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element specList { att.global.attributes, specDesc+ }

1.323. <sponsor>

<sponsor> specifies the name of a sponsoring organization or institution. [2.2.1. The Title Statement]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref)
Member of	model.respLike
Contained by	core: bibl header: editionStmt titleStmt msdescription: msItem
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: address choice date email gap hi lb milestone name note pb ref time title header: idno linking: alt altGrp anchor join joinGrp link linkGrp timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val textcrit: app witDetail transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data
Note	Sponsors give their intellectual authority to a project; they are to be distinguished from funders (see element <funder>), who provide the funding but do not necessarily take intellectual responsibility.
Example	<sponsor>Association for Computers and the Humanities</sponsor> <sponsor>Association for Computational Linguistics</sponsor> <sponsor ref="http://www.allc.org/">Association for Literary and Linguistic Computing</sponsor>
Content model	<content> <macroRef key="macro.phraseSeq.limited"/> </content>
Schema Declaration	element sponsor { att.global.attributes, att.canonical.attributes, macro.phraseSeq.limited }

1.324. <stamp>

<stamp> contains a word or phrase describing a stamp or similar device. [10.3.3. Watermarks and Stamps]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
Member of	model.pPart.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<rubric>Apologyticu TTVLLIANI AC IGNORATIA IN XPO IHV<lb/> SI NON LICET<lb/> NOBIS RO<lb/> manii imperii <stamp>Bodleian stamp</stamp> <lb/> </rubric>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element stamp { att.global.attributes, att.typed.attributes, att.datable.attributes, macro.phraseSeq }

1.325. <state>

<state> contains a description of some status or quality attributed to a person, place, or organization often at some specific time or for a specific date range. [13.3.1. Basic Principles 13.3.2.1. Personal Characteristics]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.typed (@type, @subtype) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.persStateLike model.placeStateLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName person personGrp persona place placeName region residence roleName settlement sex socecStatus state surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	certainty: precision core: bibl desc head listBibl note p header: biblFull linking: ab msdescription: msDesc namesdates: state
Note	Where there is confusion between <trait> and <state> the more general purpose element <state> should be used even for unchanging characteristics. If you wish to distinguish between characteristics that are generally perceived to be time-bound states and those assumed to be fixed traits, then <trait> is available for the more static of these. The <state> element encodes characteristics which are sometimes assumed to change, often at specific times or over a date range, whereas the <trait> elements are used to record characteristics, such as eye-colour, which are less subject to change. Traits are typically, but not necessarily, independent of the volition or action of the holder.
Example	<state ref="#SCHOL" type="status"> <label>scholar</label> </state>
Example	<org> <orgName notAfter="1960">The Silver Beetles</orgName> <orgName notBefore="1960">The Beatles</orgName> <state type="membership" from="1960-08" to="1962-05"> <desc> <persName>John Lennon</persName> <persName>Paul McCartney</persName> <persName>George Harrison</persName> <persName>Stuart Sutcliffe</persName> <persName>Pete Best</persName> </desc> </state> <state type="membership" notBefore="1963"> <desc> <persName>John Lennon</persName> <persName>Paul McCartney</persName> <persName>George Harrison</persName> <persName>Ringo Starr</persName> </desc> </state> </org>
Content model	<content> <sequence> <elementRef key="precision" minOccurs="0" maxOccurs="unbounded"/> <alternate> <elementRef key="state" minOccurs="1" maxOccurs="unbounded"/> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> </sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.labelLike"/> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> </alternate> </sequence> </content>
Schema Declaration	element state { att.global.attributes, att.datable.attributes, att.editLike.attributes, att.typed.attributes, att.naming.attributes, att.dimensions.attributes, ( precision, ( state+ \| ( model.headLike, model.pLike+, ( model.noteLike \| model.biblLike )* ) \| ( model.labelLike \| model.noteLike \| model.biblLike )* ) ) }

1.326. <stdVals>

<stdVals> (standard values) specifies the format used when standardized date or number values are supplied. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.editorialDeclPart
Contained by	header: editorialDecl
May contain	core: p linking: ab
Example	<stdVals> <p>All integer numbers are left-filled with zeroes to 8 digits.</p> </stdVals>
Content model	<content> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element stdVals { att.global.attributes, att.declarable.attributes, model.pLike+ }

1.327. <styleDefDecl>

<styleDefDecl> (style definition language declaration) specifies the name of the formal language in which style or renditional information is supplied elsewhere in the document. The specific version of the scheme may also be supplied. [2.3.5. The Default Style Definition Language Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default) att.styleDef (@scheme, @schemeVersion)
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	core: p linking: ab
Example	<styleDefDecl scheme="css" schemeVersion="2.1"/> <!-- ... --> <tagsDecl> <rendition xml:id="boldface">font-weight: bold;</rendition> <rendition xml:id="italicstyle">font-style: italic;</rendition> </tagsDecl>
Content model	<content> <classRef key="model.pLike" minOccurs="0" maxOccurs="unbounded"/> </content>
Schema Declaration	element styleDefDecl { att.global.attributes, att.declarable.attributes, att.styleDef.attributes, model.pLike* }

1.328. <subst>

<subst> (substitution) groups one or more deletions with one or more additions when the combination is to be regarded as a single intervention in the text. [11.3.1.5. Substitutions]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.pPart.editorial
Contained by	analysis: cl pc phr s span w core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	core: add del lb milestone pb linking: anchor transcr: fw
Example	... are all included. <del hand="#RG">It is</del> <subst> <add>T</add> <del>t</del> </subst>he expressed
Example	that he and his Sister Miſs D — <lb/>who always lived with him, wd. be <subst> <del>very</del> <lb/> <add>principally</add> </subst> remembered in her Will.
Example	<ab>τ<subst> <add place="above">ῶν</add> <del>α</del> </subst> συνκυρόντ<subst> <add place="above">ων</add> <del>α</del> </subst> ἐργαστηρί<subst> <add place="above">ων</add> <del>α</del> </subst> </ab>
Example	<subst> <del> <gap reason="illegible" quantity="5" unit="character"/> </del> <add>apple</add> </subst>
Schematron	<s:assert test="child::tei:add and child::tei:del"> <s:name/> must have at least one child add and at least one child del</s:assert>
Content model	<content> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="add"/> <elementRef key="del"/> <classRef key="model.milestoneLike"/> </alternate> </content>
Schema Declaration	element subst { att.global.attributes, att.transcriptional.attributes, att.dimensions.attributes, ( add \| del \| model.milestoneLike )+ }

1.329. <substJoin>

<substJoin> (substitution join) identifies a series of possibly fragmented additions, deletions or other revisions on a manuscript that combine to make up a single intervention in the text [11.3.1.5. Substitutions]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.global.meta
Contained by	analysis: cl m phr s span w core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material msItem musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName person personGrp persona placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail textstructure: body dateline div front text transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone verse: metSym rhyme
May contain	certainty: certainty precision respons core: desc
Example	While <del xml:id="r112">pondering</del> thus <add xml:id="r113">she mus'd</add>, her pinions fann'd <substJoin target="#r112 #r113"/>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.descLike"/> <classRef key="model.certLike"/> </alternate> </content>
Schema Declaration	element substJoin { att.global.attributes, att.pointing.attributes, att.transcriptional.attributes, att.dimensions.attributes, ( model.descLike \| model.certLike )* }

1.330. <summary>

<summary> contains an overview of the available information concerning some aspect of an item or object (for example, its intellectual content, history, layout, typography etc.) as a complement or alternative to the more detailed information carried by more specific elements. [10.6. Intellectual Content]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: decoDesc handDesc history layoutDesc msContents scriptDesc sealDesc typeDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<summary>This item consists of three books with a prologue and an epilogue. </summary>
Example	<typeDesc> <summary>Uses a mixture of Roman and Black Letter types.</summary> <typeNote>Antiqua typeface, showing influence of Jenson's Venetian fonts.</typeNote> <typeNote>The black letter face is a variant of Schwabacher.</typeNote> </typeDesc>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element summary { att.global.attributes, macro.specialPara }

1.331. <supplied>

<supplied> signifies text supplied by the transcriber or editor for any reason; for example because the original cannot be read due to physical damage, or because of an obvious omission by the author or scribe. [11.3.3.1. Damage, Illegibility, and Supplied Text]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

reason

one or more words indicating why the text has had to be supplied, e.g. overbinding, faded-ink, lost-folio, omitted-in-original.

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace

Member of

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope choice date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Note

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.

Example

I am dr Sr yr <supplied reason="illegible" source="#amanuensis_copy">very humble Servt</supplied> Sydney Smith

Example

<supplied reason="omitted-in-original">Dedication</supplied> to the duke of Bejar

Content model

<content>
 <macroRef key="macro.paraContent"/>
</content>

Schema Declaration

element supplied
{
   att.global.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   attribute reason { list { + } }?,
   macro.paraContent
}

1.332. <support>

<support> contains a description of the materials etc. which make up the physical support for the written part of a manuscript or other object. [10.7.1. Object Description]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: supportDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<objectDesc form="roll"> <supportDesc> <support> Parchment roll with <material>silk</material> ribbons. </support> </supportDesc> </objectDesc>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element support { att.global.attributes, macro.specialPara }

1.333. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

material

a short project-defined name for the material composing the majority of the support

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	paper parch (parchment) mixed

Contained by

msdescription: objectDesc

May contain

core: p

header: extent

linking: ab

msdescription: collation condition foliation support

Example

<supportDesc> <support> Parchment roll with <material>silk</material> ribbons. </support> </supportDesc>

Content model

<content>
 <alternate>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
  <sequence>
   <elementRef key="support" minOccurs="0"/>
   <elementRef key="extent" minOccurs="0"/>
   <elementRef key="foliation"
    minOccurs="0" maxOccurs="unbounded"/>
   <elementRef key="collation"
    minOccurs="0"/>
   <elementRef key="condition"
    minOccurs="0"/>
  </sequence>
 </alternate>
</content>

Schema Declaration

element supportDesc
{
   att.global.attributes,
   attribute material { "paper" | "parch" | "mixed" }?,
   ( model.pLike+ | ( support?, extent?, foliation*, collation?, condition? ) )
}

1.334. <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

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.coordinated (@start, @ulx, @uly, @lrx, @lry, @points) att.declaring (@decls) att.typed (@type, @subtype)

attachment

describes the method by which this surface is or was connected to the main surface

Status	Optional
Datatype	teidata.enumerated
Sample values include:	glued glued in place pinned pinned or stapled in place sewn sewn in place

flipping

indicates whether the surface is attached and folded in such a way as to provide two writing surfaces

Status	Optional
Datatype	teidata.truthValue

Contained by

transcr: facsimile sourceDoc surface surfaceGrp zone

May contain

analysis: interp interpGrp span spanGrp

certainty: certainty precision respons

core: desc gap lb milestone note pb

linking: alt altGrp anchor join joinGrp link linkGrp timeline

textcrit: app witDetail

transcr: addSpan damageSpan delSpan fw line listTranspose metamark path space substJoin surface surfaceGrp zone

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

Content model

<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.global"/>
   <classRef key="model.labelLike"/>
   <classRef key="model.graphicLike"/>
  </alternate>
  <sequence minOccurs="0"
   maxOccurs="unbounded">
   <alternate>
    <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.attributes,
   att.coordinated.attributes,
   att.declaring.attributes,
   att.typed.attributes,
   attribute attachment { text }?,
   attribute flipping { text }?,
   (
      ( model.global | model.labelLike | model.graphicLike )*,
      ( ( zone | line | path | surface | surfaceGrp ), model.global* )*
   )
}

1.335. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls) att.typed (@type, @subtype)
Contained by	transcr: facsimile sourceDoc surface surfaceGrp
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: gap lb milestone note pb linking: alt altGrp anchor join joinGrp link linkGrp timeline textcrit: app witDetail transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin surface surfaceGrp
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> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.global"/> <elementRef key="surface"/> <elementRef key="surfaceGrp"/> </alternate> </content>
Schema Declaration	element surfaceGrp { att.global.attributes, att.declaring.attributes, att.typed.attributes, ( model.global \| surface \| surfaceGrp )+ }

1.336. <surname>

<surname> contains a family (inherited) name, as opposed to a given, baptismal, or nick name. [13.2.1. Personal Names]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) (att.naming (@role, @nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype)
Member of	model.persNamePart
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<surname type="combine">St John Stevas</surname>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element surname { att.global.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq }

1.337. <surplus>

<surplus> marks text present in the source which the editor believes to be superfluous or redundant. [11.3.3.1. Damage, Illegibility, and Supplied Text]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

reason

one or more words indicating why this text is believed to be superfluous, e.g. repeated, interpolated etc.

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace

Member of

model.pPart.transcriptional

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw metamark mod restore retrace secl supplied surplus

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Example

I am dr Sr yrs <surplus reason="repeated">yrs</surplus> Sydney Smith

Content model

<content>
 <macroRef key="macro.paraContent"/>
</content>

Schema Declaration

element surplus
{
   att.global.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   attribute reason { list { + } }?,
   macro.paraContent
}

1.338. <surrogates>

<surrogates> contains information about any representations of the manuscript or other object being described which may exist in the holding institution or elsewhere. [10.9. Additional Information]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	msdescription: additional
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<surrogates> <bibl> <title type="gmd">diapositive</title> <idno>AM 74 a, fol.</idno> <date>May 1984</date> </bibl> <bibl> <title type="gmd">b/w prints</title> <idno>AM 75 a, fol.</idno> <date>1972</date> </bibl> </surrogates>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element surrogates { att.global.attributes, macro.specialPara }

1.339. <tag>

<tag> contains text of a complete start- or end-tag, possibly including attribute specifications, but excluding the opening and closing markup delimiter characters. [22. Documentation Elements]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

type

indicates the type of XML tag intended

Status	Optional
Datatype	teidata.enumerated
Legal values are:	start a start-tag, with delimiters < and > is intended end an end-tag, with delimiters </ and > is intended empty a empty tag, with delimiters < and /> is intended pi a pi (processing instruction), with delimiters <? and ?> is intended comment a comment, with delimiters <!-- and --> is intended ms a marked-section, with delimiters <[CDATA[ and ]]> is intended

scheme

supplies the name of the schema in which this tag is defined.

Status	Optional
Datatype	teidata.enumerated
Sample values include:	TEI (text encoding initiative) This tag is defined as part of the TEI scheme.[Default] DBK (docbook) this tag is part of the Docbook scheme. XX (unknown) this tag is part of an unknown scheme. Schematron HTML

Member of

model.phrase.xml

Contained by

analysis: cl phr s span

core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

Character data only

Example

Mark the start of each italicised phrase with a <tag>hi rend="it"</tag> tag, and its end with a <tag type="end">hi</tag> tag. <tag type="comment">Example updated on 2008-04-05</tag>

Content model

<content>
 <textNode/>
</content>

Schema Declaration

element tag
{
   att.global.attributes,
   attribute type { "start" | "end" | "empty" | "pi" | "comment" | "ms" }?,
   attribute scheme { text }?,
   text
}

1.340. <tagUsage>

<tagUsage> documents the usage of a specific element within a specified document. [2.3.4. The Tagging Declaration]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

gi

(generic identifier) specifies the name (generic identifier) of the element indicated by the tag, within the namespace indicated by the parent <namespace> element.

Status	Required
Datatype	teidata.name

occurs

specifies the number of occurrences of this element within the text.

Status	Recommended
Datatype	teidata.count

withId

(with unique identifier) specifies the number of occurrences of this element within the text which bear a distinct value for the global xml:id attribute.

Status	Recommended
Datatype	teidata.count

Contained by

header: namespace

May contain

core: address bibl choice date desc email hi listBibl name q quote ref time title

header: biblFull idno

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specGrp specGrpRef tag val

textcrit: listApp listWit

transcr: am ex subst

character data

Example

<tagsDecl partial="true"> <rendition xml:id="it" scheme="css" selector="foreign, hi"> font-style: italic; </rendition>  <namespace name="http://www.tei-c.org/ns/1.0"> <tagUsage gi="hi" occurs="28" withId="2"> Used to mark English words italicized in the copy text.</tagUsage> <tagUsage gi="foreign">Used to mark non-English words in the copy text.</tagUsage>  </namespace> </tagsDecl>

Content model

<content>
 <macroRef key="macro.limitedContent"/>
</content>

Schema Declaration

element tagUsage
{
   att.global.attributes,
   attribute gi { text },
   attribute occurs { text }?,
   attribute withId { text }?,
   macro.limitedContent
}

1.341. <tagsDecl>

<tagsDecl> (tagging declaration) provides detailed information about the tagging applied to a document. [2.3.4. The Tagging Declaration 2.3. The Encoding Description]

Module

header

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

partial

indicates whether the element types listed exhaustively include all those found within <text>, or represent only a subset.

Status	Recommended
Datatype	teidata.truthValue
Note	TEI recommended practice is to specify this attribute. When the <tagUsage> elements inside <tagsDecl> are used to list each of the element types in the associated <text>, the value should be given as false. When the <tagUsage> elements inside <tagsDecl> are used to provide usage information or default renditions for only a subset of the elements types within the associated <text>, the value should be true.

Member of

model.biblPart model.msItemPart

Contained by

header: encodingDesc

May contain

header: namespace rendition

Example

<tagsDecl partial="true"> <rendition xml:id="rend-it" scheme="css" selector="emph, hi, name, title">font-style: italic;</rendition> <namespace name="http://www.tei-c.org/ns/1.0"> <tagUsage gi="hi" occurs="467"/> <tagUsage gi="title" occurs="45"/> </namespace> <namespace name="http://docbook.org/ns/docbook"> <tagUsage gi="para" occurs="10"/> </namespace> </tagsDecl>

If the partial attribute were not specified here, the implication would be that the document in question contains only <hi>, <title>, and <para> elements.

Content model

<content>
 <sequence>
  <elementRef key="rendition" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="namespace" minOccurs="0"
   maxOccurs="unbounded"/>
 </sequence>
</content>

Schema Declaration

element tagsDecl
{
   att.global.attributes,
   attribute partial { text }?,
   ( rendition*, namespace* )
}

1.342. <taxonomy>

<taxonomy> defines a typology either implicitly, by means of a bibliographic citation, or explicitly by a structured taxonomy. [2.3.7. The Classification Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: classDecl taxonomy
May contain	core: bibl desc listBibl header: biblFull category taxonomy msdescription: msDesc tagdocs: altIdent equiv
Note	Nested taxonomies are common in many fields, so the <taxonomy> element can be nested.
Example	<taxonomy xml:id="tax.b"> <bibl>Brown Corpus</bibl> <category xml:id="tax.b.a"> <catDesc>Press Reportage</catDesc> <category xml:id="tax.b.a1"> <catDesc>Daily</catDesc> </category> <category xml:id="tax.b.a2"> <catDesc>Sunday</catDesc> </category> <category xml:id="tax.b.a3"> <catDesc>National</catDesc> </category> <category xml:id="tax.b.a4"> <catDesc>Provincial</catDesc> </category> <category xml:id="tax.b.a5"> <catDesc>Political</catDesc> </category> <category xml:id="tax.b.a6"> <catDesc>Sports</catDesc> </category> </category> <category xml:id="tax.b.d"> <catDesc>Religion</catDesc> <category xml:id="tax.b.d1"> <catDesc>Books</catDesc> </category> <category xml:id="tax.b.d2"> <catDesc>Periodicals and tracts</catDesc> </category> </category> </taxonomy>
Example	<taxonomy> <category xml:id="literature"> <catDesc>Literature</catDesc> <category xml:id="poetry"> <catDesc>Poetry</catDesc> <category xml:id="sonnet"> <catDesc>Sonnet</catDesc> <category xml:id="shakesSonnet"> <catDesc>Shakespearean Sonnet</catDesc> </category> <category xml:id="petraSonnet"> <catDesc>Petrarchan Sonnet</catDesc> </category> </category> <category xml:id="haiku"> <catDesc>Haiku</catDesc> </category> </category> <category xml:id="drama"> <catDesc>Drama</catDesc> </category> </category> <category xml:id="meter"> <catDesc>Metrical Categories</catDesc> <category xml:id="feet"> <catDesc>Metrical Feet</catDesc> <category xml:id="iambic"> <catDesc>Iambic</catDesc> </category> <category xml:id="trochaic"> <catDesc>trochaic</catDesc> </category> </category> <category xml:id="feetNumber"> <catDesc>Number of feet</catDesc> <category xml:id="pentameter"> <catDesc>>Pentameter</catDesc> </category> <category xml:id="tetrameter"> <catDesc>>Tetrameter</catDesc> </category> </category> </category> </taxonomy> <!-- elsewhere in document --> <lg ana="#shakesSonnet #iambic #pentameter"> <l>Shall I compare thee to a summer's day</l> <!-- ... --> </lg>
Content model	<content> <alternate> <alternate> <alternate minOccurs="1" maxOccurs="unbounded"> <elementRef key="category"/> <elementRef key="taxonomy"/> </alternate> <sequence> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.glossLike"/> <classRef key="model.descLike"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="category"/> <elementRef key="taxonomy"/> </alternate> </sequence> </alternate> <sequence> <classRef key="model.biblLike"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="category"/> <elementRef key="taxonomy"/> </alternate> </sequence> </alternate> </content>
Schema Declaration	element taxonomy { att.global.attributes, ( ( ( category \| taxonomy )+ \| ( ( model.glossLike \| model.descLike )+, ( category \| taxonomy )* ) ) \| ( model.biblLike, ( category \| taxonomy )* ) ) }

1.343. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	textstructure: TEI
May contain	header: encodingDesc fileDesc profileDesc revisionDesc xenoData
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> <elementRef key="fileDesc"/> <classRef key="model.teiHeaderPart" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="revisionDesc" minOccurs="0"/> </sequence> </content>
Schema Declaration	element teiHeader { att.global.attributes, ( fileDesc, model.teiHeaderPart*, revisionDesc? ) }

1.344. <terrain>

<terrain> contains information about the physical terrain of a place. [13.3.4.3. States, Traits, and Events]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype)
Member of	model.placeStateLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName place placeName region residence roleName settlement sex socecStatus surname terrain tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	certainty: precision core: bibl desc head listBibl note p header: biblFull linking: ab msdescription: msDesc namesdates: terrain
Example	<place xml:id="KERG"> <placeName>Kerguelen Islands</placeName> <!-- ... --> <terrain> <desc>antarctic tundra</desc> </terrain> <!-- ... --> </place>
Content model	<content> <sequence> <elementRef key="precision" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.labelLike" minOccurs="1" maxOccurs="unbounded"/> </alternate> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> <elementRef key="terrain" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element terrain { att.global.attributes, att.datable.attributes, att.editLike.attributes, att.naming.attributes, att.typed.attributes, ( precision, model.headLike, ( model.pLike+ \| model.labelLike+ ), ( model.noteLike \| model.biblLike ), terrain ) }

1.345. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls) att.typed (@type, @subtype) att.written (@hand)
Member of	model.resourceLike
Contained by	textstructure: TEI
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: gap lb milestone note pb linking: alt altGrp anchor join joinGrp link linkGrp timeline textcrit: app witDetail textstructure: body front transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin
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> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> <sequence minOccurs="0"> <elementRef key="front"/> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> </sequence> <alternate> <elementRef key="body"/> <elementRef key="group"/> </alternate> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> <sequence minOccurs="0"> <elementRef key="back"/> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> </sequence> </sequence> </content>
Schema Declaration	element text { att.global.attributes, att.declaring.attributes, att.typed.attributes, att.written.attributes, ( model.global, ( front, model.global )?, ( body \| group ), model.global, ( back, model.global )? ) }

1.346. <textClass>

<textClass> (text classification) groups information which describes the nature or topic of a text in terms of a standard classification scheme, thesaurus, etc. [2.4.3. The Text Classification]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
Member of	model.profileDescPart
Contained by	header: profileDesc
May contain	header: catRef classCode keywords
Example	<taxonomy> <category xml:id="acprose"> <catDesc>Academic prose</catDesc> </category> <!-- other categories here --> </taxonomy> <!-- ... --> <textClass> <catRef target="#acprose"/> <classCode scheme="http://www.udcc.org">001.9</classCode> <keywords scheme="http://authorities.loc.gov"> <list> <item>End of the world</item> <item>History - philosophy</item> </list> </keywords> </textClass>
Content model	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="classCode"/> <elementRef key="catRef"/> <elementRef key="keywords"/> </alternate> </content>
Schema Declaration	element textClass { att.global.attributes, att.declarable.attributes, ( classCode \| catRef \| keywords )* }

1.347. <textLang>

<textLang> (text language) describes the languages and writing systems identified within the bibliographic work being described, rather than its description. [3.11.2.4. Imprint, Size of a Document, and Reprint Information 10.6.6. Languages and Writing Systems]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

mainLang

(main language) supplies a code which identifies the chief language used in the bibliographic work.

Status	Optional
Datatype	teidata.language

otherLangs

(other languages) one or more codes identifying any other languages used in the bibliographic work.

Status	Optional
Datatype	0–∞ occurrences of teidata.language separated by whitespace

Member of

Contained by

core: bibl

msdescription: msContents msItem msItemStruct

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att code gi ident specDesc specList tag val

textcrit: app witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Note

This element should not be used to document the languages or writing systems used for the bibliographic or manuscript description itself: as for all other TEI elements, such information should be provided by means of the global xml:lang attribute attached to the element containing the description.

In all cases, languages should be identified by means of a standardized ‘language tag’ generated according to BCP 47. Additional documentation for the language may be provided by a <language> element in the TEI Header.

Example

<textLang mainLang="en" otherLangs="la"> Predominantly in English with Latin glosses</textLang>

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

element textLang
{
   att.global.attributes,
   attribute mainLang { text }?,
   attribute otherLangs { list { * } }?,
   macro.phraseSeq
}

1.348. <textNode>

<textNode> indicates the presence of a text node in a content model [22. Documentation Elements]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.contentPart
Contained by	tagdocs: alternate content sequence
May contain	Empty element
Example	<content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <elementRef key="hi"/> <elementRef key="seg"/> </alternate> </content>
Content model	<content> <empty/> </content>
Schema Declaration	element textNode { att.global.attributes, empty }

1.349. <time>

<time> contains a phrase defining a time of day in any format. [3.5.4. Dates and Times]
Module	core
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.canonical (@key, @ref) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.typed (@type, @subtype)
Member of	model.dateLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	As he sat smiling, the quarter struck — <time when="11:45:00">the quarter to twelve</time>.
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 time { att.global.attributes, att.datable.attributes, att.canonical.attributes, att.editLike.attributes, att.dimensions.attributes, att.typed.attributes, ( text \| model.gLike \| model.phrase \| model.global )* }

1.350. <timeline>

<timeline> provides a set of ordered points in time which can be linked to elements of a spoken text to create a temporal alignment of that text. [16.4.2. Placing Synchronous Events in Time]

Module

linking

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

origin

designates the origin of the timeline, i.e. the time at which it begins.

Status	Optional
Datatype	teidata.pointer
Note	If this attribute is not supplied, the implication is that the time of origin is not known. If it is supplied, it must point either to one of the <when> elements in its content, or to another <timeline> element.

unit

specifies the unit of time corresponding to the interval value of the timeline or of its constituent points in time.

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	d (days) h (hours) min (minutes) s (seconds) ms (milliseconds)

interval

specifies a time interval either as a positive integral value or using one of a set of predefined codes.

Status	Optional
Datatype	teidata.interval
Note	The value irregular indicates uncertainty about all the intervals in the timeline; the value regular indicates that all the intervals are evenly spaced, but the size of the intervals is not known; numeric values indicate evenly spaced values of the size specified. If individual points in time in the timeline are given different values for the interval attribute, those values locally override the value given in the timeline.

Member of

model.emphLike model.msQuoteLike

Contained by

analysis: cl m phr s span w

core: add address author bibl biblScope date del editor email head hi l lg name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail

textstructure: body dateline div front text

transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone

verse: metSym rhyme

May contain

linking: when

Example

Content model

<content>
 <elementRef key="when" minOccurs="1"
  maxOccurs="unbounded"/>
</content>

Schema Declaration

element timeline
{
   att.global.attributes,
   attribute origin { text }?,
   attribute unit { "d" | "h" | "min" | "s" | "ms" }?,
   attribute interval { text }?,
   when+
}

1.351. <title>

<title> contains a title for any kind of work. [3.11.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.5. The Series Statement]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.typed (type, @subtype)

type

classifies the title according to some convenient typology.

Derived from	att.typed
Status	Optional
Datatype	teidata.enumerated
Sample values include:	main main title sub (subordinate) subtitle, title of part alt (alternate) alternate title, often in another language, by which the work is also known short abbreviated form of title desc (descriptive) descriptive paraphrase of the work functioning as a title
Note	This attribute is provided for convenience in analysing titles and processing them according to their type; where such specialized processing is not necessary, there is no need for such analysis, and the entire title, including subtitles and any parallel titles, may be enclosed within a single <title> element.

level

indicates the bibliographic level for a title, that is, whether it identifies an article, book, journal, series, or unpublished material.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	a (analytic) the title applies to an analytic item, such as an article, poem, or other work published as part of a larger item. m (monographic) the title applies to a monograph such as a book or other item considered to be a distinct publication, including single volumes of multi-volume works j (journal) the title applies to any serial or periodical publication such as a journal, magazine, or newspaper s (series) the title applies to a series of otherwise distinct publications such as a collection u (unpublished) the title applies to any unpublished material (including theses and dissertations unless published by a commercial press)
Note	The level of a title is sometimes implied by its context: for example, a title appearing directly within an <analytic> element is ipso facto of level ‘a’, and one appearing within a <series> element of level ‘s’. For this reason, the level attribute is not required in contexts where its value can be unambiguously inferred. Where it is supplied in such contexts, its value should not contradict the value implied by its parent element.

Member of

Contained by

analysis: cl phr s span

core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote seriesStmt sponsor tagUsage titleStmt

linking: ab seg

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: dateline

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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.attributes,
   att.canonical.attributes,
   att.typed.attribute.subtype,
   att.datable.attributes,
   attribute type { text }?,
   attribute level { "a" | "m" | "j" | "s" | "u" }?,
   macro.paraContent
}

1.352. <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	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	header: biblFull fileDesc
May contain	core: author editor respStmt title header: funder principal sponsor
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> <elementRef key="title" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.respLike" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element titleStmt { att.global.attributes, ( title+, model.respLike* ) }

1.353. <trait>

<trait> contains a description of some status or quality attributed to a person, place, or organization typically, but not necessarily, independent of the volition or action of the holder and usually not at some specific time or for a specific date range. [13.3.1. Basic Principles 13.3.2.1. Personal Characteristics]
Module	namesdates
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.editLike (@evidence, @instant) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.persStateLike model.placeStateLike
Contained by	analysis: cl phr s span core: add address author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName person personGrp persona place placeName region residence roleName settlement sex socecStatus surname trait tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	certainty: precision core: bibl desc head listBibl note p header: biblFull linking: ab msdescription: msDesc namesdates: trait
Note	Where there is confusion between <trait> and <state> the more general purpose element <state> should be used even for unchanging characteristics. If you wish to distinguish between characteristics that are generally perceived to be time-bound states and those assumed to be fixed traits, then <trait> is available for the more static of these. The <state> element encodes characteristics which are sometimes assumed to change, often at specific times or over a date range, whereas the <trait> elements are used to record characteristics, such as eye-colour, which are less subject to change. Traits are typically, but not necessarily, independent of the volition or action of the holder.
Example	<trait type="physical"> <label>Eye colour</label> <desc>Blue</desc> </trait>
Content model	<content> <sequence> <elementRef key="precision" minOccurs="0" maxOccurs="unbounded"/> <alternate> <elementRef key="trait" minOccurs="1" maxOccurs="unbounded"/> <sequence> <classRef key="model.headLike" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> </sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.labelLike"/> <classRef key="model.noteLike"/> <classRef key="model.biblLike"/> </alternate> </alternate> </sequence> </content>
Schema Declaration	element trait { att.global.attributes, att.datable.attributes, att.editLike.attributes, att.naming.attributes, att.typed.attributes, att.dimensions.attributes, ( precision, ( trait+ \| ( model.headLike, model.pLike+, ( model.noteLike \| model.biblLike )* ) \| ( model.labelLike \| model.noteLike \| model.biblLike )* ) ) }

1.354. <transpose>

<transpose> describes a single textual transposition as an ordered list of at least two pointers specifying the order in which the elements indicated should be re-combined. [11.3.4.5. Transpositions]
Module	transcr
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	transcr: listTranspose
May contain	Empty element
Note	Transposition is usually indicated in a document by a metamark such as a wavy line or numbering. The order in which <ptr> elements appear within a <transpose> element should correspond with the desired order, as indicated by the metamark.
Example	<transpose> <ptr target="#ib02"/> <ptr target="#ib01"/> </transpose> The transposition recorded here indicates that the content of the element with identifier `ib02` should appear before the content of the element with identifier `ib01`.
Content model	<content> <sequence> <elementRef key="ptr"/> <elementRef key="ptr" minOccurs="1" maxOccurs="unbounded"/> </sequence> </content>
Schema Declaration	element transpose { att.global.attributes, ( ptr, ptr+ ) }

1.355. <typeDesc>

<typeDesc> contains a description of the typefaces or other aspects of the printing of an incunable or other printed source. [10.7.2.1. Writing]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.physDescPart
Contained by	msdescription: physDesc
May contain	core: p linking: ab msdescription: summary typeNote
Example	<typeDesc> <p>Uses an unidentified black letter font, probably from the 15th century</p> </typeDesc>
Example	<typeDesc> <summary>Contains a mixture of blackletter and Roman (antiqua) typefaces</summary> <typeNote xml:id="Frak1">Blackletter face, showing similarities to those produced in Wuerzburg after 1470.</typeNote> <typeNote xml:id="Rom1">Roman face of Venetian origins.</typeNote> </typeDesc>
Content model	<content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <sequence> <elementRef key="summary" minOccurs="0"/> <elementRef key="typeNote" minOccurs="1" maxOccurs="unbounded"/> </sequence> </alternate> </content>
Schema Declaration	element typeDesc { att.global.attributes, ( model.pLike+ \| ( summary?, typeNote+ ) ) }

1.356. <typeNote>

<typeNote> describes a particular font or other significant typographic feature distinguished within the description of a printed resource. [10.7.2. Writing, Decoration, and Other Notations]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.handFeatures (@scribe, @scribeRef, @script, @scriptRef, @medium, @scope)
Contained by	msdescription: typeDesc
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note p pb q quote ref reg sic time title unclear gaiji: g header: biblFull idno linking: ab alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition schemaSpec specDesc specGrp specGrpRef specList tag val textcrit: app listApp listWit witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<typeNote scope="sole"> Printed in an Antiqua typeface showing strong Italianate influence. </typeNote>
Content model	<content> <macroRef key="macro.specialPara"/> </content>
Schema Declaration	element typeNote { att.global.attributes, att.handFeatures.attributes, macro.specialPara }

1.357. <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.4.3. Additions, Deletions, and Omissions]

Module

core

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (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 inaudible faded background_noise eccentric_ductus
<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.choicePart model.linePart model.pPart.transcriptional

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope choice date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone

verse: rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: add address bibl choice date del desc email gap hi l lb lg listBibl milestone name note pb q quote ref reg sic time title unclear

gaiji: g

header: biblFull idno

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width

tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specDesc specGrp specGrpRef specList tag val

textcrit: app listApp listWit witDetail

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

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

...and then <unclear reason="background-noise">Nathalie</unclear> said ...

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
}

1.358. <undo>

<undo> indicates one or more marked-up interventions in a document which have subsequently been marked for cancellation. [11.3.4.4. Confirmation, Cancellation, and Reinstatement of Modifications]

Module

transcr

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.spanning (@spanTo) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))

target

points to one or more elements representing the interventions which are to be reverted or undone.

Status	Optional
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

Member of

model.linePart model.pPart.transcriptional

Contained by

analysis: cl pc phr s w

core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear

header: change distributor edition extent geoDecl handNote licence scriptNote

linking: ab seg

tagdocs: eg

textcrit: lem rdg wit witDetail

textstructure: dateline

transcr: am damage fw line metamark mod restore retrace secl supplied surplus zone

verse: rhyme

May contain

Empty element

Example

<line>This is <del change="#s2" rend="overstrike"> <seg xml:id="undo-a">just some</seg> sample <seg xml:id="undo-b">text</seg>, we need</del> <add change="#s2">not</add> a real example.</line> <undo target="#undo-a #undo-b" rend="dotted" change="#s3"/>

This encoding represents the following sequence of events:

"This is just some sample text, we need a real example" is written
At stage s2, "just some sample text, we need" is deleted by overstriking, and "not" is added
At stage s3, parts of the deletion are cancelled by underdotting, thus reinstating the words "just some" and "text".

Content model

<content>
 <empty/>
</content>

Schema Declaration

element undo
{
   att.global.attributes,
   att.spanning.attributes,
   att.transcriptional.attributes,
   att.dimensions.attributes,
   attribute target { list { + } }?,
   empty
}

1.359. <unicodeName>

<unicodeName> (unicode property name) contains the name of a registered Unicode normative or informative property. [5.2.1. Character Properties]

Module

gaiji

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

version

specifies the version number of the Unicode Standard in which this property name is defined.

Status	Optional
Datatype	teidata.version

Contained by

gaiji: charProp

May contain

Character data only

Note

A definitive list of current Unicode property names is provided in The Unicode Standard.

Example

<unicodeName>character-decomposition-mapping</unicodeName> <unicodeName>general-category</unicodeName>

Content model

<content>
 <textNode/>
</content>

Schema Declaration

element unicodeName
{
   att.global.attributes,
   attribute version { text }?,
   text
}

1.360. <unitDecl>

<unitDecl> (unit declarations) provides information about units of measurement that are not members of the International System of Units. [2.3.9. The Unit Declaration]
Module	header
Attributes	Attributes att.canonical (@key, @ref) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.encodingDescPart
Contained by	header: encodingDesc
May contain	header: unitDef
Example	<unitDecl> <unitDef xml:id="斤" type="weight"> <label xml:lang="ja">斤</label> <label xml:lang="ja-Latn">kin</label> <conversion fromUnit="#両" toUnit="#斤" formula="16"/> </unitDef> <unitDef xml:id="両" type="weight"> <label xml:lang="ja">両</label> <label xml:lang="ja-Latn">ryo</label> <conversion fromUnit="#分" toUnit="#両" formula="4"/> </unitDef> <unitDef xml:id="分" type="weight"> <label xml:lang="ja">分</label> <label xml:lang="ja-Latn">Bu</label> <conversion fromUnit="#銖" toUnit="#分" formula="6"/> </unitDef> <unitDef xml:id="銖" type="weight"> <label xml:lang="ja">銖</label> <label xml:lang="ja-Latn">Shu</label> </unitDef> </unitDecl>
Content model	<content> <elementRef key="unitDef" minOccurs="1" maxOccurs="unbounded"/> </content>
Schema Declaration	element unitDecl { att.canonical.attributes, att.datable.attributes, att.global.attributes, unitDef+ }

1.361. <unitDef>

<unitDef> (unit definition) contains descriptive information related to a specific unit of measurement. [2.3.9. The Unit Declaration]
Module	header
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.canonical (@key, @ref) att.typed (@type, @subtype)
Contained by	header: unitDecl
May contain	core: desc header: conversion namesdates: bloc country district geogName placeName region settlement
Example	<unitDecl> <unitDef xml:id="pechys" type="length"> <label>πῆχυς</label> <placeName ref="#athens"/> <conversion fromUnit="#daktylos" toUnit="#pechys" formula="24"/> <desc>Equivalent to a cubit or 24 daktyloi.</desc> </unitDef> <unitDef xml:id="daktylos" type="length"> <label>δάκτυλος</label> <placeName ref="#athens"/> <desc>A basic unit of length equivalent to one finger (or the size of a thumb) in ancient Greece.</desc> </unitDef> </unitDecl>
Content model	<content> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.labelLike" minOccurs="1"/> <classRef key="model.placeNamePart" minOccurs="0"/> <elementRef key="conversion" minOccurs="0"/> <elementRef key="unit" minOccurs="0"/> </alternate> </content>
Schema Declaration	element unitDef { att.global.attributes, att.datable.attributes, att.canonical.attributes, att.typed.attributes, ( model.labelLike \| model.placeNamePart? \| conversion? \| unit? )+ }

1.362. <val>

<val> (value) contains a single attribute value. [22. Documentation Elements 22.5.3. Attribute List Specification]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of	model.phrase.xml
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	Character data only
Example	<val>unknown</val>
Content model	<content> <textNode/> </content>
Schema Declaration	element val { att.global.attributes, text }

1.363. <valDesc>

<valDesc> (value description) specifies any semantic or syntactic constraint on the value that an attribute may take, additional to the information carried by the <datatype> element. [22.5.3. Attribute List Specification]
Module	tagdocs
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.translatable (@versionDate) att.combinable (@mode) (att.deprecated (@validUntil))
Contained by	tagdocs: attDef
May contain	analysis: interp interpGrp span spanGrp certainty: certainty precision respons core: address choice date email gap hi lb milestone name note pb ref time title header: idno linking: alt altGrp anchor join joinGrp link linkGrp timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident tag val textcrit: app witDetail transcr: addSpan am damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data
Example	<valDesc>must point to another <gi>align</gi> element logically preceding this one.</valDesc>
Content model	<content> <macroRef key="macro.phraseSeq.limited"/> </content>
Schema Declaration	element valDesc { att.global.attributes, att.translatable.attributes, att.combinable.attributes, macro.phraseSeq.limited }

1.364. <valItem>

<valItem> documents a single value in a predefined list of values. [22.5.3. Attribute List Specification]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.combinable (@mode) (att.deprecated (@validUntil))

ident

specifies the value concerned.

Status	Required
Datatype	teidata.text

Contained by

tagdocs: valList

May contain

core: desc

tagdocs: altIdent equiv paramList remarks

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> 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. </remarks> </valItem> </valList>

Content model

<content>
 <sequence>
  <classRef key="model.glossLike"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0">
   <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.attributes,
   att.combinable.attributes,
   attribute ident { text },
   (
      model.glossLike*,
      ( model.descLike+, ( model.glossLike, model.descLike* )*, remarks* )?,
      paramList?
   )
}

1.365. <valList>

<valList> (value list) contains one or more <valItem> elements defining possible values. [22.5.3. Attribute List Specification]

Module

tagdocs

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.combinable (@mode) (att.deprecated (@validUntil))

type

specifies the extensibility of the list of values specified.

Status	Optional
Datatype	teidata.enumerated
Legal values are:	closed only the values specified are permitted. semi (semi-open) all the values specified should be supported, but other values are legal and software should have appropriate fallback processing for them. open the values specified are sample values only.[Default]

Member of

model.contentPart

Contained by

tagdocs: alternate attDef content dataSpec elementSpec macroSpec sequence

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.attributes,
   att.combinable.attributes,
   attribute type { "closed" | "semi" | "open" }?,
   valItem*
}

1.366. <value>

<value> contains a single value for some property, attribute, or other analysis. [5.2.1. Character Properties]
Module	gaiji
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by	gaiji: charProp
May contain	gaiji: g character data
Example	<value>unknown</value>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element value { att.global.attributes, macro.xtext }

1.367. <variantEncoding>

<variantEncoding> declares the method used to encode text-critical variants. [12.1.1. The Apparatus Entry]

Module

textcrit

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

method

indicates which method is used to encode the apparatus of variants.

Status	Required
Datatype	teidata.enumerated
Legal values are:	location-referenced apparatus uses line numbers or other canonical reference scheme referenced in a base text. double-end-point apparatus indicates the precise locations of the beginning and ending of each lemma relative to a base text. parallel-segmentation alternate readings of a passage are given in parallel in the text; no notion of a base text is necessary.
Note	The value ‘parallel-segmentation’ requires in-line encoding of the apparatus.

location

indicates whether the apparatus appears within the running text or external to it.

Status	Required
Datatype	teidata.enumerated
Schematron	<sch:rule context="tei:variantEncoding"> <sch:assert test="(@location != 'external') or (@method != 'parallel-segmentation')"> The @location value "external" is inconsistent with the parallel-segmentation method of apparatus markup.</sch:assert> </sch:rule>
Legal values are:	internal apparatus appears within the running text. external apparatus appears outside the base text.
Note	The value ‘external’ is inconsistent with the parallel-segmentation method of apparatus markup.

Member of

Contained by

header: encodingDesc

May contain

Empty element

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element variantEncoding
{
   att.global.attributes,
   attribute method
   {
      "location-referenced" | "double-end-point" | "parallel-segmentation"
   },
   attribute location { "internal" | "external" }
   >>
   tei:constraintSpec
   [
      ident = "variantEncodingLocation"
      scheme = "schematron"
      " "
      """ The @location value "external" is inconsistent with the parallel-segmentation method of apparatus markup."""
   ],
   empty
}

1.368. <w>

<w> (word) represents a grammatical (not necessarily orthographic) word. [17.1. Linguistic Segment Categories 17.4.2. Lightweight Linguistic Annotation]
Module	analysis
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.metrical (@met, @real, @rhyme)) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.linguistic (@lemma, @lemmaRef, @pos, @msd, @join) att.notated (@notation)
Member of	model.linePart model.segLike
Contained by	analysis: cl phr s w core: add author bibl biblScope date del editor email head hi l name note p pubPlace publisher q quote ref reg sic textLang time title unclear header: change distributor edition extent geoDecl handNote licence scriptNote linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg textcrit: lem rdg wit witDetail textstructure: dateline transcr: damage fw line metamark mod restore retrace secl supplied surplus zone verse: rhyme
May contain	analysis: c interp interpGrp m pc span spanGrp w certainty: certainty precision respons core: add choice del gap hi lb milestone note pb reg sic unclear gaiji: g linking: alt altGrp anchor join joinGrp link linkGrp seg timeline textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme 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.attributes, att.segLike.attributes, att.typed.attributes, att.linguistic.attributes, att.notated.attributes, ( text \| model.gLike \| seg \| w \| m \| c \| pc \| model.global \| model.lPart \| model.hiLike \| model.pPart.edit )* }

1.369. <watermark>

<watermark> contains a word or phrase describing a watermark or similar device. [10.3.3. Watermarks and Stamps]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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.msdesc
Contained by	analysis: cl phr s span core: add author biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Example	<support> <p> <material>Rag paper</material> with <watermark>anchor</watermark> watermark</p> </support>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element watermark { att.global.attributes, macro.phraseSeq }

1.370. <when>

<when> indicates a point in time either relative to other elements in the same timeline tag, or absolutely. [16.4.2. Placing Synchronous Events in Time]

Module

linking

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

absolute

supplies an absolute value for the time.

Status	Optional
Datatype	teidata.temporal.w3c
Note	This attribute should always be specified on a <when> element which serves as the target for the origin attribute of a <timeLine>.

unit

specifies the unit of time in which the interval value is expressed, if this is not inherited from the parent <timeline>.

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	d (days) h (hours) min (minutes) s (seconds) ms (milliseconds)

interval

specifies a time interval either as a number or as one of the keywords defined by the datatype data.interval

Status	Optional
Datatype	teidata.interval

since

identifies the reference point for determining the time of the current <when> element, which is obtained by adding the interval to the time of the reference point.

Status	Optional
Datatype	teidata.pointer
Note	This attribute should point to another <when> element in the same <timeline>. If no value is supplied, and the absolute attribute is also unspecified, then the reference point is understood to be the origin of the enclosing <timeline> tag.

Contained by

linking: timeline

May contain

Empty element

Note

On this element, the global xml:id attribute must be supplied to specify an identifier for this point in time. The value used may be chosen freely provided that it is unique within the document and is a syntactically valid name. There is no requirement for values containing numbers to be in sequence.

Example

Content model

<content>
 <empty/>
</content>

Schema Declaration

element when
{
   att.global.attributes,
   attribute absolute { text }?,
   attribute unit { "d" | "h" | "min" | "s" | "ms" }?,
   attribute interval { text }?,
   attribute since { text }?,
   empty
}

1.371. <width>

<width> contains a measurement of an object along the axis parallel to its bottom, e.g. perpendicular to the spine of a book or codex. [10.3.4. Dimensions]
Module	msdescription
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence))
Member of	model.dimLike model.measureLike
Contained by	analysis: cl phr s span core: add author bibl biblScope date del desc editor email head hi l name note p pubPlace publisher q quote ref reg resp sic textLang time title unclear header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage linking: ab seg msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote dimensions explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates typeNote watermark namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname tagdocs: eg valDesc textcrit: lem rdg wit witDetail witness textstructure: dateline transcr: damage fw metamark mod restore retrace secl supplied surplus verse: metSym rhyme
May contain	gaiji: g character data
Note	If used to specify the depth of a non text-bearing portion of some object, for example a monument, this element conventionally refers to the axis facing the observer, and perpendicular to that indicated by the ‘depth’ axis.
Example	<width unit="in">4</width>
Content model	<content> <macroRef key="macro.xtext"/> </content>
Schema Declaration	element width { att.global.attributes, att.dimensions.attributes, macro.xtext }

1.372. <wit>

<wit> contains a list of one or more sigla of witnesses attesting a given reading, in a textual variation. [12.1.4. Witness Information]
Module	textcrit
Attributes	Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.rdgPart (@wit)
Member of	model.rdgPart
Contained by	textcrit: app lem rdg rdgGrp
May contain	analysis: c cl interp interpGrp m pc phr s span spanGrp w certainty: certainty precision respons core: add address choice date del email gap hi lb milestone name note pb q quote ref reg sic time title unclear gaiji: g header: idno linking: alt altGrp anchor join joinGrp link linkGrp seg timeline msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName placeName population region roleName settlement state surname terrain trait tagdocs: att code gi ident specDesc specList tag val textcrit: app witDetail transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo verse: caesura rhyme character data
Note	This element represents the same information as that provided by the wit attribute of the reading; it may be used to record the exact form of the sigla given in the source edition, when that is of interest.
Example	<rdg wit="#El #Hg">Experience</rdg> <wit>Ellesmere, Hengwryt</wit>
Content model	<content> <macroRef key="macro.phraseSeq"/> </content>
Schema Declaration	element wit { att.global.attributes, att.rdgPart.attributes, macro.phraseSeq }

1.373. <witDetail>

<witDetail> (witness detail) gives further information about a particular witness, or witnesses, to a particular reading. [12.1. The Apparatus Entry, Readings, and Witnesses]

Module

textcrit

Attributes

Attributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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 (@targetLang, @target, @evaluate)

wit

(witnesses) indicates the sigil or sigla identifying the witness or witnesses to which the detail refers.

Status	Required
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace

type

describes the type of information given about the witness.

Status	Optional
Datatype	teidata.enumerated

Member of