This document gives recommendations on the preferred TEI XML encoding of langauge corpora in the CLARIN.SI repository.
The TEI customisation for CLARIN.SI supports the encoding of language corpora and makes explicit recommendations on the manner of encoding various phenomena.
These recommendations are written as a TEI ODD document (= proze recommendations and formal schema), on the basis of which it is possible to derive an XML schema expressed either as a RelaxNG schema, a DTD or a W3C schema, and such schemas are also part of this Git repository.
When using these recommendations, the following points should be taken in consideration:
The rest of these recommendations are structured as follows:
These recommendations consists of readable guidelines and a formal TEI ODD schema with derived XML schemas in various schema languages. They are intended for the encoding of linguistically annotated corpora, regardless of the language or country of origin, for the purposes of scholarly investigations, be they from the field of linguistics, political science, history or other humanities and social sciences disciplines.
In developing a schema for structuring data, two approaches can be adopted: a descriptive one, where as much as possible of the original data distinctions are kept in the target encoding; or a prescriptive one, where the target encoding is severely constrained, to enable seamless data interchange and esp. interoperability with software tools. These recommendations adopt the descriptive approach, as the source data, time and effort devoted to converting it, the intended applications will differ considerably, and it is likely that any prescriptive schema would soon turn out to be too restrictive. Nevertheless, the recommendations do try to limit the plethora of encoding options otherwise available in TEI to those that could be sensibly applied to language corpora, and where more than one option is available in TEI to encode a given phenomenon, the schema and especially the text guidelines attempt to recommend only one option.
A CLARIN.SI corpus should, in general, capture as much of the text from the source as possible, while the presence of graphical items or other elements that could not or were not transcribed should be indicated by markup, in particular with the use of <gap>.
The corpus should be encoded in Unicode, using the UTF-8 character encoding, at least for European languages. In cases where the original contains characters from the Unicode Private Use Area, these should be given their closest Unicode equivalents.1
End-of-line hyphens can be removed, and the split words joined in order to simplify linguistic processing. It is recommended that this practice is documented in the TEI header of the corpus, in the <hyphenation> element.
The following characters, esp. prevalent when the source documents are in Word or HTML, deserve special mention:
While not required, it is sensible to also normalise sequences of whitespace characters (such as tabulators, end-of-line characters and spaces) into a single space or end-of-line character. Again, this simplifies further (esp. linguistic) processing.
The language of an element's text content is in TEI, as in XML, signaled by the value of its xml:lang attribute. The CLARIN.SI recommendations require that each element that contains text is either marked by this attribute, or one of its ancestors is; in particular, the root element of the corpus should have an xml:lang attribute. For multilingual documents (excluding cases where only a minor part of the text is in another language), the language code of the root element should be ‘mul’ for ‘multiple languages’. Note that if, going by the ancestor axis, the values of two xml:lang are in conflict, the one closer to the context node is relevant one.
The values of xml:lang should follow BCP 47, cf. also ‘xml:lang in XML document schemas’.
It is good practice to document the languages used in the <langUsage> element of the TEI header.
Apart from the above considerations, a related question is where to draw the line between the object and meta languages, i.e. the language of the corpus and the language of the mark-up. The TEI defines the names of the elements and attributes in English, and the language of the corpus will, of course, depend on the country of the parliament. It is less straightforward to decide in which language the attribute values (such as the values of the type attribute) should be. CLARIN.SI recommends that these should also be in English.
In order to simply refer to elements of a TEI document (i.e. a CLARIN.SI corpus), elements can be marked with an ID, i.e. given the xml:id attribute with a unique value, obeying certain format requirements as defined by W3C.
CLARIN.SI requires an xml:id attribute on the root element of each corpus file, which should, furthermore, be identical to the filename (modulo the file extension). CLARIN.SI also recommends that the divisions of the document (element <div>), if any, should also be given identifiers. While any element can be given an xml:id, this is in general, not a good idea; rather, only those elements that will or could be referenced should be marked with this attribute.
TEI offers a number of attributes that contain (URI) pointers. Where the reference is to an element inside the document, the value of the xml:id being referred to should be preceded by a hash (#), as mandated by the XML standard. If the ID pointed to is from another document, then the full URI needs to be used.
Corpora cancontain time-related information, e.g. the date and time of a tweet, the birth (and death) dates of an author, etc. In general, such information in TEI is stored in the attributes of the pertinent element, which take as their values a date and possibly time, according to the ISO 8601 Date and Time Formats, and specified in the XML Schema Part 2: Datatypes Second Edition. TEI offers a very rich set of attributes and ancillary elements to specify time-related information, which are discussed in the Section on Dates and Times of the TEI Guidelines.
CLARIN.SI corpora can use any of the TEI temporal attributes and elements, however, for most purposes, the following five attributes will suffice:
While this recommendations make the assumption that a complete corpus is one TEI XML document, this does not mean that it also has to be stored in one file, as the file structure is distinct from the concept of XML documents. To enable one XML document to be composed of many files, the XInclude mechanism should be used. Typically, a corpus will then be composed of a file containing the root XML element <teiCorpus>, which contains the corpus header, while individual <TEI>-rooted text files will be included in the corpus using the <include> element from the XInclude namespace, as illustrated by the following example:
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Sk-11/SI-1990-05-07-01.xml"/>⚓
As mentioned, we recommend that the file has the same name as the value of the xml:id attribute of the root element of the file. This e.g. guarantees that each file of the corpus has a unique name.
As illustrated below, a CLARIN.SI corpus is rooted in a <teiCorpus> element. The <teiHeader> of the corpus contains the metadata for the complete corpus, including the metadata that is marked with the xml:id attribute and referred to by the subordinate <TEI> elements, such as the defined taxonomies for text types.
An individual <TEI> element is referred to as a corpus element. In cases where such a category is simply defined (e.g. a corpus of books) it contains one text from the corpus, however, if corpus "texts" are very short (tweets, samples) or very long or complex (encyclopedias) one corpus element can contain a collection or part of a "text" according to some well-specified criterion.
In cases of smaller corpora, the top level <teiCorpus> can also be omitted, so the complete corpus is rooted simply in a <TEI> element, and the individual (short) texts are encoded as <div> elements.
The <text> element can, in general, apart from the obligatory <body>, also contain front matter in <front> and back matter in <back>. However, front and back are seldomly used in computer corpora.
Copora can exist in two or more versions, e.g. the original and its translation(s) into another language(s).
text-orig.xml
and one from the file text-trans.xml
it is in this case enough to specify the xml:id on both elements and use the corresp attribute to point to the aligned sentence(s): corresp="text-orig.xml#orig.3 text-orig.xml#orig.4"
.TEI allows significant metadata to be added to a document. The metadata is contained in the <teiHeader> element, which in corpora can appear at two levels:
It is recommended that the metadata that is common to the whole corpus is stored in the corpus TEI header, whereas the text-specific metadata is in the corpus text TEI header.
It is outside the scope of this specification to give all the details of a <teiHeader> element, for this, the user is referred to the Section on the TEI header of the TEI Guidelines, and, of course, to the example corpora that are part of the CLARIN.SI Git repository. Here we do, however, give some examples that are useful for a variety of corpora.
Speech corpora typically contain information about speakers, which is given in the corpus TEI header, in particular in the <listPerson> element, itself a part of the participant description, i.e. the <particDesc> element.
As illustrated above, further person metadata can contain the sex of the person and their birth date and place. Other potentially useful elements are the persons <death> date and place, as well as (possibly time stamped) <education>, <occupation>, and <affiliation>.
Persons can have further attributes, and TEI offers various elements (typically typed) to express them; they are introduced in the Section on Personal Characteristics of the TEI Guidelines. The two more general ones are <state>, which contains the description of some status or quality attributed to a person (or organization), often at some specific time or for a specific date range and <trait>, which differs from <state> that it is independent of the volition or action of the holder and usually not at some specific time or for a specific date range. The former could, for example, be used to encode the fact that a person was jailed for a given period of time, while the latter would e.g. be used for the information that a person is handicapped.
This section introduces common types of linguistic annotation that can be added language to the corporus texts; the examples should be sufficient for users to be able to add further types of linguistic annotation to their own corpora.
The TEI Guidelines discuss basic linguistic annotation in their Chapter on Simple Analytic Mechanisms and we follow one particular option given there. In particular, it is recommended that (where possible) the annotation is in-line (as opposed to stand-off), i.e. that the linguistic annotation is given in the main document, and therefore mixed with the other annotations, rather than in a separate document with pointers into the base text.
The base form of a word is given in the lemma attribute,2 while the situation with the part-of-speech tags is somewhat more complicated. For analytic tagsets, where a "part-of-speech tag" is actually a set of attribute-values, as in the example above, the msd attribute should be used. For synthetic tagsets, such as the Penn Treebank tagset, which have atomic tags that cannot always be decomposed into attribute-value pairs (e.g. "TO" for the word "to"), a better alternative is to use of the pos attribute.
http://nl.ijs.si/ME/V6/msd/tables/msd-fslib2-sl.xml#Pd-nsg
) which enables the feature-structure definitions to be stored externaly to the corpus. However, prefixing such PoS tags for each token by the complete URL would lead to very large files. This is why the TEI offers a mechanism to shorten references to URLs. This mechanism is explained in the Section Using Abbreviated Pointers of the TEI Guidelines, and we give below and example: mte:
rather than #
. This prefix should be then expanded by the processing software to whatever the <prefixDef> element, defined in the TEI header, specifies, as shown in the example below: In certain contexts a word (or, in general, a token) in the text needs to be normalised in a certain way. This can happen with historical texts, which contain archaic wordforms and where we wish to annotate them with their modernised forms, or when the text is linguisticaly annotated, and the annotation framework distinguishes original words form syntactic words (i.e. has the concept of ‘multiwords’), as is the case in the Universal Dependencies framework.
For simple normalisation, where one word token is normalised into another word token, the norm attribute on word or punctuation tokens should be used, as explained at the end of the Section Lightweight Linguistic Annotation of the TEI Guidelines.
The contained links then give the references to the head and argument tokens of the relation, while the ana attribute specifies what kind of a relation this is. It should be noted that the value of the analysis attribute is a pointer, and, in the example, we use the TEI prefix mechanism, which is then expanded via the <prefixDef> element in the TEI header to resolve into a URI pointer (as explained in Section on Identifiers and referencing), most likely to pointing to <taxonomy> categories that give the definitions of the relations. A further point to notice is that the sentence serves as the Root element of the sentence, i.e. the fifth link of the UD analysis ties together the sentence with the top-most token of the sentence.
Some corpora can also have data from other modalities associated with the transcripts, in particular audio or video recordings, and the facsimile of the original texts, particularly relevant for corpora of historcial texts. This section explains how to encode such data in the TEI encoded documents, where it is assumed that the actual speech, video and images are stored in separate files, and the TEI document makes reference to them.
The (speech) corpus can refer to and align with external audio and video data using the <timeline> element, explained in the Section on Placing Synchronous Events in Time of the TEI Guidelines, and further elaborated in ISO 24624:2016 Language resource management -- Transcription of spoken language. While the ISO standard is better elaborated, it also changes and adds element definitions, so we are using the standard TEI variant of speech encoding as far as the schema is concerned, while taking into account, as much as possible, specific encoding choices as proposed by the ISO standard.
The mapping of time intervals of the recording to IDs in the TEI document is encoded in the <timeline> element, in particular in the contained <when> elements. As explained below, these IDs are then used to link elements in the transcription to the timeline, therefore each <when> element must have the xml:id attribute. The <when> elements must also be in the same order as the time-points they encode.
s
) and the time origin of the timeline, here referring to the first <when> element, at the very start of the recording, so specified with the absolute time. Further <when> elements give the interval between this origin point and their end: Especially for older text, where the exact appearance of the original is of interest, it can be advantageous to also enable viewing the facsimile together with the text transcription. How to achieve this in general is explained in the Chapter on Representation of Primary Sources of the TEI Guidelines.
By convention, this encoding indicates that the image indicated by the facs attribute represents the whole of the text following the <pb> element, up to the next <pb> element.
More complicated cases, such as delimiting portions of a page are also supported by the TEI Guidelines, and for these the reader is referred directly to the Section on Digital Facsimiles.
A TEI encoded document is, in general, not meant to be used directly by software programs, rather it serves as an interchange and storage format. Furthermore, most TEI documents are not "born TEI", but rather converted into TEI from some source format. In this section we discuss some up- and down-conversion scripts that have already been developed for transforming source formats into CLARIN.SI and from CLARIN.SI into formats immediately usable by software and are available in the Git repository of CLARIN.SI.
To do!
This proposal was inspired by a number of related projects, in particular: Best Practices for TEI in Libraries, the DARIAH and ELEXIS funded initiative TEI Lex0 to develop an interchange encoding for machine readable dictionaries, and the ELTeC corpus initiative by the COST Action CA16204 ‘Distant Reading for European Literary History’.
The work on these recommendations was funded by the CLARIN Research Infrastructure for Language Resources and Tools.
This section gives a complete example document and aims to illustrate the encoding of various aspects of corpus annotation.
<TEI> (TEI document) contains a single TEI-conformant document, combining a single TEI header with one or more members of the model.resource class. Multiple <TEI> elements may be combined within a <TEI> (or <teiCorpus>) element. [4. Default Text Structure 15.1. Varieties of Composite Text] | |||||||||
Module | textstructure — Formal specification | ||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||||
Contained by | |||||||||
May contain | |||||||||
Note | This element is required. It is customary to specify the TEI namespace http://www.tei-c.org/ns/1.0 on it, for example: <TEI version="4.4.0" xml:lang="it" xmlns="http://www.tei-c.org/ns/1.0">. | ||||||||
Example | <TEI version="3.3.0" xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader>
<fileDesc>
<titleStmt>
<title>The shortest TEI Document Imaginable</title>
</titleStmt>
<publicationStmt>
<p>First published as part of TEI P2, this is the P5
version using a namespace.</p>
</publicationStmt>
<sourceDesc>
<p>No source: this is an original work.</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<text>
<body>
<p>This is about the shortest TEI document imaginable.</p>
</body>
</text>
</TEI> | ||||||||
Example | <TEI version="2.9.1" xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader>
<fileDesc>
<titleStmt>
<title>A TEI Document containing four page images </title>
</titleStmt>
<publicationStmt>
<p>Unpublished demonstration file.</p>
</publicationStmt>
<sourceDesc>
<p>No source: this is an original work.</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<facsimile>
<graphic url="page1.png"/>
<graphic url="page2.png"/>
<graphic url="page3.png"/>
<graphic url="page4.png"/>
</facsimile>
</TEI> | ||||||||
Schematron |
<sch:ns prefix="tei"
uri="http://www.tei-c.org/ns/1.0"/>
<sch:ns prefix="xs"
uri="http://www.w3.org/2001/XMLSchema"/> | ||||||||
Schematron |
<sch:ns prefix="rng"
uri="http://relaxng.org/ns/structure/1.0"/> | ||||||||
Content model | <content> <sequence> <elementRef key="teiHeader"/> <alternate> <sequence> <classRef key="model.resource" minOccurs="1" maxOccurs="unbounded"/> <elementRef key="TEI" minOccurs="0" maxOccurs="unbounded"/> </sequence> <elementRef key="TEI" minOccurs="1" maxOccurs="unbounded"/> </alternate> </sequence> </content> ⚓ | ||||||||
Schema Declaration | element TEI { tei_att.global.attributes, tei_att.typed.attributes, attribute version { text }?, ( tei_teiHeader, ( ( tei_model.resource+, tei_TEI* ) | tei_TEI+ ) ) }⚓ |
<ab> (anonymous block) contains any component-level unit of text, acting as a container for phrase or inter level elements analogous to, but without the same constraints as, a paragraph. [16.3. Blocks, Segments, and Anchors] | |
Module | linking — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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.declaring (@decls) att.fragmentable (@part) att.written (@hand) |
Member of | |
Contained by | corpus: particDesc setting settingDesc header: abstract application availability cRefPattern calendar change correction correspAction correspContext correspDesc editionStmt editorialDecl encodingDesc hyphenation interpretation langUsage licence normalization prefixDef projectDesc publicationStmt punctuation quotation refsDecl samplingDecl segmentation seriesStmt sourceDesc stdVals styleDefDecl linking: ab namesdates: climate event langKnowledge listRelation nym object occupation org person personGrp persona place population state terrain trait textstructure: back body div front postscript transcr: metamark |
May contain | core: abbr add address bibl biblStruct cb choice cit corr date del desc distinct ellipsis email emph expan foreign gap gloss graphic hi index l label lb lg list listBibl measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled stage term time title unclear unit figures: figure formula notatedMusic table gaiji: g 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 persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
Note | The <ab> element may be used at the encoder's discretion to mark any component-level elements in a text for which no other more specific appropriate markup is defined. Unlike paragraphs, <ab> may nest and may use the type and subtype attributes. |
Example | <div type="book" n="Genesis">
<div type="chapter" n="1">
<ab>In the beginning God created the heaven and the earth.</ab>
<ab>And the earth was without form, and void; and
darkness was upon the face of the deep. And the
spirit of God moved upon the face of the waters.</ab>
<ab>And God said, Let there be light: and there was light.</ab>
<!-- ...-->
</div>
</div> |
Schematron |
<sch:report test="(ancestor::tei:l or ancestor::tei:lg) and not( ancestor::tei:floatingText
|parent::tei:figure |parent::tei:note )"> Abstract model violation: Lines may not contain higher-level divisions such as p or ab, unless ab is a child of figure or note, or is a descendant of floatingText.
</sch:report> |
Content model | <content> <macroRef key="macro.abContent"/> </content> ⚓ |
Schema Declaration | element ab { tei_att.global.attributes, tei_att.typed.attributes, tei_att.declaring.attributes, tei_att.fragmentable.attributes, tei_att.written.attributes, tei_macro.abContent }⚓ |
<abbr> (abbreviation) contains an abbreviation of any sort. [3.6.5. Abbreviations and Their Expansions] | |||||||||||||
Module | core — Formal specification | ||||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||||||||
Contained by | core: abbr add addrLine author bibl biblScope choice citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode creation distributor edition extent funder geoDecl language licence principal rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer | ||||||||||||
May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data | ||||||||||||
Note | If abbreviations are expanded silently, this practice should be documented in the <editorialDecl>, either with a <normalization> element or a <p>. | ||||||||||||
Example | <choice>
<expan>North Atlantic Treaty Organization</expan>
<abbr cert="low">NorATO</abbr>
<abbr cert="high">NATO</abbr>
<abbr cert="high" xml:lang="fr">OTAN</abbr>
</choice> | ||||||||||||
Example | <choice>
<abbr>SPQR</abbr>
<expan>senatus populusque romanorum</expan>
</choice> | ||||||||||||
Content model | <content> <macroRef key="macro.phraseSeq"/> </content> ⚓ | ||||||||||||
Schema Declaration | element abbr { tei_att.global.attributes, tei_att.typed.attribute.subtype, attribute type { text }?, tei_macro.phraseSeq }⚓ |
<abstract> contains a summary or formal abstract prefixed to an existing source document by the encoder. [2.4.4. Abstracts] | |
Module | header — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | header: profileDesc |
May contain | figures: table linking: ab namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation |
Note | This element is intended only for cases where no abstract is available in the original source. Any abstract already present in the source document should be encoded as a <div> within the <front>, as it should for a born-digital document. |
Example | <profileDesc>
<abstract resp="#LB">
<p>Good database design involves the acquisition and deployment of
skills which have a wider relevance to the educational process. From
a set of more or less instinctive rules of thumb a formal discipline
or "methodology" of database design has evolved. Applying that
methodology can be of great benefit to a very wide range of academic
subjects: it requires fundamental skills of abstraction and
generalisation and it provides a simple mechanism whereby complex
ideas and information structures can be represented and manipulated,
even without the use of a computer. </p>
</abstract>
</profileDesc> |
Content model | <content> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.pLike"/> <classRef key="model.listLike"/> <elementRef key="listBibl"/> </alternate> </content> ⚓ |
Schema Declaration | element abstract { tei_att.global.attributes, ( tei_model.pLike | tei_model.listLike | tei_listBibl )+ }⚓ |
<activity> (activity) contains a brief informal description of what a participant in a language interaction is doing other than speaking, if anything. [15.2.3. The Setting Description] | |
Module | corpus — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | corpus: setting |
May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data |
Note | For more fine-grained description of participant activities during a spoken text, the <event> element should be used. |
Example | <activity>driving</activity> |
Content model | <content> <macroRef key="macro.phraseSeq.limited"/> </content> ⚓ |
Schema Declaration | element activity { tei_att.global.attributes, tei_macro.phraseSeq.limited }⚓ |
<add> (addition) contains letters, words, or phrases inserted in the source text by an author, scribe, or a previous annotator or corrector. [3.5.3. Additions, Deletions, and Omissions] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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.placement (@place) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) |
Member of | |
Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure mentioned name note num orig p pubPlace publisher q quote rb ref reg rs rt said sic soCalled speaker stage street term textLang time title unclear unit figures: cell namesdates: addName affiliation birth bloc country death district education faith floruit forename genName gender geogFeat geogName nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer |
May contain | core: abbr add address bibl biblStruct cb choice cit corr date del desc distinct ellipsis email emph expan foreign gap gloss graphic hi index l label lb lg list listBibl measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled stage term time title unclear unit figures: figure formula notatedMusic table gaiji: g 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 persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
Note | In a diplomatic edition attempting to represent an original source, the <add> element should not be used for additions to the current TEI electronic edition made by editors or encoders. In these cases, either the <corr> or <supplied> element are recommended. In a TEI edition of a historical text with previous editorial emendations in which such additions or reconstructions are considered part of the source text, the use of <add> may be appropriate, dependent on the editorial philosophy of the project. |
Example | The story I am
going to relate is true as to its main facts, and as to the
consequences <add place="above">of these facts</add> from which
this tale takes its title. |
Content model | <content> <macroRef key="macro.paraContent"/> </content> ⚓ |
Schema Declaration | element add { tei_att.global.attributes, tei_att.transcriptional.attributes, tei_att.placement.attributes, tei_att.typed.attributes, tei_att.dimensions.attributes, tei_macro.paraContent }⚓ |
<addSpan> (added span of text) marks the beginning of a longer sequence of text added by an author, scribe, annotator or corrector (see also <add>). [11.3.1.4. Additions and Deletions] | |
Module | transcr — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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.placement (@place) att.typed (@type, @subtype) att.spanning (@spanTo) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) |
Member of | |
Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname |
May contain | Empty element |
Note | Both the beginning and the end of the added material must be marked; the beginning by the <addSpan> element itself, the end by the spanTo attribute. |
Example | <handNote xml:id="HEOL"
scribe="HelgiÓlafsson"/>
<!-- ... -->
<body>
<div>
<!-- text here -->
</div>
<addSpan n="added_gathering" hand="#HEOL"
spanTo="#P025"/>
<div>
<!-- text of first added poem here -->
</div>
<div>
<!-- text of second added poem here -->
</div>
<div>
<!-- text of third added poem here -->
</div>
<div>
<!-- text of fourth added poem here -->
</div>
<anchor xml:id="P025"/>
<div>
<!-- more text here -->
</div>
</body> |
Schematron |
<sch:assert test="@spanTo">The @spanTo attribute of <sch:name/> is required.</sch:assert> |
Schematron |
<sch:assert test="@spanTo">L'attribut spanTo est requis.</sch:assert> |
Content model | <content> <empty/> </content> ⚓ |
Schema Declaration | element addSpan { tei_att.global.attributes, tei_att.transcriptional.attributes, tei_att.placement.attributes, tei_att.typed.attributes, tei_att.spanning.attributes, tei_att.dimensions.attributes, empty }⚓ |
<addrLine> (address line) contains one line of a postal address. [3.6.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.12.2.4. Imprint, Size of a Document, and Reprint Information] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | core: address |
May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
Note | Addresses may be encoded either as a sequence of lines, or using any sequence of component elements from the model.addrPart class. Other non-postal forms of address, such as telephone numbers or email, should not be included within an <address> element directly but may be wrapped within an <addrLine> if they form part of the printed address in some source text. |
Example | <address>
<addrLine>Computing Center, MC 135</addrLine>
<addrLine>P.O. Box 6998</addrLine>
<addrLine>Chicago, IL</addrLine>
<addrLine>60680 USA</addrLine>
</address> |
Example | <addrLine>
<ref target="tel:+1-201-555-0123">(201) 555 0123</ref>
</addrLine> |
Content model | <content> <macroRef key="macro.phraseSeq"/> </content> ⚓ |
Schema Declaration | element addrLine { tei_att.global.attributes, tei_macro.phraseSeq }⚓ |
<address> (address) contains a postal address, for example of a publisher, an organization, or an individual. [3.6.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.12.2.4. Imprint, Size of a Document, and Reprint Information] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl language licence principal publicationStmt rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer |
May contain | figures: figure notatedMusic header: idno namesdates: addName bloc climate country district forename genName geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin |
Note | This element should be used for postal addresses only. Within it, the generic element <addrLine> may be used as an alternative to any of the more specialized elements available from the model.addrPart class, such as <street>, <postCode> etc. |
Example | Using just the elements defined by the core module, an address could be represented as follows: <address>
<street>via Marsala 24</street>
<postCode>40126</postCode>
<name>Bologna</name>
<name>Italy</name>
</address> |
Example | When a schema includes the names and dates module more specific elements such as country or settlement would be preferable over generic <name>: <address>
<street>via Marsala 24</street>
<postCode>40126</postCode>
<settlement>Bologna</settlement>
<country>Italy</country>
</address> |
Example | <address>
<addrLine>Computing Center, MC 135</addrLine>
<addrLine>P.O. Box 6998</addrLine>
<addrLine>Chicago, IL 60680</addrLine>
<addrLine>USA</addrLine>
</address> |
Example | <address>
<country key="FR"/>
<settlement type="city">Lyon</settlement>
<postCode>69002</postCode>
<district type="arrondissement">IIème</district>
<district type="quartier">Perrache</district>
<street>
<num>30</num>, Cours de Verdun</street>
</address> |
Content model | <content> <sequence> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> <sequence minOccurs="1" maxOccurs="unbounded"> <classRef key="model.addrPart"/> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> </sequence> </sequence> </content> ⚓ |
Schema Declaration | element address { tei_att.global.attributes, ( tei_model.global*, ( tei_model.addrPart, tei_model.global* )+ ) }⚓ |
<affiliation> (affiliation) contains an informal description of a person's present or past affiliation with some organization, for example an employer or sponsor. [15.2.2. The Participant Description] | |||||||||||
Module | namesdates — Formal specification | ||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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)
| ||||||||||
Member of | |||||||||||
Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl language licence principal rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer | ||||||||||
May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data | ||||||||||
Note | If included, the name of an organization may be tagged using either the <name> element as above, or the more specific <orgName> element. | ||||||||||
Example | <affiliation>Junior project officer for the US <name type="org">National Endowment for
the Humanities</name>
</affiliation> | ||||||||||
Example | This example indicates that the person was affiliated with the Australian Journalists Association at some point between the dates listed. <affiliation notAfter="1960-01-01"
notBefore="1957-02-28">Paid up member of the
<orgName>Australian Journalists Association</orgName>
</affiliation> | ||||||||||
Example | This example indicates that the person was affiliated with Mount Holyoke College throughout the entire span of the date range listed. <affiliation from="1902-01-01"
to="1906-01-01">Was an assistant professor at Mount Holyoke College.</affiliation> | ||||||||||
Content model | <content> <macroRef key="macro.phraseSeq"/> </content> ⚓ | ||||||||||
Schema Declaration | element affiliation { tei_att.global.attributes, tei_att.editLike.attributes, tei_att.datable.attributes, tei_att.naming.attributes, tei_att.typed.attribute.subtype, attribute type { text }?, tei_macro.phraseSeq }⚓ |
<age> (age) specifies the age of a person. [13.3.2.1. Personal Characteristics] | |||||||||||||||||||
Module | namesdates — Formal specification | ||||||||||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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.typed (type, @subtype)
| ||||||||||||||||||
Member of | |||||||||||||||||||
Contained by | |||||||||||||||||||
May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan 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 { tei_att.global.attributes, tei_att.editLike.attributes, tei_att.datable.attributes, tei_att.typed.attribute.subtype, tei_att.dimensions.attributes, attribute type { text }?, attribute value { text }?, tei_macro.phraseSeq.limited }⚓ |
<alt> (alternation) identifies an alternation or a set of choices among elements or passages. [16.8. Alternation] | |||||||||||||||||||||||||
Module | linking — Formal specification | ||||||||||||||||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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)
| ||||||||||||||||||||||||
Member of | |||||||||||||||||||||||||
Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname | ||||||||||||||||||||||||
May contain | Empty element | ||||||||||||||||||||||||
Example | <alt mode="excl" target="#we.fun #we.sun"
weights="0.5 0.5"/> | ||||||||||||||||||||||||
Content model | <content> <empty/> </content> ⚓ | ||||||||||||||||||||||||
Schema Declaration | element alt { tei_att.global.attributes, tei_att.pointing.attribute.targetLang, tei_att.pointing.attribute.evaluate, tei_att.typed.attributes, attribute target { list { * } }?, attribute mode { "excl" | "incl" }?, attribute weights { list { * } }?, empty }⚓ |
<altGrp> (alternation group) groups a collection of <alt> elements and possibly pointers. [16.8. Alternation] | |||||||||
Module | linking — Formal specification | ||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||||
Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname | ||||||||
May contain | |||||||||
Note | Any number of alternations, pointers or extended pointers. | ||||||||
Example | <altGrp mode="excl">
<alt target="#dm #lt #bb"
weights="0.5 0.25 0.25"/>
<alt target="#rl #db" weights="0.5 0.5"/>
</altGrp> | ||||||||
Example | <altGrp mode="incl">
<alt target="#dm #rl" weights="0.90 0.90"/>
<alt target="#lt #rl" weights="0.5 0.5"/>
<alt target="#bb #rl" weights="0.5 0.5"/>
<alt target="#dm #db" weights="0.10 0.10"/>
<alt target="#lt #db" weights="0.45 0.90"/>
<alt target="#bb #db" weights="0.45 0.90"/>
</altGrp> | ||||||||
Content model | <content> <sequence> <classRef key="model.descLike" minOccurs="0" maxOccurs="unbounded"/> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="alt"/> <elementRef key="ptr"/> </alternate> </sequence> </content> ⚓ | ||||||||
Schema Declaration | element altGrp { tei_att.global.attributes, tei_att.pointing.group.attributes, attribute mode { "excl" | "incl" }?, ( tei_model.descLike*, ( tei_alt | tei_ptr )* ) }⚓ |
<analytic> (analytic level) contains bibliographic elements describing an item (e.g. an article or poem) published within a monograph or journal and not as an independent publication. [3.12.2.1. Analytic, Monographic, and Series Levels] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | core: biblStruct |
May contain | |
Note | May contain titles and statements of responsibility (author, editor, or other), in any order. The <analytic> element may only occur within a <biblStruct>, where its use is mandatory for the description of an analytic level bibliographic item. |
Example | <biblStruct>
<analytic>
<author>Chesnutt, David</author>
<title>Historical Editions in the States</title>
</analytic>
<monogr>
<title level="j">Computers and the Humanities</title>
<imprint>
<date when="1991-12">(December, 1991):</date>
</imprint>
<biblScope>25.6</biblScope>
<biblScope>377–380</biblScope>
</monogr>
</biblStruct> |
Content model | <content> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="author"/> <elementRef key="editor"/> <elementRef key="respStmt"/> <elementRef key="title"/> <classRef key="model.ptrLike"/> <elementRef key="date"/> <elementRef key="textLang"/> <elementRef key="idno"/> <elementRef key="availability"/> </alternate> </content> ⚓ |
Schema Declaration | element analytic { tei_att.global.attributes, ( tei_author | tei_editor | tei_respStmt | tei_title | tei_model.ptrLike | tei_date | tei_textLang | tei_idno | tei_availability )* }⚓ |
<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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list listBibl measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname |
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 { tei_att.global.attributes, tei_att.typed.attributes, empty }⚓ |
<annotation> represents an annotation following the Web Annotation Data Model. [16.10. The standOff Container] | |||||||||||||||||||||||||||
Module | linking — Formal specification | ||||||||||||||||||||||||||
Attributes | att.global (xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 (target, @targetLang, @evaluate)
| ||||||||||||||||||||||||||
Member of | |||||||||||||||||||||||||||
Contained by | linking: listAnnotation standOff | ||||||||||||||||||||||||||
May contain | |||||||||||||||||||||||||||
Example | <annotation xml:id="ann1"
motivation="linking" target="#Gallia">
<!-- See https://www.w3.org/TR/annotation-model/#lifecycle-information and
https://www.w3.org/TR/annotation-model/#agents -->
<respStmt xml:id="fred">
<resp>creator</resp>
<persName>Fred Editor</persName>
</respStmt>
<revisionDesc>
<change status="created"
when="2020-05-21T13:59:00Z" who="#fred"/>
<change status="modified"
when="2020-05-21T19:48:00Z" who="#fred"/>
</revisionDesc>
<!-- See https://www.w3.org/TR/annotation-model/#rights-information -->
<licence target="http://creativecommons.org/licenses/by/3.0/"/>
<!-- Multiple bodies -->
<!-- Pointers to sections of text in the same document -->
<ptr target="#string-range(c1p1s1,0,6)"/>
<ptr target="#string-range(c1p1s6,19,7)"/>
</annotation> | ||||||||||||||||||||||||||
Example | <annotation xml:id="TheCorrectTitle"
motivation="commenting" target="#line1">
<note>The correct title of this specification, and the correct full name of XML, is
"Extensible Markup Language". "eXtensible Markup Language" is just a spelling error.
However, the abbreviation "XML" is not only correct but, appearing as it does in the title
of the specification, an official name of the Extensible Markup Language. </note>
</annotation> | ||||||||||||||||||||||||||
Content model | <content> <sequence> <elementRef key="respStmt" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="revisionDesc" minOccurs="0" maxOccurs="unbounded"/> <elementRef key="licence" minOccurs="0" maxOccurs="unbounded"/> <classRef key="model.annotationPart.body" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content> ⚓ | ||||||||||||||||||||||||||
Schema Declaration | element annotation { tei_att.global.attribute.n, tei_att.global.attribute.xmllang, tei_att.global.attribute.xmlbase, tei_att.global.attribute.xmlspace, tei_att.global.rendition.attribute.rend, tei_att.global.rendition.attribute.style, tei_att.global.rendition.attribute.rendition, tei_att.global.linking.attribute.corresp, tei_att.global.linking.attribute.synch, tei_att.global.linking.attribute.sameAs, tei_att.global.linking.attribute.copyOf, tei_att.global.linking.attribute.next, tei_att.global.linking.attribute.prev, tei_att.global.linking.attribute.exclude, tei_att.global.linking.attribute.select, tei_att.global.analytic.attribute.ana, tei_att.global.facs.attribute.facs, tei_att.global.change.attribute.change, tei_att.global.responsibility.attribute.cert, tei_att.global.responsibility.attribute.resp, tei_att.global.source.attribute.source, tei_att.pointing.attribute.targetLang, tei_att.pointing.attribute.evaluate, attribute xml:id { text }, attribute target { list { + } }, attribute motivation { list { ( "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging" )+ } }?, ( tei_respStmt*, tei_revisionDesc*, tei_licence*, tei_model.annotationPart.body* ) }⚓ |
<annotationBlock> groups together various annotations, e.g. for parallel interpretations of a spoken segment. [8.4.6. Analytic Coding] | |
Module | spoken — Formal specification |
Attributes | att.ascribed (@who) att.timed (@start, @end) (att.duration (att.duration.w3c (@dur)) (att.duration.iso (@dur-iso)) ) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | |
May contain | |
Example | <annotationBlock who="#SPK1" start="#T2"
end="#T3" xml:id="ag20">
<u xml:id="u20">
<seg xml:id="seg37" type="utterance"
subtype="modeless">
<w xml:id="w46">Yeah</w>
</seg>
</u>
</annotationBlock>
<annotationBlock who="#SPK1" start="#T5"
end="#T6" xml:id="ag21">
<u xml:id="u21">
<seg xml:id="seg38" type="utterance"
subtype="modeless">
<w xml:id="w47">Mhm</w>
</seg>
</u>
</annotationBlock> |
Content model | <content> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="u"/> <elementRef key="spanGrp"/> <classRef key="model.global.spoken"/> </alternate> </content> ⚓ |
Schema Declaration | element annotationBlock { tei_att.ascribed.attributes, tei_att.timed.attributes, tei_att.global.attributes, ( tei_u | tei_spanGrp | tei_model.global.spoken )* }⚓ |
<appInfo> (application information) records information about an application which has edited the TEI file. [2.3.11. The Application Information Element] | |
Module | header — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
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 { tei_att.global.attributes, tei_model.applicationLike+ }⚓ |
<application> provides information about an application which has acted upon the document. [2.3.11. The Application Information Element] | |||||||||||||
Module | header — Formal specification | ||||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||||||||
Contained by | header: appInfo | ||||||||||||
May contain | |||||||||||||
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 { tei_att.global.attributes, tei_att.typed.attributes, tei_att.datable.attributes, attribute ident { text }, attribute version { text }, ( tei_model.labelLike+, ( tei_model.ptrLike* | tei_model.pLike* ) ) }⚓ |
<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.12.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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)) |
Member of | |
Contained by | header: editionStmt titleStmt |
May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo 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 { tei_att.global.attributes, tei_att.naming.attributes, tei_att.datable.attributes, tei_macro.phraseSeq }⚓ |
<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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | core: monogr header: publicationStmt |
May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan 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 { tei_att.global.attributes, tei_att.canonical.attributes, tei_macro.phraseSeq.limited }⚓ |
<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 — Formal specification | ||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||||
Contained by | header: publicationStmt | ||||||||
May contain | |||||||||
Note | A consistent format should be adopted | ||||||||
Example | <availability status="restricted">
<p>Available for academic research purposes only.</p>
</availability>
<availability status="free">
<p>In the public domain</p>
</availability>
<availability status="restricted">
<p>Available under licence from the publishers.</p>
</availability> | ||||||||
Example | <availability>
<licence target="http://opensource.org/licenses/MIT">
<p>The MIT License
applies to this document.</p>
<p>Copyright (C) 2011 by The University of Victoria</p>
<p>Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:</p>
<p>The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.</p>
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.</p>
</licence>
</availability> | ||||||||
Content model | <content> <alternate minOccurs="1" maxOccurs="unbounded"> <classRef key="model.availabilityPart"/> <classRef key="model.pLike"/> </alternate> </content> ⚓ | ||||||||
Schema Declaration | element availability { tei_att.global.attributes, tei_att.declarable.attributes, attribute status { "free" | "unknown" | "restricted" }?, ( tei_model.availabilityPart | tei_model.pLike )+ }⚓ |
<back> (back matter) contains any appendixes, etc. following the main part of a text. [4.7. Back Matter 4. Default Text Structure] | |
Module | textstructure — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
May contain | figures: figure notatedMusic table namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation textstructure: byline closer dateline div docAuthor docDate docEdition docImprint docTitle postscript signed titlePage titlePart trailer transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin |
Note | Because cultural conventions differ as to which elements are grouped as back matter and which as front matter, the content models for the <back> and <front> elements are identical. |
Example | <back>
<div type="appendix">
<head>The Golden Dream or, the Ingenuous Confession</head>
<p>TO shew the Depravity of human Nature, and how apt the Mind is to be misled by Trinkets
and false Appearances, Mrs. Two-Shoes does acknowledge, that after she became rich, she
had like to have been, too fond of Money
<!-- .... -->
</p>
</div>
<!-- ... -->
<div type="epistle">
<head>A letter from the Printer, which he desires may be inserted</head>
<salute>Sir.</salute>
<p>I have done with your Copy, so you may return it to the Vatican, if you please;
<!-- ... -->
</p>
</div>
<div type="advert">
<head>The Books usually read by the Scholars of Mrs Two-Shoes are these and are sold at Mr
Newbery's at the Bible and Sun in St Paul's Church-yard.</head>
<list>
<item n="1">The Christmas Box, Price 1d.</item>
<item n="2">The History of Giles Gingerbread, 1d.</item>
<!-- ... -->
<item n="42">A Curious Collection of Travels, selected from the Writers of all Nations,
10 Vol, Pr. bound 1l.</item>
</list>
</div>
<div type="advert">
<head>By the KING's Royal Patent, Are sold by J. NEWBERY, at the Bible and Sun in St.
Paul's Church-Yard.</head>
<list>
<item n="1">Dr. James's Powders for Fevers, the Small-Pox, Measles, Colds, &c. 2s.
6d</item>
<item n="2">Dr. Hooper's Female Pills, 1s.</item>
<!-- ... -->
</list>
</div>
</back> |
Content model | <content> <sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.frontPart"/> <classRef key="model.pLike.front"/> <classRef key="model.pLike"/> <classRef key="model.listLike"/> <classRef key="model.global"/> </alternate> <alternate minOccurs="0"> <sequence> <classRef key="model.div1Like"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.frontPart"/> <classRef key="model.div1Like"/> <classRef key="model.global"/> </alternate> </sequence> <sequence> <classRef key="model.divLike"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.frontPart"/> <classRef key="model.divLike"/> <classRef key="model.global"/> </alternate> </sequence> </alternate> <sequence minOccurs="0"> <classRef key="model.divBottomPart"/> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.divBottomPart"/> <classRef key="model.global"/> </alternate> </sequence> </sequence> </content> ⚓ |
Schema Declaration | element back { tei_att.global.attributes, tei_att.declaring.attributes, ( ( tei_model.frontPart | tei_model.pLike.front | tei_model.pLike | tei_model.listLike | tei_model.global )*, ( ( tei_model.div1Like, ( tei_model.frontPart | tei_model.div1Like | tei_model.global )* ) | ( tei_model.divLike, ( tei_model.frontPart | tei_model.divLike | tei_model.global )* ) )?, ( tei_model.divBottomPart, ( tei_model.divBottomPart | tei_model.global )* )? ) }⚓ |
<bibl> (bibliographic citation) contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. [3.12.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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) |
Member of | |
Contained by | core: add bibl cit corr del desc emph head hi item l listBibl meeting note orig p q quote ref reg relatedItem said sic stage textLang title unclear namesdates: climate event location object occupation org person personGrp persona place population state terrain trait spoken: broadcast scriptStmt u writing textstructure: body div docEdition imprimatur postscript salute signed titlePart trailer |
May contain | core: abbr add address author bibl biblScope cb choice citedRange corr date del distinct editor ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp meeting mentioned milestone name note noteGrp num orig pb ptr pubPlace publisher q ref reg relatedItem respStmt rs series sic soCalled term textLang time title unclear unit figures: figure notatedMusic gaiji: g namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listRelation location nameLink objectIdentifier objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan 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 { tei_att.global.attributes, tei_att.declarable.attributes, tei_att.typed.attributes, tei_att.sortable.attributes, tei_att.docStatus.attributes, ( text | tei_model.gLike | tei_model.highlighted | tei_model.pPart.data | tei_model.pPart.edit | tei_model.segLike | tei_model.ptrLike | tei_model.biblPart | tei_model.global )* }⚓ |
<biblFull> (fully-structured bibliographic citation) contains a fully-structured bibliographic citation, in which all components of the TEI file description are present. [3.12.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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | core: add cit corr del desc emph head hi item l listBibl meeting note orig p q quote ref reg relatedItem said sic stage textLang title unclear namesdates: climate event location object occupation org person personGrp persona place population state terrain trait spoken: broadcast scriptStmt u writing textstructure: body div docEdition imprimatur postscript salute signed titlePart trailer |
May contain | |
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" maxOccurs="unbounded"/> <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 { tei_att.global.attributes, tei_att.declarable.attributes, tei_att.sortable.attributes, tei_att.docStatus.attributes, ( ( ( tei_titleStmt, tei_editionStmt?, tei_extent?, tei_publicationStmt, tei_seriesStmt*, tei_notesStmt? ), tei_sourceDesc* ) | ( tei_fileDesc, tei_profileDesc ) ) }⚓ |
<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.12.2.5. Scopes and Ranges in Bibliographic Citations] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | header: seriesStmt |
May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo 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 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 { tei_att.global.attributes, tei_att.citing.attributes, tei_macro.phraseSeq }⚓ |
<biblStruct> (structured bibliographic citation) contains a structured bibliographic citation, in which only bibliographic sub-elements appear and in a specified order. [3.12.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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) |
Member of | |
Contained by | core: add cit corr del desc emph head hi item l listBibl meeting note orig p q quote ref reg relatedItem said sic stage textLang title unclear namesdates: climate event location object occupation org person personGrp persona place population state terrain trait spoken: broadcast scriptStmt u writing textstructure: body div docEdition imprimatur postscript salute signed titlePart trailer |
May contain | |
Example | <biblStruct>
<monogr>
<author>Blain, Virginia</author>
<author>Clements, Patricia</author>
<author>Grundy, Isobel</author>
<title>The Feminist Companion to Literature in English: women writers from the middle ages
to the present</title>
<edition>first edition</edition>
<imprint>
<publisher>Yale University Press</publisher>
<pubPlace>New Haven and London</pubPlace>
<date>1990</date>
</imprint>
</monogr>
</biblStruct> |
Content model | <content> <sequence> <elementRef key="analytic" minOccurs="0" maxOccurs="unbounded"/> <sequence minOccurs="1" maxOccurs="unbounded"> <elementRef key="monogr"/> <elementRef key="series" minOccurs="0" maxOccurs="unbounded"/> </sequence> <alternate minOccurs="0" maxOccurs="unbounded"> <classRef key="model.noteLike"/> <classRef key="model.ptrLike"/> <elementRef key="relatedItem"/> <elementRef key="citedRange"/> </alternate> </sequence> </content> ⚓ |
Schema Declaration | element biblStruct { tei_att.global.attributes, tei_att.declarable.attributes, tei_att.typed.attributes, tei_att.sortable.attributes, tei_att.docStatus.attributes, ( tei_analytic*, ( tei_monogr, tei_series* )+, ( tei_model.noteLike | tei_model.ptrLike | tei_relatedItem | tei_citedRange )* ) }⚓ |
<binary> (binary value) represents the value part of a feature-value specification which can contain either of exactly two possible values. [18.2. Elementary Feature Structures and the Binary Feature Value] | |||||||||
Module | iso-fs — Formal specification | ||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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.datcat (@datcat, @valueDatcat, @targetDatcat)
| ||||||||
Member of | |||||||||
Contained by | |||||||||
May contain | Empty element | ||||||||
Note | The value attribute may take any value permitted for attributes of the W3C datatype Boolean: this includes for example the strings | ||||||||
Example | <f name="strident">
<binary value="true"/>
</f>
<f name="exclusive">
<binary value="false"/>
</f> | ||||||||
Content model | <content> <empty/> </content> ⚓ | ||||||||
Schema Declaration | element binary { tei_att.global.attributes, tei_att.datcat.attributes, attribute value { text }, empty }⚓ |
<birth> (birth) contains information about a person's birth, such as its date and place. [15.2.2. The Participant Description] | |||||||||||
Module | namesdates — Formal specification | ||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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)
| ||||||||||
Member of | |||||||||||
Contained by | |||||||||||
May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo 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 { tei_att.global.attributes, tei_att.editLike.attributes, tei_att.datable.attributes, tei_att.dimensions.attributes, tei_att.naming.attributes, tei_att.typed.attribute.subtype, attribute type { text }?, tei_macro.phraseSeq }⚓ |
<body> (text body) contains the whole body of a single unitary text, excluding any front or back matter. [4. Default Text Structure] | |
Module | textstructure — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | core: bibl biblStruct cb cit desc divGen ellipsis gap head index l label lb lg list listBibl meeting milestone note noteGrp p pb q quote said sp stage figures: figure notatedMusic table header: biblFull namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation 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"> <alternate minOccurs="1" maxOccurs="1"> <elementRef key="schemaSpec"/> <classRef key="model.common"/> </alternate> <classRef key="model.global" minOccurs="0" maxOccurs="unbounded"/> </sequence> <alternate minOccurs="0"> <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 { tei_att.global.attributes, tei_att.declaring.attributes, ( tei_model.global*, ( tei_model.divTop, ( tei_model.global | tei_model.divTop )* )?, ( tei_model.divGenLike, ( tei_model.global | tei_model.divGenLike )* )?, ( ( tei_model.divLike, ( tei_model.global | tei_model.divGenLike )* )+ | ( tei_model.div1Like, ( tei_model.global | tei_model.divGenLike )* )+ | ( ( ( schemaSpec | tei_model.common ), tei_model.global* )+, ( ( tei_model.divLike, ( tei_model.global | tei_model.divGenLike )* )+ | ( tei_model.div1Like, ( tei_model.global | tei_model.divGenLike )* )+ )? ) ), ( tei_model.divBottom, tei_model.global* )* ) }⚓ |
<broadcast> (broadcast) describes a broadcast used as the source of a spoken text. [8.2. Documenting the Source of Transcribed Speech 15.3.2. Declarable Elements] | |
Module | spoken — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | spoken: recording |
May contain | |
Example | <broadcast>
<bibl>
<author>Radio Trent</author>
<title>Gone Tomorrow</title>
<respStmt>
<resp>Presenter</resp>
<name>Tim Maby</name>
</respStmt>
<respStmt>
<resp>Producer</resp>
<name>Mary Kerr</name>
</respStmt>
<date when="1989-06-12T12:30:00">12 June 89, 1230 pm</date>
</bibl>
</broadcast> |
Content model | <content> <alternate> <classRef key="model.pLike" minOccurs="1" maxOccurs="unbounded"/> <classRef key="model.biblLike"/> <elementRef key="recording"/> </alternate> </content> ⚓ |
Schema Declaration | element broadcast { tei_att.global.attributes, tei_att.declarable.attributes, ( tei_model.pLike+ | tei_model.biblLike | tei_recording ) }⚓ |
<byline> (byline) contains the primary statement of responsibility given for a work on its title page or at the head or end of the work. [4.2.2. Openers and Closers 4.5. Front Matter] | |
Module | textstructure — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | |
May contain | core: abbr add address cb choice corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q ref reg rs ruby sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait textstructure: docAuthor transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
Note | The byline on a title page may include either the name or a description for the document's author. Where the name is included, it may optionally be tagged using the <docAuthor> element. |
Example | <byline>Written by a CITIZEN who continued all the
while in London. Never made publick before.</byline> |
Example | <byline>Written from her own MEMORANDUMS</byline> |
Example | <byline>By George Jones, Political Editor, in Washington</byline> |
Example | <byline>BY
<docAuthor>THOMAS PHILIPOTT,</docAuthor>
Master of Arts,
(Somtimes)
Of Clare-Hall in Cambridge.</byline> |
Content model | <content> <alternate minOccurs="0" maxOccurs="unbounded"> <textNode/> <classRef key="model.gLike"/> <classRef key="model.phrase"/> <elementRef key="docAuthor"/> <classRef key="model.global"/> </alternate> </content> ⚓ |
Schema Declaration | element byline { tei_att.global.attributes, ( text | tei_model.gLike | tei_model.phrase | tei_docAuthor | tei_model.global )* }⚓ |
<c> (character) represents a character. [17.1. Linguistic Segment Categories] | |
Module | analysis — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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.datcat (@datcat, @valueDatcat, @targetDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation) |
Member of | |
Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure mentioned name note num orig p pubPlace publisher q quote rb ref reg rs rt said sic soCalled speaker stage street term textLang time title unclear unit figures: cell namesdates: addName affiliation birth bloc country death district education faith floruit forename genName gender geogFeat geogName nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer |
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 { tei_att.global.attributes, tei_att.segLike.attributes, tei_att.typed.attributes, tei_att.notated.attributes, tei_macro.xtext }⚓ |
<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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
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 { tei_att.global.attributes, tei_att.patternReplacement.attributes, tei_model.pLike* }⚓ |
<calendar> (calendar) describes a calendar or dating system used in a dating formula in the text. [2.4.5. Calendar Description] | |
Module | header — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
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 { tei_att.global.attributes, tei_att.pointing.attributes, tei_model.pLike+ }⚓ |
<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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
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 { tei_att.global.attributes, tei_calendar+ }⚓ |
<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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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) |
Contained by | header: category |
May contain | core: abbr address choice date distinct email emph expan foreign gloss hi measure measureGrp mentioned name num ptr q ref rs soCalled term time title unit corpus: textDesc header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait 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 { tei_att.global.attributes, tei_att.canonical.attributes, ( text | tei_model.limitedPhrase | tei_model.catDescPart )* }⚓ |
<catRef> (category reference) specifies one or more defined categories within some taxonomy or text typology. [2.4.3. The Text Classification] | |||||||
Module | header — Formal specification | ||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||
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"/>
<!-- elsewhere -->
<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 { tei_att.global.attributes, tei_att.pointing.attributes, attribute scheme { text }?, empty }⚓ |
<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 — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
May contain | |
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"/> <elementRef key="equiv"/> <elementRef key="gloss"/> </alternate> </alternate> <elementRef key="category" minOccurs="0" maxOccurs="unbounded"/> </sequence> </content> ⚓ |
Schema Declaration | element category { tei_att.global.attributes, ( ( tei_catDesc+ | ( tei_model.descLike | equiv | tei_gloss )* ), tei_category* ) }⚓ |
<cb> (column beginning) marks the beginning of a new column of a text on a multi-column page. [3.11.3. Milestone Elements] | |
Module | core — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list listBibl measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname |
May contain | Empty element |
Note | On this element, the global n attribute indicates the number or other value associated with the column which follows the point of insertion of this <cb> element. Encoders should adopt a clear and consistent policy as to whether the numbers associated with column breaks relate to the physical sequence number of the column in the whole text, or whether columns are numbered within the page. The <cb> element is placed at the head of the column to which it refers. |
Example | Markup of an early English dictionary printed in two columns: <pb/>
<cb n="1"/>
<entryFree>
<form>Well</form>, <sense>a Pit to hold Spring-Water</sense>:
<sense>In the Art of <hi rend="italic">War</hi>, a Depth the Miner
sinks into the Ground, to find out and disappoint the Enemies Mines,
or to prepare one</sense>.
</entryFree>
<entryFree>To <form>Welter</form>, <sense>to wallow</sense>, or
<sense>lie groveling</sense>.</entryFree>
<!-- remainder of column -->
<cb n="2"/>
<entryFree>
<form>Wey</form>, <sense>the greatest Measure for dry Things,
containing five Chaldron</sense>.
</entryFree>
<entryFree>
<form>Whale</form>, <sense>the greatest of
Sea-Fishes</sense>.
</entryFree> |
Content model | <content> <empty/> </content> ⚓ |
Schema Declaration | element cb { tei_att.global.attributes, tei_att.typed.attributes, tei_att.edition.attributes, tei_att.spanning.attributes, tei_att.breaking.attributes, empty }⚓ |
<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 — Formal specification | ||||||
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)
| ||||||
Contained by | header: listChange revisionDesc | ||||||
May contain | core: abbr add address bibl biblStruct cb choice cit corr date del desc distinct ellipsis email emph expan foreign gap gloss graphic hi index l label lb lg list listBibl measure measureGrp media mentioned milestone name note noteGrp num orig p pb ptr q quote ref reg rs ruby said sic soCalled sp stage term time title unclear unit figures: figure formula notatedMusic table gaiji: g 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 persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo 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 { tei_att.ascribed.attributes, tei_att.datable.attributes, tei_att.docStatus.attributes, tei_att.global.attributes, tei_att.typed.attributes, attribute target { list { + } }?, tei_macro.specialPara }⚓ |
<channel> (primary channel) describes the medium or channel by which a text is delivered or experienced. For a written text, this might be print, manuscript, email, etc.; for a spoken one, radio, telephone, face-to-face, etc. [15.2.1. The Text Description] | |||||||||
Module | corpus — Formal specification | ||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |||||||||
Contained by | corpus: textDesc | ||||||||
May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data | ||||||||
Example | <channel mode="s">face-to-face conversation</channel> | ||||||||
Content model | <content> <macroRef key="macro.phraseSeq.limited"/> </content> ⚓ | ||||||||
Schema Declaration | element channel { tei_att.global.attributes, attribute mode { "s" | "w" | "sw" | "ws" | "m" | "x" }?, tei_macro.phraseSeq.limited }⚓ |
<char> (character) provides descriptive information about a character. [5.2. Markup Constructs for Representation of Characters and Glyphs] | |
Module | gaiji — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Example | <char xml:id="circledU4EBA">
<localProp name="Name"
value="CIRCLED IDEOGRAPH 4EBA"/>
<localProp name="daikanwa" value="36"/>
<unicodeProp name="Decomposition_Mapping"
value="circle"/>
<mapping type="standard">人</mapping>
</char> |
Content model | <content> <alternate minOccurs="0" maxOccurs="unbounded"> <elementRef key="unicodeProp"/> <elementRef key="unihanProp"/> <elementRef key="localProp"/> <elementRef key="mapping"/> <elementRef key="figure"/> <classRef key="model.graphicLike"/> <classRef key="model.noteLike"/> <classRef key="model.descLike"/> </alternate> </content> ⚓ |
Schema Declaration | element char { tei_att.global.attributes, ( tei_unicodeProp | tei_unihanProp | tei_localProp | tei_mapping | tei_figure | tei_model.graphicLike | tei_model.noteLike | tei_model.descLike )* }⚓ |
<charDecl> (character declarations) provides information about nonstandard characters and glyphs. [5.2. Markup Constructs for Representation of Characters and Glyphs] | |
Module | gaiji — Formal specification |
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @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 | |
Contained by | header: encodingDesc |
May contain | |
Example | <charDecl>
<char xml:id="aENL">
<unicodeProp name="Name"
value="LATIN LETTER ENLARGED SMALL A"/>
<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 { tei_att.global.attributes, ( tei_desc?, ( tei_char | tei_glyph )+ ) }⚓ |