(unknown project)

TEI in Libraries level 3

Best Practices for TEI in Libraries

Level 3: Simple Analysis

Setting

This is the level 3 portion of the Best Practices for TEI in Libraries. This document is not intended to stand alone, but rather to be considered in concert with the entire TEI in Libraries recommendations.

Table of contents

1. Level 3: Simple Analysis

1.1. Reference

Note that this is intended to be a ‘TEI conformant’ customization, per P5 section 23.3.

1.2. Purpose

To create a stand-alone electronic text and identify hierarchy (logical structure) and typography without content analysis being of primary importance.

1.3. Rationale

Encoding at this level provides the foundation for upgrading to higher levels of encoding. Level 3 generally requires some human editing, but the features to be encoded are determined by the logical structure and appearance of the text and not specialized content analysis.

Level 3 texts identify front and back matter, textual divisions, and all paragraph breaks. Floating texts, or sub-texts like a poem or letter embedded in the greater text, are supported in this level. The finer granularity of encoding these features, as well as figures, notes, and all changes of typography, allows a range of options for display, delivery, and searching. For example, one has the option of identifying, and therefore specifying, the display characteristics of different typographic styles, and regularizing the display and placement of note text.

Level 3 texts can stand alone as text without page images, and therefore can be uploaded, downloaded, and delivered quickly, and require less storage space than digital collections with page images. However, the simple level of structural analysis and absence of specialized content analysis reflected in Level 3 encoding may make it desirable for some, depending on project priorities, to include page images in order to provide users with a fuller set of resources.

Level 3 is most suitable for projects with the following characteristics

1.4. Workflow

Level 3 texts can be created by conversion from an electronic source such as an HTML file or word-processor document or from a print source, either through OCR or keyboarding. They can be generated trivially by converting from outsourced double-keyboarded texts conforming to TEI Tite, though some granularity of encoding will be lost in the translation.

1.5. Element Recommendations for Level 3

Use all elements specified in Levels 1 and 2 except <ab>, plus the following:

<front>, <back>Recommended if present.
<div> or <div1>At least one is recommended within each of <front>, <body>, and <back>; type attribute is recommended.
<p>Recommended for paragraphs in prose.
<lg> and <l>Recommended for identifying groups of lines and lines, respectively.
<figure> and appropriate child elementsRecommended to refer to illustrative images and descriptive information about those images.
<floatingText>Optionally used to indicate a floating text.
<note>Recommended for notes.
<ptr> and <ref>If a table of contents is encoded, recommended for linking to sections of the document. If notes are encoded at the point they occur in the text or at another point convenient when converting from a born-digital source document, recommended for encoding the point of reference.
<hi>Recommended to indicate changes in typeface; rend attribute is optional.
<list> and <item>Optionally used to indicate ordered and unordered list structures.
<table>, <row>, and <cell>Optionally used to indicate table structures.
<lb>Optionally used to indicate the beginning of a new line.
<cb>Optionally used to indicate the beginning of a new column.
<listBibl>Optionally use in support of bibliographies as a child of <div type="bibliogrpahy">. Should contain a series of <bibl> elements.
<bibl>Contains a single bibliographic entry. Phrase level markup (e.g., <hi>) is optional. Further structural markup (e.g., <author>) is not used at level 3.

1.6. General Level 3 Recommendations

1.6.1. Forme Work

Running heads, catch words, page numbers, signatures, and other artifacts derived from printing should not be included in Level 3, with the exception of page numbers, which are recorded using the n attribute on <pb>. If upgrading a text from Level 1 or Level 2 that was generated using OCR, discard the forme work information.

1.6.2. Level 3 Figures

<figure> groups elements representing or containing graphic information such as an illustration or figure; in this context <figure> contains the following elements:

<head>
for a caption label (e.g., ‘Figure 1’) and/or a literal transcription of a caption. Use when this feature is present in the source document.
<p>
for a literal transcription of a caption (could be used in conjunction with the <head> tag if a caption label is present). Use when this feature is present in the source document.
<figDesc>
for free text description of the image for use when documenting an image without displaying it. This is mandatory in order to create digital texts that will be accessible to the visually impaired.
<graphic>
for pointing to the URI of the image itself using a url attribute and containing other presentation instructions such as dimension at which the graphic should be displayed, etc. This is mandatory in order to point to the corresponding image file.
An example of frontispiece encoding:
<front>  <div type="frontispiece">   <figure>    <head>Sojourner Truth.</head>    <figDesc>Woodcut of Sojourner Truth.</figDesc>    <graphic url="http://docsouth.unc.edu/neh/truth50/frontis.html"     scale="0.5"/>   </figure>  </div>  <ref target="Etc">...</ref> </front>
Narrative of Sojourner Truth, a Northern Slave, Emancipated from Bodily Servitude by the State of New York, in 1828

1.6.3. Tables of Contents

You may wish not to include front matter content such as table of contents or lists of illustrations, especially if you plan to automatically generate the contents or lists of illustrations. If you do, however, plan to manually encode the table of contents (or lists of illustrations and similar content), use a <div> (or <div1>) element with an appropriate type attribute (e.g., <div type="contents">). Within this division, use the <list> element to mark up the table of contents, list of illustrations, etc. Each list item should have a <ptr> or <ref> element with a target attribute referencing an xml:id attribute on the <pb> or on the <div> (or <div1>) of the referenced page or section. Use <ref> if you wish to transcribe page numbers in the table of contents; use <ptr> if you do not.

1.6.4. Notes

Use the <note> element to encode the text of a margin note, footnote, endnote, or other note found in the source document. If a point of attachment is marked with a siglumn (such as an asterisk or superscript number), encode the siglum with a <ref> element. Alternatively, if there is no marked point of attachment, insert a <ptr> at the most likely implied point of attachment for the note.

The text of the note (inside a <note> element) may either (a) be left where it occurs in the layout of the page (as may be more convenient in the case of conversion from OCR text) or may (b) be moved so that the <note> occurs just following the <ref> or <ptr> marking the point of attachment. If a note span pages, be sure to insert a <pb> to mark the start of a new page. Similarly, if the note in the source document begins on a different page from the place of reference, a <pb> should be inserted before the first word of the note within the <note> to record this.

The siglum is often repeated at the beginning of the note to aid the reader in matching the siglum in the text to the note. Encode any siglum within the note using <label>.

Here is an example encoded according to method (a)—first the sigla:
<p>The three little pigs built their houses out of straw,<ref target="#n_a1">1</ref> sticks,<ref target="#n_a2">2</ref> and bricks.<ref target="#n_a3">3</ref> </p>

And then the annotations themselves, encoded as <note> elements inside a division in the backmatter that holds the endnotes:

<back>  <div type="endnotes">   <head>The Collected End-notes</head>   <note place="bottomanchored="true"    xml:id="n_a1">    <label>1</label>      not to be confused with hay</note>   <note place="bottomanchored="true"    xml:id="n_a2">    <label>2</label>      or lumber according to some sources</note>   <note place="bottomanchored="true"    xml:id="n_a3">    <label>3</label>      probably fired clay bricks</note>  </div> </back>
Here is an example encoded according to method (b), with notes encoded right after the point of attachment:
<p>The three little pigs built their houses out of straw,<ref target="#n_b1">1</ref>  <note place="bottomanchored="true"   xml:id="n_b1">   <label>1</label> not to be confused with hay  </note> sticks,<ref target="#n_b2">2</ref>  <note place="bottomanchored="true"   xml:id="n_b2">   <label>2</label> or lumber according to some sources  </note> and bricks.<ref target="#n_b3">3</ref>  <note place="bottomanchored="true"   xml:id="n_b3">   <label>3</label> probably fired clay bricks  </note> </p>

1.7. Level 3 Examples

Note that for technical reasons the namespace is not shown in these examples, but it should always be supplied on the root <TEI> element, e.g.: <TEI xmlns="http://www.tei-c.org/ns/1.0" xml:id="MBFG0236">.

1.7.1. Level 3 Basic Structure: Prose

<TEI xml:id="MBFG0236" xmlns="http://www.tei-c.org/ns/1.0">  <teiHeader xml:lang="en"> <!-- header goes here -->  </teiHeader>  <text xml:lang="en">   <front>    <div type="frontispiece">[figure]</div>    <titlePage>[text]</titlePage>    <div type="dedication">[text]</div>    <div type="contents">[text]</div>   </front>   <body>    <div type="book">     <head>[book title]</head>     <div type="chapter">[text]</div>     <div type="chapter">[text]</div>     <div type="chapter">[text]</div>     <div type="chapter">[text]</div>     <div type="chapter">[text]</div>    </div>   </body>   <back>    <div type="appendix">[text]</div>    <div type="index">[text]</div>   </back>  </text> </TEI>

1.7.2. Level 3 Basic Structure: Verse

<TEI xml:id="VAA2383" xmlns="http://www.tei-c.org/ns/1.0">  <teiHeader xml:lang="en"> <!-- header goes here -->  </teiHeader>  <text xml:lang="en">   <front>    <titlePage>[text]</titlePage>    <div type="dedication">[text]</div>    <div type="contents">[text]</div>   </front>   <body>    <div type="book">     <head>[book title]</head>     <div type="part">      <head>[section title]</head>      <div type="poem">       <head>THE DAYS GONE BY.</head>       <lg>        <l>O the days gone by! O the days gone by!</l>        <l>The apples in the orchard, and the pathway through the rye;</l>        <l>The chirrup of the robin, and the whistle of the quail</l>        <l>As he piped across the meadows sweet as any nightingale;</l>        <l>When the bloom was on the clover, and the blue was in the sky,</l>        <l>And my happy heart brimmed overin the happy days gone by.</l>       </lg>       <lg>[lines of poetry]</lg>       <lg>[lines of poetry]</lg>       <lg>[lines of poetry]</lg>      </div>     </div>    </div>   </body>  </text> </TEI>

1.7.3. Level 3 Table of Contents

<!--target attribute references page break identifier--> <div type="contents">  <head>CONTENTS</head>  <list type="simple">   <item>I. A Boy and His Dog <ref target="#VAA2383_011"     rend="text-align: right">3</ref>   </item>   <item>II. Romance <ref target="#VAA2383_020"     rend="text-align: right">12</ref>   </item>   <item>III. The Costume <ref target="#VAA2383_029"     rend="text-align: right">21</ref>   </item>   <item>IV. Desperation <ref target="#VAA2383_038"     rend="text-align: right">30</ref>   </item>   <item>V. The Pageant of the Table Round <ref target="#VAA2383_046"     rend="text-align: right">38</ref>   </item>  </list> </div>

1.7.4. Level 3 Chapter with Letter

<div type="chapter">  <pb xml:id="VAA2383_126n="118"/>  <head type="main">CHAPTER XIV</head>  <head type="subtitle">MAURICE LEVY'S CONSTITUTION</head>  <p>   <hi rend="font-weight: bold">L</hi>O, SAM!" said Maurice cautiously. "What you    doin'?"</p>  <p>Penrod at that instant had a singular experiencean intellectual shock like a flash    of fire in the brain. Sitting in darkness, a great light flooded him with wild    brilliance. He gasped!</p> <!--Text removed from example--> <p>"What you doin'?" asked Maurice for the third time, Sam Williams not having decided    upon a reply.</p>  <pb xml:id="VAA2383_127n="119"/>  <p>It was Penrod who answered.</p>  <p>"Drinkin' lickrish water," he said simply, and wiped his mouth with such delicious    enjoyment that Sam's jaded thirst was instantly stimulated. He took the bottle    eagerly from Penrod.</p>  <p>"A-a-h!" exclaimed Penrod, smacking his lips. "That was a good un!"</p> <!--Text removed from example--> <p>Penrod uttered some muffled words and then waved both armseither in response or as    an expression of his condition of mind; it may have been a gesture of despair. How    much intention there was in this actobviously so rash, considering the position he    occupiedit is impossible to say. Undeniably there must remain a suspicion of    deliberate purpose.</p> <!--Text removed from example--> <pb xml:id="VAA2383_138n="130"/>  <p>The damsel curtsied again and handed him the following communication, addressed to    herself: </p>  <floatingText>   <body>    <div type="letter">     <p>"Dear madam Please excuse me from dancing the cotilo with you this afternoon          as I have fell off the barn</p>     <p>"Sincerly yours<lb/> "<hi rend="font-variant: small-caps">Penrod            Schofield</hi>." </p>    </div>   </body>  </floatingText> </div>

1.7.5. Level 3 Alger Hiss document

<TEI xml:id="someid3" xmlns="http://www.tei-c.org/ns/1.0">  <teiHeader xml:lang="en"> <!-- header goes here -->  </teiHeader>  <text xml:lang="en">   <body>    <div1>     <pb n="113facs="00000001.tif"/>     <head>POINT VIII. BECAUSE OF UNLAWFUL SURVEILLANCE, PETITIONER'S CONVICTION          SHOULD BE VACATED; ALTERNATIVELY, DISCOVERY AND A HEARING SHOULD BE          ORDERED.</head>     <p>The nature and extent of surveillance of Hiss, his family and associates was          not known at the time of trial by the defense. Even now, with the release of          some of the govern­ ment documents concerning FBI investigative techniques          regarding Hiss, the full extent of surveillance -- wiretapping, mail open­          ings, mail covers, physical surveillance, and other intrusive techniques -- is          still not 'clear. Nevertheless, it is apparent that information gathered          through the exploitation of unlawful wiretaps and other illegal surveillance          was used at trial and consequently the conviction must be reversed.          Alternatively, further discovery and a hearing is essential to a fair deter­          mination regarding these issues.</p>     <p>FBI surveillance of Hiss began in earnest in 1941 with the institution of a          mail cover on his incoming correspondence at his home in connection with an          FBI investigation of possible Hatch Act violations. CN Ex. 98A. Another mail          cover was placed <pb n="114facs="00000002.tif"/> on the Hiss mail in 1945,          and at the same time the FBI obtained toll call records from the Hiss          residence Telephone for the years 1943 and 1944 as well. CN Ex. 99. In          September, 1945, the FBI intercepted telegrams to Hiss as well. CN Ex.          100.</p>     <p>In late November, 1945, FBI surveillance of the Hiss residence in Washington,          D.C., escalated. For the third time, a mail cover was instituted beginning on          November 28, 1945, which was continued at least until 1946. CN Ex. 101 at p.          70; CN Ex. 102. Continuous physical surveillance of Hiss was begun as well. CN          Ex. 101 at p. 72. Although this twenty-four-hour surveillance was discontinued          on December 14, 1945, physical surveillance was conducted frequently at          various times until September, 1947. <ptr target="#n68">68</ptr>      <note place="bottomanchored="true"       xml:id="n68">       <label>68</label>Also before            1947, a letter from Priscilla Hiss addressed to her son,            Timothy Hobson, was intercepted and its contents read. CN Ex. 100A at p.            167. In approximately March, 1947, a letter from a Michael Greenberg            addressed to petitioner re­ garding an application for employment with the            United Nations was also intercepted, in a manner not revealed by the docu­            ments. CN Ex. 100B</note> CN Ex. 102; CN Ex. 103.</p>     <p>The most intrusive invasion of petitioner's rights <pb n="115facs="00000003.tif"/> occurred from December 13, 1945 until the Hisses moved          from Washington, D.C. to New York City on September 13, 1947. A "technical          surveillance," -- a wiretap -- was placed on the Hiss telephone at their          residence on P Street-in Washington, D.C. The logs of this surveillance          constitute twenty-nine volumes of FBI serials and are roughly 2,500 pages in          length, in which an enormous amount of information concerning the Hisses' per­          sonal lives, relationships with friends and associates, and habits is          recorded.</p>     <p>The wiretap was installed following FBI Director Hoover's application to the          Attorney General for authorization, <ptr target="n69">69</ptr>      <note place="bottomanchored="true"       xml:id="n69">       <label>69</label>Hoover's initial request was answered by a note reques­ ting            information on Hiss. CN Ex. 104. Additional information was furnished by            letter dated November 30, 1945. CN Ex. 105.</note> although no written          authorization appears in the documents released to Hiss. The purpose of the          application was to gather information regarding Hiss' alleged contacts with          Soviet espionage agents and communists in government service, general          allegations which had been made by Elizabeth Bentley and Chambers.</p>     <p>As one would expect, the interception of every telephone</p>    </div1>   </body>  </text> </TEI>

1.8. Specification

1.8.1. Schema lib3: Added components

1.8.1.1. <p>
<p>
Modulederived-module-lib3
Contained by
header: hyphenation
May containEmpty element
Content model
<content>
 <valList type="closed">
  <valItem ident="All hyphens in source document encoded as U+2010."/>
  <valItem ident="All hyphens in source document encoded as U+002D."/>
  <valItem ident="Hyphens in source document encoded as U+2010. Line-ending hyphens 
 differentiated with @break of immediately following <lb> element."/>
  <valItem ident="Hyphens in source document encoded as U+002D. Line-ending hyphens 
 differentiated with @break of immediately following <lb> element."/>
  <valItem ident="Hyphens in source document encoded as U+2010 inside a <pc>. Line-ending 
 hyphens differentiated with @force of the <pc> and @break of immediately 
 following <lb> element."/>
  <valItem ident="Hyphens in source document encoded as U+202D inside a <pc>. Line-ending 
 hyphens differentiated with @force of the <pc> and @break of immediately 
 following <lb> element."/>
 </valList>
</content>
    
Legal values are:
All hyphens in source document encoded as U+2010.
All hyphens in source document encoded as U+002D.
Hyphens in source document encoded as U+2010. Line-ending hyphens differentiated with @break of immediately following <lb> element.
Hyphens in source document encoded as U+002D. Line-ending hyphens differentiated with @break of immediately following <lb> element.
Hyphens in source document encoded as U+2010 inside a <pc>. Line-ending hyphens differentiated with @force of the <pc> and @break of immediately following <lb> element.
Hyphens in source document encoded as U+202D inside a <pc>. Line-ending hyphens differentiated with @force of the <pc> and @break of immediately following <lb> element.
Schema Declaration
element p
{
   "All hyphens in source document encoded as U+2010."
 | "All hyphens in source document encoded as U+002D."
 | "Hyphens in source document       encoded as U+2010. Line-ending hyphens       differentiated with @break of immediately following       <lb> element."
 | "Hyphens in source document       encoded as U+002D. Line-ending hyphens       differentiated with @break of immediately following       <lb> element."
 | "Hyphens in source document encoded as       U+2010 inside a <pc>. Line-ending hyphens       differentiated with @force of the <pc> and       @break of immediately following <lb>       element."
 | "Hyphens in source document encoded as       U+202D inside a <pc>. Line-ending hyphens       differentiated with @force of the <pc> and       @break of immediately following <lb>       element."
}
Legal values are:
All hyphens in source document encoded as U+2010.
All hyphens in source document encoded as U+002D.
Hyphens in source document encoded as U+2010. Line-ending hyphens differentiated with @break of immediately following <lb> element.
Hyphens in source document encoded as U+002D. Line-ending hyphens differentiated with @break of immediately following <lb> element.
Hyphens in source document encoded as U+2010 inside a <pc>. Line-ending hyphens differentiated with @force of the <pc> and @break of immediately following <lb> element.
Hyphens in source document encoded as U+202D inside a <pc>. Line-ending hyphens differentiated with @force of the <pc> and @break of immediately following <lb> element.
1.8.1.2. lib.teins
lib.teins 
Modulederived-module-lib3
Used by
Element:
Content model
<content>
 <valList type="closed">
  <valItem ident="http://www.tei-c.org/ns/1.0"/>
 </valList>
</content>
    
Declaration
lib3_lib.teins = "http://www.tei-c.org/ns/1.0"

1.8.2. Schema lib3: changed components

1.8.2.1. <TEI>
<TEI> (TEI document) contains a single TEI-in-Libraries level 3 document, comprising a TEI header and a text, the latter represented as either a transcription (in <text>) or a transcription and page images (in <facsimile>), either in isolation or as part of a <teiCorpus> element. [4. Default Text Structure 15.1. Varieties of Composite Text]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
versionspecifies the major version number of the TEI Guidelines against which this document is valid.
StatusOptional
Datatypeteidata.version
Note

The major version number is historically prefixed by a P (for Proposal), and is distinct from the version number used for individual releases of the Guidelines, as used by (for example) the source of the <schemaSpec> element. The current version is P5.

Contained by
May contain
header: teiHeader
textstructure: text
Note

This element is required. The TEI namespace should be specified on this element, e.g. <TEI xmlns="http://www.tei-c.org/ns/1.0">.

ExampleNote that for technical reasons the namespace is not shown in this example, but it should always be supplied on the root <TEI> element, e.g.: <TEI xmlns="http://www.tei-c.org/ns/1.0">.
<TEI xmlns="http://www.tei-c.org/ns/1.0">  <teiHeader xml:lang="en">   <fileDesc>    <titleStmt>     <title>A Short Level 3 Document</title>    </titleStmt>    <publicationStmt>     <p>Only published as an example.</p>    </publicationStmt>    <sourceDesc>     <biblStruct>      <monogr>       <title>The Princess Bride</title>       <title type="sub">S. Morgenstern’s Classic Tale of True Love and High Adventure</title>       <imprint>        <publisher>Harcourt Brace Jovanovich</publisher>        <date when="1973"/>       </imprint>      </monogr>      <idno type="isbn-10">0-345-41826-3</idno>     </biblStruct>    </sourceDesc>   </fileDesc>  </teiHeader>  <text xml:lang="en">   <body>    <div type="chaptern="1">     <head>The Bride</head>     <p>The year that Buttercup was born, the most beautiful woman <lb/>in the          world …</p>        <!-- rest of chapter 1 -->    </div>    <div type="chaptern="2">     <head>The Groom</head>     <note>      <p>This is my first major excision. Chapter One, The Bride, is almost      <lb/>in its entirety about the bride. …</p>     </note>        <!-- rest of chapter 2 -->    </div>      <!-- rest of the book -->   </body>  </text> </TEI>
Schematron
<s:rule context="tei:TEI | tei:teiHeader | tei:teiHeader//*"> <s:report test="@rend or @rendition or @xml:space">The @rend, @rendition, and @xml:space attributes are not permitted on the root TEI element or within the teiHeader element</s:report> </s:rule>
Schematron
<s:ns prefix="tei"  uri="http://www.tei-c.org/ns/1.0"/> <s:ns prefix="xs"  uri="http://www.w3.org/2001/XMLSchema"/>
Schematron
<s:ns prefix="rng"  uri="http://relaxng.org/ns/structure/1.0"/>
Content model
<content>
 <elementRef key="teiHeader"/>
 <classRef key="model.resourceLike"
  minOccurs="0"/>
 <elementRef key="text"/>
</content>
    
Schema Declaration
element TEI
{
   lib3_att.global.attributes,
   attribute version { text }?,
   lib3_teiHeader,
   model.resourceLike?,
   lib3_text
}
1.8.2.2. att.global
att.global provides attributes common to all elements in the TEI encoding scheme. [1.3.1.1. Global Attributes]
Moduletei — Level 3: Simple Analysis
MembersTEI ab abbr addrLine address analytic appInfo application att author availability back bibl biblScope biblStruct body cb cell change choice cit citedRange classCode classDecl correction date distributor div div1 div2 div3 div4 div5 div6 div7 edition editionStmt editor editorialDecl email emph encodingDesc expan extent facsimile figure fileDesc floatingText foreign front gi graphic head hi hyphenation idno imprint item keywords l label langUsage language lb lg list listBibl media monogr name namespace normalization note notesStmt orgName p pb persName postBox postCode profileDesc projectDesc ptr pubPlace publicationStmt publisher punctuation q quotation ref relatedItem resp respStmt revisionDesc row samplingDecl schemaRef series seriesStmt sourceDesc street surface table tag tagUsage tagsDecl term text textClass textLang title titleStmt val
AttributesAttributes att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:id(identifier) provides a unique identifier for the element bearing the attribute.
StatusOptional
DatatypeID
Note

The xml:id attribute may be used to specify a canonical reference for an element; see section 3.10. Reference Systems.

n(number) gives a number (or other label) for an element, which is not necessarily unique within the document.
StatusOptional
Datatypeteidata.text
Note

The value of this attribute is always understood to be a single token, even if it contains space or other punctuation characters, and need not be composed of numbers only. It is typically used to specify the numbering of chapters, sections, list items, etc.; it may also be used in the specification of a standard reference system for the text.

xml:lang(language) indicates the language of the element content using a ‘tag’ generated according to BCP 47.
StatusOptional
Datatypeteidata.language
<p> … The consequences of this rapid depopulation were the loss of the last <foreign xml:lang="rap">ariki</foreign> or chief (Routledge 1920:205,210) and their connections to ancestral territorial organization.</p>
Note

The xml:lang value will be inherited from the immediately enclosing element, or from its parent, and so on up the document hierarchy. It is generally good practice to specify xml:lang at the highest appropriate level, noticing that a different default may be needed for the teiHeader from that needed for the associated resource element or elements, and that a single TEI document may contain texts in many languages.

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

The value used must conform with BCP 47. If the value is a private use code (i.e., starts with x- or contains -x-), a <language> element with a matching value for its ident attribute should be supplied in the TEI header to document this value. Such documentation may also optionally be supplied for non-private-use codes, though these must remain consistent with their (IETF)Internet Engineering Task Force definitions.

xml:spacesignals an intention about how white space should be managed by applications.
StatusOptional
Datatypeteidata.enumerated
Legal values are:
default
signals that the application's default white-space processing modes are acceptable
preserve
indicates the intent that applications preserve all white space
Note

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

1.8.2.3. att.typed
att.typed provides attributes which can be used to classify or subclassify elements in any way. [1.3.1. Attribute Classes 17.1.1. Words and Above 3.5.1. Referring Strings 3.6. Simple Links and Cross-References 3.5.5. Abbreviations and Their Expansions 3.12.1. Core Tags for Verse 7.2.5. Speech Contents 4.1.1. Un-numbered Divisions 4.1.2. Numbered Divisions 4.2.1. Headings and Trailers 4.4. Virtual Divisions 13.3.2.3. Personal Relationships 11.3.1.1. Core Elements for Transcriptional Work 16.1.1. Pointers and Links 16.3. Blocks, Segments, and Anchors 12.2. Linking the Apparatus to the Text 22.5.2. RELAX NG Content Models 8.3. Elements Unique to Spoken Texts 23.3.1.4. Modification of Attribute and Attribute Value Lists]
Moduletei — Level 3: Simple Analysis
Membersab application bibl biblStruct cb change cit date figure floatingText head label lb lg listBibl media name note orgName pb persName ptr ref relatedItem schemaRef surface table term text
AttributesAttributes
typecharacterizes the element in some sense, using any convenient classification scheme or typology.
StatusOptional
Datatypeteidata.enumerated
<div type="verse">  <head>Night in Tarras</head>  <lg type="stanza">   <l>At evening tramping on the hot white road</l>   <l></l>  </lg>  <lg type="stanza">   <l>A wind sprang up from nowhere as the sky</l>   <l></l>  </lg> </div>
Note

The type attribute is present on a number of elements, not all of which are members of att.typed, usually because these elements restrict the possible values for the attribute in a specific way.

Schematron
<sch:rule context="tei:*[@subtype]"> <sch:assert test="@type">The <sch:name/> element should not be categorized in detail with @subtype unless also categorized in general with @type</sch:assert> </sch:rule>
Note

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

1.8.2.4. <author>
<author> in a bibliographic reference, contains the name (typically encoded as <persName> or <orgName>) of the author, personal or corporate, of a work; for example in the same form as that provided by a recognized bibliographic name authority. [3.11.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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
May contain
figures: figure
header: idno
namesdates: orgName persName
tagdocs: att gi tag val
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 attribute 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.

Example
<author>  <orgName>British Broadcasting Corporation</orgName> </author>
Example
<author>  <persName ref="persons.xml#mdalmau.cny">Michelle Dalmau</persName> </author>
Example
<author>  <name>Gibson, Matthew</name> </author>
Example
<author>anonymous</author>
Example
<author>unknown</author>
Content model
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    
Schema Declaration
element author
{
   lib3_att.global.attributes,
   lib3_att.canonical.attributes,
   lib3_macro.phraseSeq
}
1.8.2.5. <back>
<back> (back matter) contains any appendixes, etc. following the main part of a text. [4.7. Back Matter 4. Default Text Structure]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
textstructure: floatingText text
May contain
textstructure: div div1
Note

Because cultural conventions differ as to which elements are grouped as back matter and which as front matter, the content models for the <back> and <front> elements are identical.

Example
<back>  <div1 type="appendix">   <head>The Golden Dream or, the Ingenuous Confession</head>   <ab>To shew the Depravity of human Nature </ab>  </div1>  <div1 type="epistle">   <head>A letter from the Printer, which he desires may be inserted</head>   <ab>Sir. I have done with your Copy, so you may return it to the Vatican, if you      please</ab>  </div1>  <div1 type="advert">   <head>The Books usually read by the Scholars of Mrs Two-Shoes are these and are      sold at Mr Newbery's at the Bible and Sun in St Paul's Church-yard.</head>   <ab> The Christmas Box, Price 1d. The History of Giles Gingerbread, 1d. A      Curious Collection of Travels, selected from the Writers of all Nations, 10      Vol, Pr. bound 1l. </ab>  </div1>  <div1 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>   <ab> Dr. James's Powders for Fevers, the Small-Pox, Measles, Colds, &amp;c. 2s.      6d Dr. Hooper's Female Pills, 1s. </ab>  </div1> </back>
Content model
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.divLike"
   minOccurs="1" maxOccurs="unbounded"/>
  <classRef key="model.div1Like"
   minOccurs="1" maxOccurs="unbounded"/>
 </alternate>
</content>
    
Schema Declaration
element back
{
   lib3_att.global.attributes,
   ( lib3_model.divLike+ | lib3_model.div1Like+ )
}
1.8.2.6. <bibl>
<bibl> (bibliographic citation) contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. [3.11.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type) att.sortable (@sortKey) att.docStatus (@status)
Member of
Contained by
May contain
Note

At level 3, the <bibl> element uses only generic phrase-level markup like <hi>, not structured bibliographic markup like <author>.

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="articlesubtype="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>
Schematron
<s:report test="ancestor::tei:text and ( tei:author | tei:biblScope | tei:citedRange | tei:distributor | tei:edition | tei:editor | tei:idno | tei:pubPlace | tei:publisher | tei:relatedItem | tei:respStmt | tei:series | tei:title ) ">When used inside the transcribed text at level 3, the <gi>bibl</gi> element uses only generic phrase-level markup like <gi>hi</gi>, not structured bibliographic markup like <s:value-of select="( tei:author | tei:biblScope | tei:citedRange | tei:distributor | tei:edition | tei:editor | tei:idno | tei:pubPlace | tei:publisher | tei:relatedItem | tei:respStmt | tei:series | tei:title)[1]/local-name(.)"/>.</s:report>
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
{
   lib3_att.global.attributes,
   lib3_att.typed.attributes,
   lib3_att.sortable.attributes,
   lib3_att.docStatus.attributes,
   (
      text
    | lib3_model.gLike
    | lib3_model.highlighted
    | lib3_model.pPart.data
    | lib3_model.pPart.edit
    | lib3_model.segLike
    | lib3_model.ptrLike
    | lib3_model.biblPart
    | lib3_model.global
   )*
}
1.8.2.7. <body>
<body> (text body) contains the whole body of a single unitary text, excluding any front or back matter. [4. Default Text Structure]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
textstructure: floatingText text
May contain
textstructure: div div1
Note

At level 3, the content of <body> may contain only the <head>, <l>, <lg>, <p>, <figure>, <floatingText>, <pb>, <lb>, <note>, and either <div> or <div1> elements.

Example
<body>  <head>LA FOREST NVPTIALE,</head>  <p>Où e∫t repre∫entee vne varieté bigarree, non mois e∫merveillable que plai∫an‐    te, de diuers mariages, ∫elon qu’ils ∫ont ob∫erueZ &amp; pratiqueZ par plu∫ieurs    peuples &amp; nations e∫tranges. Auec la maniere de policier, regir, gouuer‐ ner    &amp; admini∫trer leur famille.</p>  <div type="chapter">   <head>Les Romains. CHAPITRE I.</head>   <p>Encores que ie ne veuille me formali‐ ∫er contre le droict Romain, neãtmoins      puis que le forma‐ litez, qui e∫toient an‐ ciennement gardees au nopces      Romaines, ∫ont maintenant mi∫es hors d’v∫ages &amp; pratique, ie ne ∫e‐ A   <pb/> ray point de difficulté d’emprunter des anciens autheurs ce qui appar‐      <!-- ... -->   </p>  </div> </body>
Content model
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.divLike"
   minOccurs="1" maxOccurs="unbounded"/>
  <classRef key="model.div1Like"
   minOccurs="1" maxOccurs="unbounded"/>
 </alternate>
</content>
    
Schema Declaration
element body
{
   lib3_att.global.attributes,
   ( lib3_model.divLike+ | lib3_model.div1Like+ )
}
1.8.2.8. <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]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.docStatus (@status) att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type) att.datable (@calendar, @period) att.datable.w3c (when, @notBefore, @notAfter, @from, @to) att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)
whoindicates the person, or group of people, to whom the element content is ascribed.
Derived fromatt.ascribed
StatusRequired
Datatype1–∞ occurrences of teidata.pointer separated by whitespace
whensupplies the value of the date or time in a standard form, e.g. yyyy-mm-dd.
Derived fromatt.datable.w3c
StatusRequired
Datatypeteidata.temporal.w3c
targetpoints to one or more elements that belong to this change.
StatusOptional
Datatype1–∞ occurrences of teidata.pointer separated by whitespace
Contained by
header: revisionDesc
May contain
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="#BZwhen="2008-02-02"   status="public">Finished chapter 23</change>  <change who="#BZwhen="2008-01-02"   status="draft">Finished chapter 2</change>  <change n="P2.2when="1991-12-21"   who="#LDB">Added examples to section 3</change>  <change when="1991-11-11who="#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
{
   lib3_att.datable.attribute.calendar,
   lib3_att.datable.attribute.period,
   lib3_att.datable.w3c.attribute.notBefore,
   lib3_att.datable.w3c.attribute.notAfter,
   lib3_att.datable.w3c.attribute.from,
   lib3_att.datable.w3c.attribute.to,
   lib3_att.datable.custom.attribute.when-custom,
   lib3_att.datable.custom.attribute.notBefore-custom,
   lib3_att.datable.custom.attribute.notAfter-custom,
   lib3_att.datable.custom.attribute.from-custom,
   lib3_att.datable.custom.attribute.to-custom,
   lib3_att.datable.custom.attribute.datingPoint,
   lib3_att.datable.custom.attribute.datingMethod,
   lib3_att.docStatus.attributes,
   lib3_att.global.attributes,
   lib3_att.typed.attributes,
   attribute who { list { + } },
   attribute when { text },
   attribute target { list { + } }?,
   lib3_macro.specialPara
}
1.8.2.9. <div>
<div> (text division) contains a subdivision of the front, body, or back of a text. [4.1. Divisions of the Body]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.written (@hand)
Member of
Contained by
textstructure: back body div front
May contain
figures: figure table
linking: ab
textstructure: div floatingText
Note

At level 3, <div> may only contain the <head>, <l>, <lg>, <p>, <figure>, <floatingText>, <pb>, <lb>, <note>, and <div> elements.

Example
<body>  <div type="part">   <head>Fallacies of Authority</head>   <p>The subject of which is Authority in various shapes, and the object, to repress all      exercise of the reasoning faculty.</p>   <div n="1type="chapter">    <head>The Nature of Authority</head>    <p>With reference to any proposed measures having for their object the greatest        happiness of the greatest number [...]</p>    <div n="1.1type="section">     <head>Analysis of Authority</head>     <p>What on any given occasion is the legitimate weight or influence to be attached to          authority [...] </p>    </div>    <div n="1.2type="section">     <head>Appeal to Authority, in What Cases Fallacious.</head>     <p>Reference to authority is open to the charge of fallacy when [...] </p>    </div>   </div>  </div> </body>
Schematron
<s:report test="not(@type)">Use of the <att>type</att> attribute of <gi>div</gi> is recommended</s:report>
Schematron
<s:report test="ancestor::tei:l"> Abstract model violation: Lines may not contain higher-level structural elements such as div. </s:report>
Schematron
<s:report test="ancestor::tei:p or ancestor::tei:ab and not(ancestor::tei:floatingText)"> Abstract model violation: p and ab may not contain higher-level structural elements such as div. </s:report>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <alternate minOccurs="0" maxOccurs="1">
   <sequence minOccurs="1"
    maxOccurs="unbounded">
    <classRef key="model.divLike"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
   <sequence minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <classRef key="model.common"/>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.divLike"/>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
   </sequence>
  </alternate>
 </sequence>
</content>
    
Schema Declaration
element div
{
   lib3_att.global.attributes,
   lib3_att.written.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         ( lib3_model.divLike, lib3_model.global* )+
       | (
            ( lib3_model.common, lib3_model.global* )+,
            ( lib3_model.divLike, lib3_model.global* )*
         )
      )?
   )
}
1.8.2.10. <div1>
<div1> (level-1 text division) contains a first-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: back body front
May contain
figures: figure table
linking: ab
textstructure: div2 floatingText
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.

Example
<div1 xml:id="levin="Itype="part">  <head>Part I: Of Man </head>  <div2 xml:id="levi1n="1type="chapter">   <head>Chap. I. Of Sense </head>   <p>Concerning the Thoughts of man... </p>  </div2> </div1> <div1 xml:id="leviin="IItype="part">  <head>Part II: Of Common-Wealth</head> </div1>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <classRef key="model.div2Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.common"/>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <classRef key="model.div2Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div1
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         (
            (
               ( lib3_model.div2Like | lib3_model.divGenLike ),
               lib3_model.global*
            )+
          | (
               ( lib3_model.common, lib3_model.global* )+,
               (
                  ( lib3_model.div2Like | lib3_model.divGenLike ),
                  lib3_model.global*
               )*
            )
         ),
         lib3_model.global**
      )?
   )
}
1.8.2.11. <div2>
<div2> (level-2 text division) contains a second-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: div1
May contain
figures: figure table
linking: ab
textstructure: div3 floatingText
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.

Example
<div1 n="2type="part">  <head>The Second Partition:    The Cure of Melancholy</head>  <div2 n="2.1type="section">   <div3 n="2.1.1type="member">    <div4 n="2.1.1.1type="subsection">     <head>Unlawful Cures rejected.</head>     <p>Inveterate melancholy, howsoever it may seem to          be a continuate, inexorable disease, hard to be          cured, accompanying them to their graves most part          (as <ref target="#a">Montanus</ref> observes), yet many          times it may be helped...     </p>    </div4>   </div3>  </div2>  <div2 n="2.2type="section">   <div3 n="2.2.1type="member">    <head>Sect. II. Memb. I</head>    <p/>   </div3>  </div2>  <div2 n="2.3type="section">   <div3 n="2.3.1type="member">    <head>Sect. III. Memb. I</head>    <p/>   </div3>  </div2> </div1>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <classRef key="model.div3Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.common"/>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <classRef key="model.div3Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div2
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         (
            (
               ( lib3_model.div3Like | lib3_model.divGenLike ),
               lib3_model.global*
            )+
          | (
               ( lib3_model.common, lib3_model.global* )+,
               (
                  ( lib3_model.div3Like | lib3_model.divGenLike ),
                  lib3_model.global*
               )*
            )
         ),
         lib3_model.global**
      )?
   )
}
1.8.2.12. <div3>
<div3> (level-3 text division) contains a third-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: div2
May contain
figures: figure table
linking: ab
textstructure: div4 floatingText
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.

Example
<div2 n="2.2type="section">  <div3 n="2.2.1type="member">   <head>Sect. II. Memb. I</head>   <p/>  </div3>  <div3 n="2.2.2type="member">   <head>Memb. II Retention and Evacuation rectified.</head>   <p/>  </div3>  <div3 n="2.2.3type="member">   <head>Memb. III Ayr rectified. With a digression of the Ayr.</head>   <p/>  </div3> </div2>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <classRef key="model.div4Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.common"/>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <classRef key="model.div4Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div3
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         (
            (
               ( lib3_model.div4Like | lib3_model.divGenLike ),
               lib3_model.global*
            )+
          | (
               ( lib3_model.common, lib3_model.global* )+,
               (
                  ( lib3_model.div4Like | lib3_model.divGenLike ),
                  lib3_model.global*
               )*
            )
         ),
         lib3_model.global**
      )?
   )
}
1.8.2.13. <div4>
<div4> (level-4 text division) contains a fourth-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: div3
May contain
figures: figure table
linking: ab
textstructure: div5 floatingText
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.

Example
<div3 n="2.2.1type="member">  <head>Sect. II. Memb. I</head>  <div4 n="2.2.1.1type="subsection">   <head>Subsect I. — Dyet rectified in substance.</head>   <p>Diet, <term xml:lang="grc">diaitotiku</term>, <term xml:lang="la">victus</term> or      living </p>  </div4>  <div4 n="2.2.2.1type="subsection">   <head>Subsect II. — Dyet rectified in quantity.</head>   <p>Man alone, saith Cardan, eates and drinks without appetite, and useth all his pleasures      without necessity </p>  </div4> </div3>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <classRef key="model.div5Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.common"/>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <classRef key="model.div5Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div4
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         (
            (
               ( lib3_model.div5Like | lib3_model.divGenLike ),
               lib3_model.global*
            )+
          | (
               ( lib3_model.common, lib3_model.global* )+,
               (
                  ( lib3_model.div5Like | lib3_model.divGenLike ),
                  lib3_model.global*
               )*
            )
         ),
         lib3_model.global**
      )?
   )
}
1.8.2.14. <div5>
<div5> (level-5 text division) contains a fifth-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: div4
May contain
figures: figure table
linking: ab
textstructure: div6 floatingText
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.

Example
<div2 type="chapter">  <head>Recipes</head>  <head>Chapter VI.</head>  <div3>   <head>Fruit and vegetable soups</head>   <p>...</p>   <div4>    <head>Stocks for all kinds of soups</head>    <div5 type="recipe">     <head>Rich strong stock</head> <!-- ... -->    </div5>    <div5 type="recipe">     <head>Medium Stock</head> <!-- ... -->    </div5>   </div4>   <div4 type="recipe">    <head>Apple soup</head>    <div5>     <head>Ingredients</head>     <list>      <item>2 lbs. of good boiling apples,</item>      <item>3/4 teaspoonful of white pepper,</item>      <item>6 cloves,</item>      <item>cayenne or ginger to taste,</item>      <item>3 quarts of medium stock</item>     </list>    </div5>    <div5>     <head>Mode</head>     <p>Peel and quarter the apples taking out their cores; put them into          the stock, stew them gently till tender, Rub the whole through a          strainer, add the seasoning. give it one boil up, and serve.</p>    </div5>    <div5>     <head>Time</head>     <p>1 hour.</p>    </div5>    <div5>     <head>Average cost</head>     <p>per quart, 1s.</p>    </div5>    <div5>     <head>Seasonable</head>     <p>from September to December.</p>    </div5>    <div5>     <head>Sufficient</head>     <p> for 10 persons</p>    </div5>    <div5>     <head>The apple</head>     <p>This useful fruit is mentioned in Holy Writ; and Homer describes it          as valuable in his time... As a food, the apple cannot be considered          to rank high, as more than the half of it consists of water, and          the rest of its properties are not the most nourishing. It is          however a useful adjunct to other kinds of food, and, when cooked, is          esteemed as slightly laxative.</p>    </div5>   </div4>   <div4 type="recipe">    <head>Artichoke (Jerusalem) soup</head>    <p>...</p>   </div4> <!-- other recipes here -->  </div3> </div2>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <classRef key="model.div6Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.common"/>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <classRef key="model.div6Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div5
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         (
            (
               ( lib3_model.div6Like | lib3_model.divGenLike ),
               lib3_model.global*
            )+
          | (
               ( lib3_model.common, lib3_model.global* )+,
               (
                  ( lib3_model.div6Like | lib3_model.divGenLike ),
                  lib3_model.global*
               )*
            )
         ),
         lib3_model.global**
      )?
   )
}
1.8.2.15. <div6>
<div6> (level-6 text division) contains a sixth-level subdivision of the front, body, or back of a text. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: div5
May contain
figures: figure table
linking: ab
textstructure: div7 floatingText
Note

any sequence of low-level structural elements, possibly grouped into lower subdivisions.

Example
<div2 type="chapter">  <head>Recipes</head>  <head>Chapter VI.</head>  <div3>   <head>Fruit and vegetable soups</head>   <p>...</p>   <div4>    <head>Stocks for all kinds of soups</head>    <div5 type="recipe">     <head>Rich strong stock</head>     <div6>      <head>Ingredients</head>      <list>       <item>4 lbs of shin of beef,</item>       <item>4 lbs of knuckle of veal,</item> <!-- ... -->       <item>4 quarts of water</item>      </list>     </div6>     <div6>      <head>Mode</head>      <p>Line a delicately clean stewpan... Strain through a very            fine hair sieve, or tammy, and it will be fit for use</p>     </div6>     <div6>      <head>Time</head>      <p>5 hours.</p>     </div6>     <div6>      <head>Average cost</head>      <p>1s 3d. per quart</p>     </div6>    </div5>    <div5 type="recipe">     <head>Medium Stock</head> <!-- ... -->    </div5>   </div4> <!-- ... -->  </div3> </div2>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1"
     maxOccurs="unbounded">
     <alternate minOccurs="1" maxOccurs="1">
      <classRef key="model.div7Like"/>
      <classRef key="model.divGenLike"/>
     </alternate>
     <classRef key="model.global"
      minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <sequence minOccurs="1"
      maxOccurs="unbounded">
      <classRef key="model.common"/>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
     <sequence minOccurs="0"
      maxOccurs="unbounded">
      <alternate minOccurs="1"
       maxOccurs="1">
       <classRef key="model.div7Like"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div6
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      (
         (
            (
               ( lib3_model.div7Like | lib3_model.divGenLike ),
               lib3_model.global*
            )+
          | (
               ( lib3_model.common, lib3_model.global* )+,
               (
                  ( lib3_model.div7Like | lib3_model.divGenLike ),
                  lib3_model.global*
               )*
            )
         ),
         lib3_model.global**
      )?
   )
}
1.8.2.16. <div7>
<div7> (level-7 text division) contains the smallest possible subdivision of the front, body or back of a text, larger than a paragraph. [4.1.2. Numbered Divisions]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
textstructure: div6
May contain
figures: figure table
linking: ab
textstructure: floatingText
Note

any sequence of low-level structural elements, e.g., paragraphs (<p>), lists (<list>), or examples (<eg> or <egXML>).

Example
<div2 type="chapter">  <head>Recipes</head>  <head>Chapter VI.</head>  <div3>   <head>Fruit and vegetable soups</head>   <p>...</p>   <div4>    <head>Stocks for all kinds of soups</head>    <div5 type="recipe">     <head>Asparagus soup</head>     <div6 type="altRecipe">      <head>I.</head>      <div7>       <head>Ingredients</head>       <list>        <item> ...</item>       </list>      </div7>      <div7>       <head>Mode</head>       <p>Put the beef, cut into pieces and rolled in flour, into a              stewpan...</p>      </div7> <!-- ... -->     </div6>     <div6 type="altRecipe">      <head>II.</head>      <div7>       <head>Ingredients</head>       <list>        <item> ...</item>       </list>      </div7>      <div7>       <head>Mode</head>       <p>Boil the peas, and rub them through a sieve; add the gravy...</p>      </div7>     </div6>    </div5>   </div4>  </div3> </div2>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.divTop"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <sequence minOccurs="1"
    maxOccurs="unbounded">
    <classRef key="model.common"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    
Schema Declaration
element div7
{
   lib3_att.global.attributes,
   (
      ( lib3_model.divTop | lib3_model.global )*,
      ( ( lib3_model.common, lib3_model.global* )+, lib3_model.global** )?
   )
}
1.8.2.17. <editor>
<editor> contains the name (typically encoded as <persName> or <orgName>) of an individual, institution, or organization acting as editor. [3.11.2.2. Titles, Authors, and Editors]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Member of
Contained by
May contain
figures: figure
header: idno
namesdates: orgName persName
tagdocs: att gi tag val
character data
Note

A consistent format should be adopted.

Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use generally recognized authority lists for the exact form of personal names.

Example
<editor>  <persName ref="names.xml#khawkins.tvt">Kevin Hawkins</persName> </editor>
Content model
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    
Schema Declaration
element editor { lib3_att.global.attributes, lib3_macro.phraseSeq }
1.8.2.18. <editorialDecl>
<editorialDecl> (editorial practice declaration) provides details of editorial principles and practices applied during the encoding of a text. [2.3.3. The Editorial Practices Declaration 2.3. The Encoding Description 15.3.2. Declarable Elements]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
header: encodingDesc
May contain
Example
<editorialDecl>  <p>Metadata in the TEI header comes from an AACR2-conformant    record, translated to TEI via the <name type="software">Thutmose I</name> program.</p>  <p>Content originally generated by <name type="software">c-n-rite</name> OCR software, then the    needed TEI encoding put in place with <name type="software">cnr2tei.xslt</name>.</p>  <correction method="markupstatus="low"/>  <normalization method="silent">   <p>Spacing between words and the following      punctuation mark has been removed. Spacing      between words has generally been regularized to      one space.</p>  </normalization>  <normalization method="markup">   <p>Distances expressed in imperial units in the      source have been normalized to the metric system      using the attributes of the <gi>measure</gi>      element.</p>  </normalization>  <hyphenation eol="all">   <p>All hyphens in source document encoded as U+2010.</p>  </hyphenation> </editorialDecl>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="correction"
   minOccurs="0" maxOccurs="1"/>
  <elementRef key="hyphenation"
   minOccurs="0" maxOccurs="1"/>
  <elementRef key="normalization"
   minOccurs="0" maxOccurs="1"/>
  <elementRef key="punctuation"
   minOccurs="0" maxOccurs="1"/>
  <elementRef key="quotation" minOccurs="0"
   maxOccurs="1"/>
  <classRef key="model.pLike" minOccurs="0"
   maxOccurs="6"/>
 </sequence>
</content>
    
Schema Declaration
element editorialDecl
{
   lib3_att.global.attributes,
   (
      lib3_correction?,
      lib3_hyphenation?,
      lib3_normalization?,
      lib3_punctuation?,
      lib3_quotation?,
      (
         lib3_model.pLike?,
         (
            lib3_model.pLike,
            (
               lib3_model.pLike,
               (
                  lib3_model.pLike,
                  (
                     lib3_model.pLike,
                     ( lib3_model.pLike, lib3_model.pLike? )?
                  )?
               )?
            )?
         )?
      )
   )
}
1.8.2.19. <encodingDesc>
<encodingDesc> (encoding description) documents the relationship between an electronic text and the source or sources from which it was derived. [2.3. The Encoding Description 2.1.1. The TEI Header and Its Components]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
header: teiHeader
May contain
Example
<encodingDesc>  <p>Basic encoding, capturing lexical information only. All    hyphenation, punctuation, and variant spellings normalized. No    formatting or layout information preserved.</p> </encodingDesc>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="projectDesc"
   minOccurs="0" maxOccurs="1"/>
  <elementRef key="schemaRef" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="editorialDecl"
   minOccurs="1" maxOccurs="1"/>
  <elementRef key="tagsDecl" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="classDecl" minOccurs="0"
   maxOccurs="1"/>
  <elementRef key="appInfo" minOccurs="0"
   maxOccurs="1"/>
 </sequence>
</content>
    
Schema Declaration
element encodingDesc
{
   lib3_att.global.attributes,
   (
      lib3_projectDesc?,
      lib3_schemaRef*,
      lib3_editorialDecl,
      lib3_tagsDecl,
      lib3_classDecl?,
      lib3_appInfo?
   )
}
1.8.2.20. <facsimile>
<facsimile> contains a representation of some written source in the form of a set of images rather than as transcribed or encoded text. [11.1. Digital Facsimiles]
Moduletranscr — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
May contain
transcr: surface
Example
<facsimile>  <graphic url="page1.png"/>  <surface>   <graphic url="page2-highRes.png"/>   <graphic url="page2-lowRes.png"/>  </surface>  <graphic url="page3.png"/>  <graphic url="page4.png"/> </facsimile>
Example
<facsimile>  <surface ulx="0uly="0lrx="200lry="300">   <graphic url="Bovelles-49r.png"/>  </surface> </facsimile>
Content model
<content>
 <elementRef key="surface" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    
Schema Declaration
element facsimile { lib3_att.global.attributes, lib3_surface+ }
1.8.2.21. <front>
<front> (front matter) contains any prefatory matter (headers, abstracts, title page, prefaces, dedications, etc.) found at the start of a document, before the main body. [4.6. Title Pages 4. Default Text Structure]
Moduletextstructure — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
textstructure: floatingText text
May contain
textstructure: div div1
Note

Because cultural conventions differ as to which elements are grouped as front matter and which as back matter, the content models for the <front> and <back> elements are identical.

Example
<front>  <div type="dedication">   <p>To our three selves</p>  </div>  <div type="preface">   <head>Author's Note</head>   <p>All the characters in this book are purely imaginary, and if the author has      used names that may suggest a reference to living persons she has done so      inadvertently. ...</p>  </div> </front>
Content model
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <classRef key="model.divLike"
   minOccurs="1" maxOccurs="unbounded"/>
  <classRef key="model.div1Like"
   minOccurs="1" maxOccurs="unbounded"/>
 </alternate>
</content>
    
Schema Declaration
element front
{
   lib3_att.global.attributes,
   ( lib3_model.divLike+ | lib3_model.div1Like+ )
}
1.8.2.22. <head>
<head> (heading) contains the heading of a division (for example the title of a section), figure, list, line group, or table. [4.2.1. Headings and Trailers]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type) att.written (@hand)
Member of
Contained by
core: lg list
figures: figure table
textstructure: div div1 div2 div3 div4 div5 div6 div7
May contain
Note

The <head> element is used for headings at all levels; software which treats (e.g.) chapter headings, section headings, and list titles differently must determine the proper processing of a <head> element based on its structural position. A <head> occurring as the first element of a list is the title of that list; one occurring as the first element of a <div1> is the title of that chapter or section.

ExampleThe most common use for the <head> element is to mark the headings of sections. In older writings, the headings or incipits may be rather longer than usual in modern works. If a section has an explicit ending as well as a heading, it should be marked as a <trailer>, as in this example:
<div1 n="Itype="book">  <head>In the name of Christ here begins the first book of the ecclesiastical history of    Georgius Florentinus, known as Gregory, Bishop of Tours.</head>  <div2 type="section">   <head>In the name of Christ here begins Book I of the history.</head>   <p>Proposing as I do ...</p>   <p>From the Passion of our Lord until the death of Saint Martin four hundred and twelve      years passed.</p>   <trailer>Here ends the first Book, which covers five thousand, five hundred and ninety-six      years from the beginning of the world down to the death of Saint Martin.</trailer>  </div2> </div1>
ExampleThe <head> element is also used to mark headings of other units, such as lists:
With a few exceptions, connectives are equally useful in all kinds of discourse: description, narration, exposition, argument. <list rend="bulleted">  <head>Connectives</head>  <item>above</item>  <item>accordingly</item>  <item>across from</item>  <item>adjacent to</item>  <item>again</item>  <item> <!-- ... -->  </item> </list>
Content model
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <elementRef key="lg"/>
  <classRef key="model.gLike"/>
  <classRef key="model.phrase"/>
  <classRef key="model.inter"/>
  <classRef key="model.lLike"/>
  <classRef key="model.global"/>
 </alternate>
</content>
    
Schema Declaration
element head
{
   lib3_att.global.attributes,
   lib3_att.typed.attributes,
   lib3_att.written.attributes,
   (
      text
    | lib3_lg
    | lib3_model.gLike
    | lib3_model.phrase
    | lib3_model.inter
    | lib3_model.lLike
    | lib3_model.global
   )*
}
1.8.2.23. <hyphenation>
<hyphenation> summarizes the way in which hyphenation in a source text has been treated in an encoded version of it. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
eol(end-of-line) indicates whether or not end-of-line hyphenation has been retained in a text.
StatusOptional
Datatypeteidata.enumerated
Legal values are:
all
all end-of-line hyphenation has been retained, even though the lineation of the original may not have been.
some
end-of-line hyphenation has been retained in some cases.[Default]
hard
all soft end-of-line hyphenation has been removed: any remaining end-of-line hyphenation should be retained.
none
all end-of-line hyphenation has been removed: any remaining hyphenation occurred within the line.
Contained by
May contain
core: p
derived-module-lib3: p
Example
<hyphenation eol="some">  <p>End-of-line hyphenation silently removed where appropriate</p> </hyphenation>
Content model
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <sequence minOccurs="1" maxOccurs="1">
   <elementRef key="hyphenation-para"
    minOccurs="1" maxOccurs="1"/>
   <elementRef key="p" minOccurs="0"
    maxOccurs="unbounded"/>
  </sequence>
  <sequence minOccurs="1" maxOccurs="1">
   <elementRef key="p" minOccurs="1"
    maxOccurs="unbounded"/>
  </sequence>
 </alternate>
</content>
    
Schema Declaration
element hyphenation
{
   lib3_att.global.attributes,
   attribute eol { "all" | "some" | "hard" | "none" }?,
   ( ( lib3_hyphenation-para, lib3_p* ) | ( lib3_p+ ) )
}
1.8.2.24. <idno>
<idno> (identifier) supplies any form of identifier used to identify some object, such as a bibliographic item, a person, a title, an organization, etc. in a standardized way. [2.2.4. Publication, Distribution, Licensing, etc. 2.2.5. The Series Statement 3.11.2.4. Imprint, Size of a Document, and Reprint Information]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
typecategorizes the identifier, for example as an ISBN, Social Security number, etc.
Derived fromatt.typed
StatusOptional
Datatypeteidata.enumerated
Suggested values include:
ISBN
International Standard Book Number: a 13- or (if assigned prior to 2007) 10-digit identifying number assigned by the publishing industry to a published book or similar item, registered with the International ISBN Agency.
ISSN
International Standard Serial Number: an eight-digit number to uniquely identify a serial publication.
DOI
Digital Object Identifier: a unique string of letters and numbers assigned to an electronic document.
URI
Uniform Resource Identifier: a string of characters to uniquely identify a resource which usually contains indication of the means of accessing that resource, the name of its host, and its filepath.
VIAF
A data number in the Virtual Internet Authority File assigned to link different names in catalogs around the world for the same entity.
ESTC
English Short-Title Catalogue number: an identifying number assigned to a document in English printed in the British Isles or North America before 1801.
OCLC
union catalog number in WorldCat representing a resource held by one or more of the member libraries in the global cooperative Online Computer Library Center.
LC_call_number
(U.S. Library of Congress call number)
LCCN
(Library of Congress control number)
Member of
Contained by
May contain
header: idno
character data
Note

<idno> should be used for labels which identify an object or concept in a formal cataloguing system such as a database or an RDF store, or in a distributed system such as the World Wide Web. Some suggested values for type on <idno> are ISBN, ISSN, DOI, and URI.

Example
<idno type="ISBN">978-1-906964-22-1</idno> <idno type="ISSN">0143-3385</idno> <idno type="DOI">10.1000/123</idno> <idno type="URI">http://www.worldcat.org/oclc/185922478</idno> <idno type="URI">http://authority.nzetc.org/463/</idno> <idno type="LT">Thomason Tract E.537(17)</idno> <idno type="Wing">C695</idno> <idno type="oldCat">  <g ref="#sym"/>345 </idno>
In the last case, the identifier includes a non-Unicode character which is defined elsewhere by means of a <glyph> or <char> element referenced here as #sym.
Content model
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <elementRef key="idno"/>
 </alternate>
</content>
    
Schema Declaration
element idno
{
   lib3_att.global.attributes,
   lib3_att.sortable.attributes,
   lib3_att.datable.attributes,
   attribute type
   {
      "ISBN"
    | "ISSN"
    | "DOI"
    | "URI"
    | "VIAF"
    | "ESTC"
    | "OCLC"
    | "LC_call_number"
    | "LCCN"
   }?,
   ( text | lib3_model.gLike | lib3_idno )*
}
1.8.2.25. <listBibl>
<listBibl> (citation list) contains a list of bibliographic citations of any kind. [3.11.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.sortable (@sortKey) att.typed (@type)
Member of
Contained by
May contain
Example
<listBibl>  <head>Works consulted</head>  <bibl>Blain, Clements and Grundy: Feminist Companion to    Literature in English (Yale, 1990)  </bibl>  <biblStruct>   <analytic>    <title>The Interesting story of the Children in the Wood</title>   </analytic>   <monogr>    <title>The Penny Histories</title>    <author>Victor E Neuberg</author>    <imprint>     <publisher>OUP</publisher>     <date>1968</date>    </imprint>   </monogr>  </biblStruct> </listBibl>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.biblLike"/>
   <classRef key="model.milestoneLike"/>
  </alternate>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <elementRef key="relation"/>
   <elementRef key="listRelation"/>
  </alternate>
 </sequence>
</content>
    
Schema Declaration
element listBibl
{
   lib3_att.global.attributes,
   lib3_att.sortable.attributes,
   lib3_att.typed.attributes,
   (
      ( lib3_model.biblLike | lib3_model.milestoneLike )+,
      ( relation | listRelation )*
   )
}
1.8.2.26. <namespace>
<namespace> supplies the formal name of the namespace to which the elements documented by its children belong. [2.3.4. The Tagging Declaration]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
namespecifies the full formal name of the namespace concerned.
StatusRequired
Datatypelib.teins
Contained by
header: tagsDecl
May contain
header: tagUsage
Example
<namespace name="http://www.tei-c.org/ns/1.0">  <tagUsage gi="hioccurs="28withId="2"> Used only to mark English words    italicized in the copy text </tagUsage> </namespace>
Content model
<content>
 <elementRef key="tagUsage"/>
</content>
    
Schema Declaration
element namespace
{
   lib3_att.global.attributes,
   attribute name { text },
   lib3_tagUsage
}
1.8.2.27. <note>
<note> contains a note or annotation. [3.8.1. Notes and Simple Annotation 2.2.6. The Notes Statement 3.11.2.8. Notes and Statement of Language 9.3.5.4. Notes within Entries]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.placement (@place) att.typed (@type) att.written (@hand)
anchoredindicates whether the copy text shows the exact place of reference for the note.
StatusOptional
Datatypeteidata.truthValue
Defaulttrue
Note

In modern texts, notes are usually anchored by means of explicit footnote or endnote symbols. An explicit indication of the phrase or line annotated may however be used instead (e.g. ‘page 218, lines 3–4’). The anchored attribute indicates whether any explicit location is given, whether by symbol or by prose cross-reference. The value true indicates that such an explicit location is indicated in the copy text; the value false indicates that the copy text does not indicate a specific place of attachment for the note. If the specific symbols used in the copy text at the location the note is anchored are to be recorded, use the n attribute.

Member of
Contained by
May contain
ExampleIn the following example, the translator has supplied a footnote containing an explanation of the term translated as "painterly":
And yet it is not only in the great line of Italian renaissance art, but even in the painterly <note place="bottomtype="gloss"  resp="#MDMH">  <term xml:lang="de">Malerisch</term>. This word has, in the German, two distinct meanings, one objective, a quality residing in the object, the other subjective, a mode of apprehension and creation. To avoid confusion, they have been distinguished in English as <mentioned>picturesque</mentioned> and <mentioned>painterly</mentioned> respectively. </note> style of the Dutch genre painters of the seventeenth century that drapery has this psychological significance.
For this example to be valid, the code MDMH must be defined elsewhere, for example by means of a responsibility statement in the associated TEI header:
<respStmt xml:id="MDMH">  <resp>translation from German to English</resp>  <name>Hottinger, Marie Donald Mackie</name> </respStmt>
ExampleThe global n attribute may be used to supply the symbol or number used to mark the note's point of attachment in the source text, as in the following example:
Mevorakh b. Saadya's mother, the matriarch of the family during the second half of the eleventh century, <note n="126anchored="true"> The alleged mention of Judah Nagid's mother in a letter from 1071 is, in fact, a reference to Judah's children; cf. above, nn. 111 and 54. </note> is well known from Geniza documents published by Jacob Mann.
However, if notes are numbered in sequence and their numbering can be reconstructed automatically by processing software, it may well be considered unnecessary to record the note numbers.
Content model
<content>
 <macroRef key="macro.specialPara"/>
</content>
    
Schema Declaration
element note
{
   lib3_att.global.attributes,
   lib3_att.placement.attributes,
   lib3_att.typed.attributes,
   lib3_att.written.attributes,
   attribute anchored { text }?,
   lib3_macro.specialPara
}
1.8.2.28. <orgName>
<orgName> (organization name) contains an organizational name. [13.2.2. Organizational Names]
Modulenamesdates — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) att.typed (@type)
Member of
Contained by
May contain
figures: figure
header: idno
namesdates: orgName persName
tagdocs: att gi tag val
character data
Example
About a year back, a question of considerable interest was agitated in the <orgName key="PAS1type="voluntary">  <placeName key="PEN">Pennsyla.</placeName> Abolition Society </orgName> [...]
Content model
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    
Schema Declaration
element orgName
{
   lib3_att.global.attributes,
   lib3_att.personal.attributes,
   lib3_att.typed.attributes,
   lib3_macro.phraseSeq
}
1.8.2.29. <pb>
<pb> (page break) marks the start of a new page in a paginated document. [3.10.3. Milestone Elements]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type) att.spanning (@spanTo) att.breaking (@break) att.edition (ed, @edRef)
Member of
Contained by
May containEmpty element
Note

A <pb> element should appear at the start of the page which it identifies. The global n attribute indicates the number or other value associated with this page. This will normally be the page number or signature printed on it, since the physical sequence number is implicit in the presence of the <pb> element itself.

The type attribute may be used to characterize the page break in any respect. The more specialized attributes break, ed, or edRef should be preferred when the intent is to indicate whether or not the page break is word-breaking, or to note the source from which it derives.

ExamplePage numbers may vary in different editions of a text.
<p> ... <pb n="145ed="ed2"/> <!-- Page 145 in edition "ed2" starts here --> ... <pb n="283ed="ed1"/> <!-- Page 283 in edition "ed1" starts here--> ... </p>
ExampleA page break may be associated with a facsimile image of the page it introduces by means of the facs attribute
<body>  <pb n="1facs="page1.png"/> <!-- page1.png contains an image of the page; the text it contains is encoded here -->  <p> <!-- ... -->  </p>  <pb n="2facs="page2.png"/> <!-- similarly, for page 2 -->  <p> <!-- ... -->  </p> </body>
Content model
<content/>
    
Schema Declaration
element pb
{
   lib3_att.global.attributes,
   lib3_att.typed.attributes,
   lib3_att.edition.attribute.edRef,
   lib3_att.spanning.attributes,
   lib3_att.breaking.attributes,
   empty
}
1.8.2.30. <persName>
<persName> (personal name) contains a proper noun or proper-noun phrase referring to a person, possibly including one or more of the person's forenames, surnames, honorifics, added names, etc. [13.2.1. Personal Names]
Modulenamesdates — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.personal (@full, @sort) att.typed (@type)
Member of
Contained by
May contain
figures: figure
header: idno
namesdates: orgName persName
tagdocs: att gi tag val
character data
Example
<persName>  <forename>Edward</forename>  <forename>George</forename>  <surname type="linked">Bulwer-Lytton</surname>, <roleName>Baron Lytton of  <placeName>Knebworth</placeName>  </roleName> </persName>
Content model
<content>
 <macroRef key="macro.phraseSeq"/>
</content>
    
Schema Declaration
element persName
{
   lib3_att.global.attributes,
   lib3_att.personal.attributes,
   lib3_att.typed.attributes,
   lib3_macro.phraseSeq
}
1.8.2.31. <ptr>
<ptr> (pointer) defines a pointer to another location. [3.6. Simple Links and Cross-References 16.1. Links]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.internetMedia (@mimeType) att.typed (@type)
Member of
Contained by
May containEmpty element
Example
<ptr target="#p143 #p144"/> <ptr target="http://www.tei-c.org"/> <ptr cRef="1.3.4"/>
Schematron
<s:report test="@target and @cRef">Only one of the attributes @target and @cRef may be supplied on <s:name/>.</s:report>
Content model
<content/>
    
Schema Declaration
element ptr
{
   lib3_att.global.attributes,
   lib3_att.pointing.attributes,
   lib3_att.internetMedia.attributes,
   lib3_att.typed.attributes,
   empty
}
1.8.2.32. <publicationStmt>
<publicationStmt> (publication statement) groups information concerning the publication or distribution of an electronic or other text. [2.2.4. Publication, Distribution, Licensing, etc. 2.2. The File Description]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
header: fileDesc
May contain
Note

For normally published items, the specialized children elements (e.g. <publisher>) should be used. Paragraphs are permitted as an alternative for unusual cases like unpublished works.

Example
<publicationStmt>  <publisher>C. Muquardt </publisher>  <pubPlace>Bruxelles &amp; Leipzig</pubPlace>  <date when="1846"/> </publicationStmt>
Example
<publicationStmt>  <publisher>Chadwyck Healey</publisher>  <pubPlace>Cambridge</pubPlace>  <availability>   <p>Available under licence only</p>  </availability>  <date when="1992">1992</date> </publicationStmt>
Schematron
<s:report test="child::tei:p">Use of specialized child elements of the publication statement (rather than paragraphs) is recommended whenever possible</s:report>
Schematron
<s:rule context="tei:publicationStmt/tei:date"> <s:assert test="@when">Dates inside the publication statement should have @when (and should not have content)</s:assert> <s:report test="string-length( normalize-space(.) ) > 0">Dates inside the publication statement should not have content (and should have @when)</s:report> </s:rule>
Content model
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <sequence minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.publicationStmtPart.agency"/>
   <classRef key="model.publicationStmtPart.detail"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>
    
Schema Declaration
element publicationStmt
{
   lib3_att.global.attributes,
   (
      (
         lib3_model.publicationStmtPart.agency,
         lib3_model.publicationStmtPart.detail*
      )+
    | lib3_model.pLike+
   )
}
1.8.2.33. <ref>
<ref> (reference) defines a reference to another location, possibly modified by additional text or comment. [3.6. Simple Links and Cross-References 16.1. Links]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) att.internetMedia (@mimeType) att.typed (@type)
Member of
Contained by
May contain
Note

The target and cRef attributes are mutually exclusive.

Example
See especially <ref target="http://www.natcorp.ox.ac.uk/Texts/A02.xml#s2">the second sentence</ref>
Example
See also <ref target="#locution">s.v. <term>locution</term> </ref>.
Schematron
<s:report test="@target and @cRef">Only one of the attributes @target' and @cRef' may be supplied on <s:name/> </s:report>
Content model
<content>
 <macroRef key="macro.paraContent"/>
</content>
    
Schema Declaration
element ref
{
   lib3_att.global.attributes,
   lib3_att.pointing.attributes,
   lib3_att.internetMedia.attributes,
   lib3_att.typed.attributes,
   lib3_macro.paraContent
}
1.8.2.34. <rendition>
<rendition> supplies information about the rendition or appearance of one or more elements in the source text. [2.3.4. The Tagging Declaration]
Moduleheader — Level 3: Simple Analysis
AttributesAttributesatt.global (xml:id, @n, @xml:lang, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.styleDef (scheme, @schemeVersion)
xml:id(identifier) provides a unique identifier for the element bearing the attribute.
Derived fromatt.global
StatusRequired
DatatypeID
schemeidentifies the language used to describe the rendition.
Derived fromatt.styleDef
StatusRequired
Datatypeteidata.enumerated
Legal values are:
css
Cascading Stylesheet Language
scopewhere CSS is used, provides a way of defining ‘pseudo-elements’, that is, styling rules applicable to specific sub-portions of an element.
StatusOptional
Datatypeteidata.enumerated
Sample values include:
first-line
styling applies to the first line of the target element
first-letter
styling applies to the first letter of the target element
before
styling should be applied immediately before the content of the target element
after
styling should be applied immediately after the content of the target element
selectorcontains a selector or series of selectors specifying the elements to which the contained style description applies, expressed in the language specified in the scheme attribute.
StatusOptional
Datatypeteidata.text
<rendition scheme="css"  selector="text, front, back, body, div, p, ab"> display: block; </rendition>
<rendition scheme="css"  selector="*[rend*=italic]"> font-style: italic; </rendition>
Note

Since the default value of the scheme attribute is assumed to be CSS, the default expectation for this attribute, in the absence of scheme, is that CSS selector syntax will be used.

Note

While rendition is used to point from an element in the transcribed source to a <rendition> element in the header which describes how it appears, the selector attribute allows the encoder to point in the other direction: from a <rendition> in the header to a collection of elements which all share the same renditional features. In both cases, the intention is to record the appearance of the source text, not to prescribe any particular output rendering.

Contained by
header: tagsDecl
May contain
figures: table
header: idno
namesdates: orgName persName
tagdocs: att gi tag val
textstructure: floatingText
character data
Example
<tagsDecl>  <rendition xml:id="r-centerscheme="css">text-align: center;</rendition>  <rendition xml:id="r-smallscheme="css">font-size: small;</rendition>  <rendition xml:id="r-largescheme="css">font-size: large;</rendition>  <rendition xml:id="initcaps"   scope="first-letterscheme="css">font-size: xx-large</rendition> </tagsDecl>
Content model
<content>
 <macroRef key="macro.limitedContent"/>
</content>
    
Schema Declaration
element rendition
{
   lib3_att.global.attribute.n,
   lib3_att.global.attribute.xmllang,
   lib3_att.global.attribute.xmlspace,
   lib3_att.global.rendition.attribute.rend,
   lib3_att.global.rendition.attribute.style,
   lib3_att.global.rendition.attribute.rendition,
   lib3_att.global.linking.attribute.corresp,
   lib3_att.global.linking.attribute.synch,
   lib3_att.global.linking.attribute.sameAs,
   lib3_att.global.linking.attribute.copyOf,
   lib3_att.global.linking.attribute.next,
   lib3_att.global.linking.attribute.prev,
   lib3_att.global.linking.attribute.exclude,
   lib3_att.global.linking.attribute.select,
   lib3_att.global.facs.attribute.facs,
   lib3_att.global.change.attribute.change,
   lib3_att.global.responsibility.attribute.cert,
   lib3_att.global.responsibility.attribute.resp,
   lib3_att.global.source.attribute.source,
   lib3_att.styleDef.attribute.schemeVersion,
   attribute xml:id { text },
   attribute scheme { "css" },
   attribute scope { text }?,
   attribute selector { text }?,
   lib3_macro.limitedContent
}
1.8.2.35. <respStmt>
<respStmt> (statement of responsibility) supplies a statement of responsibility for the intellectual content of a text, edition, recording, or series, where the specialized elements for authors, editors, etc. do not suffice or do not apply. May also be used to encode information about individuals or organizations which have played a role in the production or distribution of a bibliographic work. [3.11.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.2. The Edition Statement 2.2.5. The Series Statement]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (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
May contain
core: name resp
namesdates: orgName persName
Example
<respStmt>  <resp>transcribed from original ms</resp>  <persName>Claus Huitfeldt</persName> </respStmt>
Example
<respStmt>  <resp>converted to XML encoding</resp>  <name>Alan Morrison</name> </respStmt>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef minOccurs="1" maxOccurs="1"
   key="resp"/>
  <classRef minOccurs="1"
   maxOccurs="unbounded" key="model.nameLike.agent"/>
 </sequence>
</content>
    
Schema Declaration
element respStmt
{
   lib3_att.global.attributes,
   lib3_att.canonical.attributes,
   ( lib3_resp, lib3_model.nameLike.agent+ )
}
1.8.2.36. <schemaRef>
<schemaRef> (schema reference) describes or points to a related customization or schema file [2.3.9. The Schema Specification]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type) att.resourced (@url)
keythe identifier used for the customization or schema
StatusOptional
Datatypeteidata.enumerated
Suggested values include:
BPTL-L1-v3.4.1a
(Best Practices for TEI in Libraries level 1, version 3.4.1a)
BPTL-L2-v3.4.1a
(Best Practices for TEI in Libraries level 2, version 3.4.1a)
BPTL-L3-v3.4.1a
(Best Practices for TEI in Libraries level 3, version 3.4.1a)
BPTL-L4-v3.4.1a
(Best Practices for TEI in Libraries level 4, version 3.4.1a)
BPTL-L5-v3.4.1a
(Best Practices for TEI in Libraries level 5, version 3.4.1a)
Contained by
header: encodingDesc
May containEmpty element
Example
<schemaRef type="interchangeODD"  url="http://www.tei-c.org/release/xml/tei/custom/odd/tei_lite.odd"/> <schemaRef type="interchangeRNG"  url="http://www.tei-c.org/release/xml/tei/custom/odd/tei_lite.rng"/> <schemaRef type="projectODD"  url="file:///schema/project.odd"/>
Content model
<content>
 <classRef key="model.descLike"
  minOccurs="0"/>
</content>
    
Schema Declaration
element schemaRef
{
   lib3_att.global.attributes,
   lib3_att.typed.attributes,
   lib3_att.resourced.attributes,
   attribute key
   {
      "BPTL-L1-v3.4.1a"
    | "BPTL-L2-v3.4.1a"
    | "BPTL-L3-v3.4.1a"
    | "BPTL-L4-v3.4.1a"
    | "BPTL-L5-v3.4.1a"
   }?,
   lib3_model.descLike?
}
1.8.2.37. <sourceDesc>
<sourceDesc> (source description) describes the source from which an electronic text was derived or generated, typically a bibliographic description in the case of a digitized text, or a phrase such as "born digital" for a text which has no previous existence. [2.2.7. The Source Description]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
Contained by
header: fileDesc
May contain
Example
<sourceDesc>  <bibl>   <title level="a">The Interesting story of the Children in the Wood</title>. In  <author>Victor E Neuberg</author>, <title>The Penny Histories</title>.  <publisher>OUP</publisher>   <date>1968</date>. </bibl> </sourceDesc>
Example
<sourceDesc>  <p>Born digital: no previous source exists.</p> </sourceDesc>
Content model
<content>
 <elementRef key="biblStruct"/>
</content>
    
Schema Declaration
element sourceDesc { lib3_att.global.attributes, lib3_biblStruct }
1.8.2.38. <surface>
<surface> defines a written surface as a two-dimensional coordinate space, optionally grouping one or more graphic representations of that space, zones of interest within that space, and transcriptions of the writing within them. [11.1. Digital Facsimiles 11.2.2. Embedded Transcription]
Moduletranscr — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type)
attachmentdescribes the method by which this surface is or was connected to the main surface
StatusOptional
Datatypeteidata.enumerated
Sample values include:
glued
glued in place
pinned
pinned or stapled in place
sewn
sewn in place
flippingindicates whether the surface is attached and folded in such a way as to provide two writing surfaces
StatusOptional
Datatypeteidata.truthValue
Contained by
transcr: facsimile
May contain
core: graphic
Note

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

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

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

Where it is useful or meaningful to do so, any grouping of multiple <surface> elements may be indicated using the <surfaceGrp> elements.

Example
<facsimile>  <surface ulx="0uly="0lrx="200lry="300">   <graphic url="Bovelles-49r.png"/>  </surface> </facsimile>
Content model
<content>
 <elementRef key="graphic"/>
</content>
    
Schema Declaration
element surface
{
   lib3_att.global.attributes,
   lib3_att.typed.attributes,
   attribute attachment { text }?,
   attribute flipping { text }?,
   lib3_graphic
}
1.8.2.39. <tagUsage>
<tagUsage> documents the usage of a specific element within a specified document. [2.3.4. The Tagging Declaration]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
gi(element name) the name (generic identifier) of the element indicated by the tag.
StatusRequired
Datatypeteidata.enumerated
Schematron
<s:rule context="tei:text"> <s:report test=".//tei:div and .//tei:div1">A single TEI in Libraries document should not mix numbered and unnumbered divisions. </s:report> </s:rule> <s:rule context="tei:TEI"> <s:assert test="/tei:TEI/tei:teiHeader/tei:encodingDesc/tei:tagsDecl/tei:namespace/tei:tagUsage/@gi">The use of divisions (i.e., whether numbered or unnumbered divisions are used) should be documented in a <tagUsage> element by "Unnumbered divs used." or "Numbered divs used." The <tagUsage> element must be the child of a <namespace name="http://www.tei-c.org/ns/1.0"> element. </s:assert> </s:rule> <s:rule context="tei:tagUsage"> <s:assert test="( @gi eq 'div' and normalize-space(.) eq 'Unnumbered divs used.' and not( /tei:TEI/tei:text//tei:div1 ) ) or ( @gi eq 'div1' and normalize-space(.) eq 'Numbered divs used.' and not( /tei:TEI/tei:text//tei:div ) )">A document that uses un-numbered divisions should specify so by using <tagUsage gi="div">Unnumbered divs used.</tagUsage>; a document that uses numbered divisions should specify so by using <tagUsage gi="div1">Numbered divs used.</tagUsage>.</s:assert> </s:rule>
Legal values are:
div
(divisions are un-numbered) The document uses <div>, not <div1>, <div2>, etc. The content of this <tagUsage> should be ‘Unnumbered divs used.’.
div1
(divisions are numbered) The document uses <div1> (and perhaps <div2>, etc.), not <div> elements. The content of this <tagUsage> should be ‘Numbered divs used.’.
occursspecifies the number of occurrences of this element within the text.
StatusRecommended
Datatypeteidata.count
withId(with unique identifier) specifies the number of occurrences of this element within the text which bear a distinct value for the global xml:id attribute.
StatusRecommended
Datatypeteidata.count
renderspecifies the identifier of a <rendition> element which defines how this element was rendered in the source text.
Deprecatedwill be removed on 2017-01-01
StatusOptional
Datatype1–∞ occurrences of teidata.pointer separated by whitespace
Note

The recommended way of specifying a default rendition for a set of elements is to use the selector attribute on the <rendition> element.

Contained by
header: namespace
May containEmpty element
Example
<tagsDecl partial="true">  <rendition xml:id="itscheme="css"   selector="foreign hi"> font-style: italic; </rendition> <!-- ... -->  <namespace name="http://www.tei-c.org/ns/1.0">   <tagUsage gi="hioccurs="28withId="2"> Used to mark English words italicized in the copy text.</tagUsage>   <tagUsage gi="foreign">Used to mark non-English words in the copy text.</tagUsage> <!-- ... -->  </namespace> </tagsDecl>
Example
<tagsDecl> <!-- deprecated usage -->  <rendition xml:id="dit">Render using a slant or italic variant on the current font</rendition> <!-- ... -->  <namespace name="http://www.tei-c.org/ns/1.0">   <tagUsage gi="hioccurs="28withId="2"    render="#dit"> Used to mark English words      italicized in the copy text.</tagUsage>   <tagUsage gi="foreignrender="#dit">Used to mark non-English words in the copy text.</tagUsage> <!-- ... -->  </namespace> </tagsDecl>
Content model
<content>
 <valList type="closed">
  <valItem ident="Unnumbered divs used."/>
  <valItem ident="Numbered divs used."/>
 </valList>
</content>
    
Legal values are:
Unnumbered divs used.
Numbered divs used.
Schema Declaration
element tagUsage
{
   lib3_att.global.attributes,
   attribute gi { "div" | "div1" }
   >>
   tei:constraintSpec
   [
      scheme = "isoschematron"
      ident = "numbered-vs-unnumbered"
      " "
      " A single TEI in Libraries document should not mix numbered and unnumbered divisions."
      " "
      " "
      """ The use of divisions (i.e., whether numbered or unnumbered divisions are used) should be documented in a <tagUsage> element by "Unnumbered divs used." or "Numbered divs used." The <tagUsage> element must be the child of a <namespace name="http://www.tei-c.org/ns/1.0"> element."""
      " "
      " "
      """ A document that uses un-numbered divisions should specify so by using <tagUsage gi="div">Unnumbered divs used.</tagUsage>; a document that uses numbered divisions should specify so by using <tagUsage gi="div1">Numbered divs used.</tagUsage>."""
   ],
   attribute occurs { text }?,
   attribute withId { text }?,
   attribute render { list { + } }?,
   ( "Unnumbered divs used." | "Numbered divs used." )
}
Legal values are:
Unnumbered divs used.
Numbered divs used.
1.8.2.40. <tagsDecl>
<tagsDecl> (tagging declaration) provides detailed information about the tagging applied to a document. [2.3.4. The Tagging Declaration 2.3. The Encoding Description]
Moduleheader — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
partialindicates whether the element types listed exhaustively include all those found within <text>, or represent only a subset.
StatusRecommended
Datatypeteidata.truthValue
Note

TEI recommended practice is to specify this attribute. When the <tagUsage> elements inside <tagsDecl> are used to list each of the element types in the associated <text>, the value should be given as false. When the <tagUsage> elements inside <tagsDecl> are used to provide usage information or default renditions for only a subset of the elements types within the associated <text>, the value should be true.

Contained by
header: encodingDesc
May contain
Example
<tagsDecl partial="true">  <rendition xml:id="rend-itscheme="css"   selector="emph hi name title">font-style: italic;</rendition>  <namespace name="http://www.tei-c.org/ns/1.0">   <tagUsage gi="hioccurs="467"/>   <tagUsage gi="titleoccurs="45"/>  </namespace>  <namespace name="http://docbook.org/ns/docbook">   <tagUsage gi="paraoccurs="10"/>  </namespace> </tagsDecl>
If the partial attribute were not specified here, the implication would be that the document in question contains only <hi>, <title>, and <para> elements.
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="rendition" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="namespace"/>
 </sequence>
</content>
    
Schema Declaration
element tagsDecl
{
   lib3_att.global.attributes,
   attribute partial { text }?,
   ( lib3_rendition*, lib3_namespace )
}
1.8.2.41. <taxonomy>
<taxonomy> defines a typology either implicitly, by means of a bibliographic citation, or explicitly by a structured taxonomy. [2.3.7. The Classification Declaration]
Moduleheader — Level 3: Simple Analysis
AttributesAttributesatt.global (xml:id, @n, @xml:lang, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:id(identifier) provides a unique identifier for the element bearing the attribute.
Derived fromatt.global
StatusRequired
DatatypeID
Contained by
May contain
Note

Nested taxonomies are common in many fields, so the <taxonomy> element can be nested.

Example
<taxonomy xml:id="tax.b">  <bibl>Brown Corpus</bibl>  <category xml:id="tax.b.a">   <catDesc>Press Reportage</catDesc>   <category xml:id="tax.b.a1">    <catDesc>Daily</catDesc>   </category>   <category xml:id="tax.b.a2">    <catDesc>Sunday</catDesc>   </category>   <category xml:id="tax.b.a3">    <catDesc>National</catDesc>   </category>   <category xml:id="tax.b.a4">    <catDesc>Provincial</catDesc>   </category>   <category xml:id="tax.b.a5">    <catDesc>Political</catDesc>   </category>   <category xml:id="tax.b.a6">    <catDesc>Sports</catDesc>   </category>  </category>  <category xml:id="tax.b.d">   <catDesc>Religion</catDesc>   <category xml:id="tax.b.d1">    <catDesc>Books</catDesc>   </category>   <category xml:id="tax.b.d2">    <catDesc>Periodicals and tracts</catDesc>   </category>  </category> </taxonomy>
Example
<taxonomy>  <category xml:id="literature">   <catDesc>Literature</catDesc>   <category xml:id="poetry">    <catDesc>Poetry</catDesc>    <category xml:id="sonnet">     <catDesc>Sonnet</catDesc>     <category xml:id="shakesSonnet">      <catDesc>Shakespearean Sonnet</catDesc>     </category>     <category xml:id="petraSonnet">      <catDesc>Petrarchan Sonnet</catDesc>     </category>    </category>    <category xml:id="haiku">     <catDesc>Haiku</catDesc>    </category>   </category>   <category xml:id="drama">    <catDesc>Drama</catDesc>   </category>  </category>  <category xml:id="meter">   <catDesc>Metrical Categories</catDesc>   <category xml:id="feet">    <catDesc>Metrical Feet</catDesc>    <category xml:id="iambic">     <catDesc>Iambic</catDesc>    </category>    <category xml:id="trochaic">     <catDesc>trochaic</catDesc>    </category>   </category>   <category xml:id="feetNumber">    <catDesc>Number of feet</catDesc>    <category xml:id="pentameter">     <catDesc>>Pentameter</catDesc>    </category>    <category xml:id="tetrameter">     <catDesc>>Tetrameter</catDesc>    </category>   </category>  </category> </taxonomy> <!-- elsewhere in document --> <lg ana="#shakesSonnet #iambic #pentameter">  <l>Shall I compare thee to a summer's day</l> <!-- ... --> </lg>
Content model
<content>
 <alternate minOccurs="1" maxOccurs="1">
  <alternate minOccurs="1" maxOccurs="1">
   <alternate minOccurs="1"
    maxOccurs="unbounded">
    <elementRef key="category"/>
    <elementRef key="taxonomy"/>
   </alternate>
   <sequence minOccurs="1" maxOccurs="1">
    <alternate minOccurs="1"
     maxOccurs="unbounded">
     <classRef key="model.glossLike"/>
     <classRef key="model.descLike"/>
    </alternate>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <elementRef key="category"/>
     <elementRef key="taxonomy"/>
    </alternate>
   </sequence>
  </alternate>
  <sequence minOccurs="1" maxOccurs="1">
   <classRef key="model.biblLike"/>
   <alternate minOccurs="0"
    maxOccurs="unbounded">
    <elementRef key="category"/>
    <elementRef key="taxonomy"/>
   </alternate>
  </sequence>
 </alternate>
</content>
    
Schema Declaration
element taxonomy
{
   lib3_att.global.attribute.n,
   lib3_att.global.attribute.xmllang,
   lib3_att.global.attribute.xmlspace,
   lib3_att.global.rendition.attribute.rend,
   lib3_att.global.rendition.attribute.style,
   lib3_att.global.rendition.attribute.rendition,
   lib3_att.global.linking.attribute.corresp,
   lib3_att.global.linking.attribute.synch,
   lib3_att.global.linking.attribute.sameAs,
   lib3_att.global.linking.attribute.copyOf,
   lib3_att.global.linking.attribute.next,
   lib3_att.global.linking.attribute.prev,
   lib3_att.global.linking.attribute.exclude,
   lib3_att.global.linking.attribute.select,
   lib3_att.global.facs.attribute.facs,
   lib3_att.global.change.attribute.change,
   lib3_att.global.responsibility.attribute.cert,
   lib3_att.global.responsibility.attribute.resp,
   lib3_att.global.source.attribute.source,
   attribute xml:id { text },
   (
      (
         ( category | lib3_taxonomy )+
       | (
            ( lib3_model.glossLike | lib3_model.descLike )+,
            ( category | lib3_taxonomy )*
         )
      )
    | ( lib3_model.biblLike, ( category | lib3_taxonomy )* )
   )
}
1.8.2.42. <teiHeader>
<teiHeader> (TEI header) supplies descriptive and declarative metadata associated with a digital resource or set of resources. [2.1.1. The TEI Header and Its Components 15.1. Varieties of Composite Text]
Moduleheader — Level 3: Simple Analysis
AttributesAttributesatt.global (xml:lang, @xml:id, @n, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source)
xml:lang(language) indicates the language of the element content using a ‘tag’ generated according to BCP 47.
Derived fromatt.global
StatusRequired
Datatypeteidata.language
Contained by
textstructure: TEI
May contain
Note

One of the few elements unconditionally required in any TEI document.

Example
<teiHeader>  <fileDesc>   <titleStmt>    <title>Shakespeare: the first folio (1623) in electronic form</title>    <author>Shakespeare, William (1564–1616)</author>    <respStmt>     <resp>Originally prepared by</resp>     <name>Trevor Howard-Hill</name>    </respStmt>    <respStmt>     <resp>Revised and edited by</resp>     <name>Christine Avern-Carr</name>    </respStmt>   </titleStmt>   <publicationStmt>    <distributor>Oxford Text Archive</distributor>    <address>     <addrLine>13 Banbury Road, Oxford OX2 6NN, UK</addrLine>    </address>    <idno type="OTA">119</idno>    <availability>     <p>Freely available on a non-commercial basis.</p>    </availability>    <date when="1968">1968</date>   </publicationStmt>   <sourceDesc>    <bibl>The first folio of Shakespeare, prepared by Charlton Hinman (The Norton Facsimile,        1968)</bibl>   </sourceDesc>  </fileDesc>  <encodingDesc>   <projectDesc>    <p>Originally prepared for use in the production of a series of old-spelling        concordances in 1968, this text was extensively checked and revised for use during the        editing of the new Oxford Shakespeare (Wells and Taylor, 1989).</p>   </projectDesc>   <editorialDecl>    <correction>     <p>Turned letters are silently corrected.</p>    </correction>    <normalization>     <p>Original spelling and typography is retained, except that long s and ligatured          forms are not encoded.</p>    </normalization>   </editorialDecl>   <refsDecl xml:id="ASLREF">    <cRefPattern matchPattern="(\S+) ([^.]+)\.(.*)"     replacementPattern="#xpath(//div1[@n='$1']/div2/[@n='$2']//lb[@n='$3'])">     <p>A reference is created by assembling the following, in the reverse order as that          listed here: <list>       <item>the <att>n</att> value of the preceding <gi>lb</gi>       </item>       <item>a period</item>       <item>the <att>n</att> value of the ancestor <gi>div2</gi>       </item>       <item>a space</item>       <item>the <att>n</att> value of the parent <gi>div1</gi>       </item>      </list>     </p>    </cRefPattern>   </refsDecl>  </encodingDesc>  <revisionDesc>   <list>    <item>     <date when="1989-04-12">12 Apr 89</date> Last checked by CAC</item>    <item>     <date when="1989-03-01">1 Mar 89</date> LB made new file</item>   </list>  </revisionDesc> </teiHeader>
Schematron
<s:report test=".//tei:ab">Use <gi>p</gi> instead of <gi>ab</gi> in the TEI header. (There are <s:value-of select="count(.//tei:ab)"/> <gi>ab</gi> elements in this header.)</s:report>
Content model
<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="fileDesc" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="encodingDesc"
   minOccurs="1" maxOccurs="1"/>
  <elementRef key="profileDesc"
   minOccurs="0" maxOccurs="1"/>
  <elementRef key="revisionDesc"
   minOccurs="0" maxOccurs="1"/>
 </sequence>
</content>
    
Schema Declaration
element teiHeader
{
   lib3_att.global.attribute.xmlid,
   lib3_att.global.attribute.n,
   lib3_att.global.attribute.xmlspace,
   lib3_att.global.rendition.attribute.rend,
   lib3_att.global.rendition.attribute.style,
   lib3_att.global.rendition.attribute.rendition,
   lib3_att.global.linking.attribute.corresp,
   lib3_att.global.linking.attribute.synch,
   lib3_att.global.linking.attribute.sameAs,
   lib3_att.global.linking.attribute.copyOf,
   lib3_att.global.linking.attribute.next,
   lib3_att.global.linking.attribute.prev,
   lib3_att.global.linking.attribute.exclude,
   lib3_att.global.linking.attribute.select,
   lib3_att.global.facs.attribute.facs,
   lib3_att.global.change.attribute.change,
   lib3_att.global.responsibility.attribute.cert,
   lib3_att.global.responsibility.attribute.resp,
   lib3_att.global.source.attribute.source,
   attribute xml:lang { text },
   ( lib3_fileDesc, lib3_encodingDesc, lib3_profileDesc?, lib3_revisionDesc? )
}
1.8.2.43. <title>
<title> contains a title for any kind of work. [3.11.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.5. The Series Statement]
Modulecore — Level 3: Simple Analysis
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
type
StatusRecommended
Datatypeteidata.enumerated
Schematron
<s:rule context="tei:titleStmt/tei:title"> <s:assert test="@type">Inside the title statment the @type of a <title> should be specified</s:assert> </s:rule> <s:rule context="tei:monogr/tei:title"> <s:assert test="@type">Inside a structured bibliographic citation of a mongraphic-level item, @type of a <title> should be specified</s:assert> </s:rule> <s:rule context="tei:analytic/tei:title"> <s:assert test="@type">Inside the analytic portion of a structured bibliographic citation, @type of a <title> should be specified</s:assert> </s:rule> <s:rule context="tei:relatedItem/tei:bibl/tei:title"> <s:assert test="@type">Inside a bibliographic citation of a related item, the @type of a <title> should be specified</s:assert> </s:rule>
Suggested values include:
main
main title
sub
(subordinate) subtitle, title of part
alt
(alternate) alternate title, often in another language, by which the work is also known
short
abbreviated form of title
desc
(descriptive)
translated
a translation of a title
marc245a
used for the title proper and alternative title according to the national cataloging code
marc245b
used for the the remainder of the title information — parallel titles, titles subsequent to the first, and other title information — according to the national cataloging code)
marc245c
used for the statement of responsibility according to the national cataloging code
uniform
used for a uniform title according to the national cataloging code
levelindicates the bibliographic level for a title, that is, whether it identifies an article, book, journal, series, or unpublished material.
StatusOptional
Schematron
<s:rule context="tei:fileDesc/tei:titleStmt/tei:title"> <s:report test="@level">The @level attribute should not be specified on a <title> within the <titleStmt>.</s:report> </s:rule> <s:rule context="tei:title[parent::tei:seriesStmt]"> <s:assert test="@level='s'">When a child of <seriesStmt>, the level of a title should be specified as 's'.</s:assert> </s:rule> <s:rule context="tei:title[ancestor::tei:series]"> <s:assert test="@level='s'">When inside the series-level portion of a structured bibliographic citation, the level of a title should be specified as 's'.</s:assert> </s:rule> <s:rule context="tei:title[parent::tei:analytic]"> <s:assert test="@level='a'">When a child of <analytic>, the level of a title should be specified as 'a'.</s:assert> </s:rule> <s:rule context="tei:title[parent::tei:monogr]"> <s:report test="@level='a'">When a child of <monogr>, the level of a title should not be specified as 'a'.</s:report> </s:rule>
Legal values are:
a
(analytic) analytic title (article, poem, or other item published as part of a larger item)
m
(monographic) monographic title (book, collection, or other item published as a distinct item, including single volumes of multi-volume works)
j
(journal) journal title
s
(series) series title
u
(unpublished) title of unpublished material (including theses and dissertations unless published by a commercial press)
Note

The level of a title is sometimes implied by its context: for example, a title appearing directly within an <analytic> element is ipso facto of level a, and one appearing within a <series> element of level s. For this reason, the level attribute is not required in contexts where its value can be unambiguously inferred. Where it is supplied in such contexts, its value should not contradict the value implied by its parent element.

Member of
Contained by
May contain
Note

The attributes key and ref, inherited from the class att.canonical may be used to indicate the canonical form for the title; the former, by supplying (for example) the identifier of a record in some external library system; the latter by pointing to an XML element somewhere containing the canonical form of the title.

Example
<title>Information Technology and the Research Process: Proceedings of a conference held at Cranfield Institute of Technology, UK, 18–21 July 1989</title>
Example
<title>Hardy's Tess of the D'Urbervilles: a machine readable edition</title>
Example
<title type="full">  <title type="main">Synthèse</title>  <title type="sub">an international journal for    epistemology, methodology and history of    science</title> </title>
Content model
<content>
 <macroRef key="macro.paraContent"/>
</content>
    
Schema Declaration
element title
{
   lib3_att.global.attributes,
   lib3_att.canonical.attributes,
   lib3_att.datable.attributes,
   attribute type
   {
      "main"
    | "sub"
    | "alt"
    | "short"
    | "desc"
    | "translated"
    | "marc245a"
    | "marc245b"
    | "marc245c"
    | "uniform"
   }?
   >>
   tei:constraintSpec
   [
      scheme = "isoschematron"
      ident = "titleType"
      " "
      "Inside the title statment the @type of a <title> should be specified"
      " "
      " "
      "Inside a structured bibliographic citation of a mongraphic-level item, @type of a <title> should be specified"
      " "
      " "
      "Inside the analytic portion of a structured bibliographic citation, @type of a <title> should be specified"
      " "
      " "
      "Inside a bibliographic citation of a related item, the @type of a <title> should be specified"
   ],
   attribute level { "a" | "m" | "j" | "s" | "u" }?
   >>
   tei:constraintSpec
   [
      scheme = "isoschematron"
      ident = "titleLevel"
      " "
      "The @level attribute should not be specified on a <title> within the <titleStmt>."
      " "
      " "
      """When a child of <seriesStmt>, the level of a title should be specified as 's'."""
      " "
      " "
      """When inside the series-level portion of a structured bibliographic citation, the level of a title should be specified as 's'."""
      " "
      " "
      """When a child of <analytic>, the level of a title should be specified as 'a'."""
      " "
      " "
      """When a child of <monogr>, the level of a title should not be specified as 'a'."""
   ],
   lib3_macro.paraContent
}

1.8.3. Schema lib3: unchanged components

ab: (anonymous block) contains any arbitrary component-level unit of text, acting as an anonymous container for phrase or inter level elements analogous to, but without the semantic baggage of, a paragraph. [16.3. Blocks, Segments, and Anchors]
abbr: (abbreviation) contains an abbreviation of any sort. [3.5.5. Abbreviations and Their Expansions]
addrLine: (address line) contains one line of a postal address. [3.5.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.11.2.4. Imprint, Size of a Document, and Reprint Information]
address: contains a postal address, for example of a publisher, an organization, or an individual. [3.5.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.11.2.4. Imprint, Size of a Document, and Reprint Information]
analytic: (analytic level) contains bibliographic elements describing an item (e.g. an article or poem) published within a monograph or journal and not as an independent publication. [3.11.2.1. Analytic, Monographic, and Series Levels]
appInfo: (application information) records information about an application which has edited the TEI file. [2.3.10. The Application Information Element]
application: provides information about an application which has acted upon the document. [2.3.10. The Application Information Element]
att: (attribute) contains the name of an attribute appearing within running text. [22. Documentation Elements]
att.ascribed: provides attributes for elements representing speech or action that can be ascribed to a specific individual. [3.3.3. Quotation 8.3. Elements Unique to Spoken Texts]
att.breaking: provides an attribute to indicate whether or not the element concerned is considered to mark the end of an orthographic token in the same way as whitespace. [3.10.3. Milestone Elements]
att.cReferencing: provides an attribute which may be used to supply a canonical reference as a means of identifying the target of a pointer.
att.canonical: provides attributes which can be used to associate a representation such as a name or title with canonical information about the object being named or referenced.
att.citing: provides attributes for specifying the specific part of a bibliographic item being cited. [1.3.1. Attribute Classes]
att.datable: provides attributes for normalization of elements that contain dates, times, or datable events. [3.5.4. Dates and Times 13.3.6. Dates and Times]
att.datable.custom: provides attributes for normalization of elements that contain datable events to a custom dating system (i.e. other than the Gregorian used by W3 and ISO). [13.3.6. Dates and Times]
att.datable.w3c: provides attributes for normalization of elements that contain datable events conforming to the W3C XML Schema Part 2: Datatypes Second Edition. [3.5.4. Dates and Times 13.3.6. Dates and Times]
att.docStatus: provides attributes for use on metadata elements describing the status of a document.
att.edition: provides attributes identifying the source edition from which some encoded feature derives.
att.fragmentable: provides an attribute for representing fragmentation of a structural element, typically as a consequence of some overlapping hierarchy.
att.global.change: supplies the change attribute, allowing its member elements to specify one or more states or revision campaigns with which they are associated.
att.global.facs: provides an attribute used to express correspondence between an element containing transcribed text and all or part of an image representing that text. [11.1. Digital Facsimiles]
att.global.linking: provides a set of attributes for hypertextual linking. [16. Linking, Segmentation, and Alignment]
att.global.rendition: provides rendering attributes common to all elements in the TEI encoding scheme. [1.3.1.1.3. Rendition Indicators]
att.global.responsibility: provides attributes indicating the agent responsible for some aspect of the text, the markup or something asserted by the markup, and the degree of certainty associated with it. [1.3.1.1.4. Sources, certainty, and responsibility 3.4. Simple Editorial Changes 11.3.2.2. Hand, Responsibility, and Certainty Attributes 17.3. Spans and Interpretations 13.1.1. Linking Names and Their Referents]
att.global.source: provides an attribute used by elements to point to an external source. [1.3.1.1.4. Sources, certainty, and responsibility 3.3.3. Quotation 8.3.4. Writing]
att.internetMedia: provides attributes for specifying the type of a computer resource using a standard taxonomy.
att.media: provides attributes for specifying display and related properties of external media.
att.personal: (attributes for components of names usually, but not necessarily, personal names) common attributes for those elements which form part of a name usually, but not necessarily, a personal name. [13.2.1. Personal Names]
att.placement: provides attributes for describing where on the source page or object a textual element appears. [3.4.3. Additions, Deletions, and Omissions 11.3.1.4. Additions and Deletions]
att.pointing: provides a set of attributes used by all elements which point to other elements by means of one or more URI references. [1.3.1.1.2. Language Indicators 3.6. Simple Links and Cross-References]
att.resourced: provides attributes by which a resource (such as an externally held media file) may be located.
att.sortable: provides attributes for elements in lists or groups that are sortable, but whose sorting key cannot be derived mechanically from the element content. [9.1. Dictionary Body and Overall Structure]
att.spanning: provides attributes for elements which delimit a span of text by pointing mechanisms rather than by enclosing it. [11.3.1.4. Additions and Deletions 1.3.1. Attribute Classes]
att.styleDef: provides attributes to specify the name of a formal definition language used to provide formatting or rendition information.
att.tableDecoration: provides attributes used to decorate rows or cells of a table. [14. Tables, Formulæ, Graphics and Notated Music]
att.timed: provides attributes common to those elements which have a duration in time, expressed either absolutely or by reference to an alignment map. [8.3.5. Temporal Information]
att.written: provides an attribute to indicate the hand in which the textual content of an element was written in the source being transcribed. [1.3.1. Attribute Classes]
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.]
biblScope: (scope of bibliographic reference) defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work. [3.11.2.5. Scopes and Ranges in Bibliographic Citations]
biblStruct: (structured bibliographic citation) contains a structured bibliographic citation, in which only bibliographic sub-elements appear and in a specified order. [3.11.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements]
cb: (column break) marks the beginning of a new column of a text on a multi-column page. [3.10.3. Milestone Elements]
cell: contains one cell of a table. [14.1.1. TEI Tables]
choice: groups a number of alternative encodings for the same point in a text. [3.4. Simple Editorial Changes]
cit: (cited quotation) contains a quotation from some other document, together with a bibliographic reference to its source. In a dictionary it may contain an example text with at least one occurrence of the word form, used in the sense being described, or a translation of the headword, or an example. [3.3.3. Quotation 4.3.1. Grouped Texts 9.3.5.1. Examples]
citedRange: (cited range) defines the range of cited content, often represented by pages or other units [3.11.2.5. Scopes and Ranges in Bibliographic Citations]
classCode: (classification code) contains the classification code used for this text in some standard classification system. [2.4.3. The Text Classification]
classDecl: (classification declarations) contains one or more taxonomies defining any classificatory codes used elsewhere in the text. [2.3.7. The Classification Declaration 2.3. The Encoding Description]
correction: (correction principles) states how and under what circumstances corrections have been made in the text. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]
date: contains a date in any format. [3.5.4. Dates and Times 2.2.4. Publication, Distribution, Licensing, etc. 2.6. The Revision Description 3.11.2.4. Imprint, Size of a Document, and Reprint Information 15.2.3. The Setting Description 13.3.6. Dates and Times]
distributor: supplies the name of a person or other agency responsible for the distribution of a text. [2.2.4. Publication, Distribution, Licensing, etc.]
edition: describes the particularities of one edition of a text. [2.2.2. The Edition Statement]
editionStmt: (edition statement) groups information relating to one edition of a text. [2.2.2. The Edition Statement 2.2. The File Description]
email: (electronic mail address) contains an email address identifying a location to which email messages can be delivered. [3.5.2. Addresses]
emph: (emphasized) marks words or phrases which are stressed or emphasized for linguistic or rhetorical effect. [3.3.2.2. Emphatic Words and Phrases 3.3.2. Emphasis, Foreign Words, and Unusual Language]
expan: (expansion) contains the expansion of an abbreviation. [3.5.5. Abbreviations and Their Expansions]
extent: describes the approximate size of a text stored on some carrier medium or of some other object, digital or non-digital, specified in any convenient units. [2.2.3. Type and Extent of File 2.2. The File Description 3.11.2.4. Imprint, Size of a Document, and Reprint Information 10.7.1. Object Description]
figure: groups elements representing or containing graphic information such as an illustration, formula, or figure. [14.4. Specific Elements for Graphic Images]
fileDesc: (file description) contains a full bibliographic description of an electronic file. [2.2. The File Description 2.1.1. The TEI Header and Its Components]
floatingText: contains a single text of any kind, whether unitary or composite, which interrupts the text containing it at any point and after which the surrounding text resumes. [4.3.2. Floating Texts]
foreign: identifies a word or phrase as belonging to some language other than that of the surrounding text. [3.3.2.1. Foreign Words or Expressions]
gi: (element name) contains the name (generic identifier) of an element. [22. Documentation Elements 22.5. Element Specifications]
graphic: indicates the location of a graphic or illustration, either forming part of a text, or providing an image of it. [3.9. Graphics and Other Non-textual Components 11.1. Digital Facsimiles]
hi: (highlighted) marks a word or phrase as graphically distinct from the surrounding text, for reasons concerning which no claim is made. [3.3.2.2. Emphatic Words and Phrases 3.3.2. Emphasis, Foreign Words, and Unusual Language]
imprint: groups information relating to the publication or distribution of a bibliographic item. [3.11.2.4. Imprint, Size of a Document, and Reprint Information]
item: contains one component of a list. [3.7. Lists 2.6. The Revision Description]
keywords: contains a list of keywords or phrases identifying the topic or nature of a text. [2.4.3. The Text Classification]
l: (verse line) contains a single, possibly incomplete, line of verse. [3.12.1. Core Tags for Verse 3.12. Passages of Verse or Drama 7.2.5. Speech Contents]
label: contains any label or heading used to identify part of a text, typically but not exclusively in a list or glossary. [3.7. Lists]
langUsage: (language usage) describes the languages, sublanguages, registers, dialects, etc. represented within a text. [2.4.2. Language Usage 2.4. The Profile Description 15.3.2. Declarable Elements]
language: characterizes a single language or sublanguage used within a text. [2.4.2. Language Usage]
lb: (line break) marks the start of a new (typographic) line in some edition or version of a text. [3.10.3. Milestone Elements 7.2.5. Speech Contents]
lg: (line group) contains one or more verse lines functioning as a formal unit, e.g. a stanza, refrain, verse paragraph, etc. [3.12.1. Core Tags for Verse 3.12. Passages of Verse or Drama 7.2.5. Speech Contents]
list: contains any sequence of items organized as a list. [3.7. Lists]
macro.limitedContent: (paragraph content) defines the content of prose elements that are not used for transcription of extant materials. [1.3. The TEI Class System]
macro.paraContent: (paragraph content) defines the content of paragraphs and similar elements. [1.3. The TEI Class System]
macro.phraseSeq: (phrase sequence) defines a sequence of character data and phrase-level elements. [1.4.1. Standard Content Models]
macro.phraseSeq.limited: (limited phrase sequence) defines a sequence of character data and those phrase-level elements that are not typically used for transcribing extant documents. [1.4.1. Standard Content Models]
macro.specialPara: ('special' paragraph content) defines the content model of elements such as notes or list items, which either contain a series of component-level elements or else have the same structure as a paragraph, containing a series of phrase-level and inter-level elements. [1.3. The TEI Class System]
media: indicates the location of any form of external media such as an audio or video clip etc. [3.9. Graphics and Other Non-textual Components]
model.addrPart: groups elements such as names or postal codes which may appear as part of a postal address. [3.5.2. Addresses]
model.addressLike: groups elements used to represent a postal or email address. [1. The TEI Infrastructure]
model.applicationLike: groups elements used to record application-specific information about a document in its header.
model.availabilityPart: groups elements such as licences and paragraphs of text which may appear as part of an availability statement [2.2.4. Publication, Distribution, Licensing, etc.]
model.biblLike: groups elements containing a bibliographic description. [3.11. Bibliographic Citations and References]
model.biblPart: groups elements which represent components of a bibliographic description. [3.11. Bibliographic Citations and References]
model.choicePart: groups elements (other than <choice> itself) which can be used within a <choice> alternation. [3.4. Simple Editorial Changes]
model.common: groups common chunk- and inter-level elements. [1.3. The TEI Class System]
model.dateLike: groups elements containing temporal expressions. [3.5.4. Dates and Times 13.3.6. Dates and Times]
model.descLike: groups elements which contain a description of their function.
model.div1Like: groups top-level structural divisions.
model.div2Like: groups second-level structural divisions.
model.div3Like: groups third-level structural divisions.
model.div4Like: groups fourth-level structural divisions.
model.div5Like: groups fifth-level structural divisions.
model.div6Like: groups sixth-level structural divisions.
model.div7Like: groups seventh-level structural divisions.
model.divGenLike: groups elements used to represent a structural division which is generated rather than explicitly present in the source.
model.divLike: groups elements used to represent un-numbered generic structural divisions.
model.divPart: groups paragraph-level elements appearing directly within divisions. [1.3. The TEI Class System]
model.divTop: groups elements appearing at the beginning of a text division. [4.2. Elements Common to All Divisions]
model.divTopPart: groups elements which can occur only at the beginning of a text division. [4.6. Title Pages]
model.egLike: groups elements containing examples or illustrations. [22.1.1. Phrase Level Terms]
model.emphLike: groups phrase-level elements which are typographically distinct and to which a specific function can be attributed. [3.3. Highlighting and Quotation]
model.entryPart: groups non-morphological elements appearing within a dictionary entry. [9.1. Dictionary Body and Overall Structure]
model.gLike: groups elements used to represent individual non-Unicode characters or glyphs.
model.global: groups elements which may appear at any point within a TEI text. [1.3. The TEI Class System]
model.global.edit: groups globally available elements which perform a specifically editorial function. [1.3. The TEI Class System]
model.global.meta: groups globally available elements which describe the status of other elements. [1.3. The TEI Class System]
model.glossLike: groups elements which provide an alternative name, explanation, or description for any markup construct.
model.graphicLike: groups elements containing images, formulae, and similar objects. [3.9. Graphics and Other Non-textual Components]
model.headLike: groups elements used to provide a title or heading at the start of a text division.
model.hiLike: groups phrase-level elements which are typographically distinct but to which no specific function can be attributed. [3.3. Highlighting and Quotation]
model.highlighted: groups phrase-level elements which are typographically distinct. [3.3. Highlighting and Quotation]
model.imprintPart: groups the bibliographic elements which occur inside imprints. [3.11. Bibliographic Citations and References]
model.inter: groups elements which can appear either within or between paragraph-like elements. [1.3. The TEI Class System]
model.lLike: groups elements representing metrical components such as verse lines.
model.lPart: groups phrase-level elements which may appear within verse only. [6.2. Components of the Verse Line]
model.labelLike: groups elements used to gloss or explain other parts of a document.
model.limitedPhrase: groups phrase-level elements excluding those elements primarily intended for transcription of existing sources. [1.3. The TEI Class System]
model.listLike: groups list-like elements. [3.7. Lists]
model.measureLike: groups elements which denote a number, a quantity, a measurement, or similar piece of text that conveys some numerical meaning. [3.5.3. Numbers and Measures]
model.milestoneLike: groups milestone-style elements used to represent reference systems. [1.3. The TEI Class System 3.10.3. Milestone Elements]
model.nameLike: groups elements which name or refer to a person, place, or organization.
model.nameLike.agent: groups elements which contain names of individuals or corporate bodies. [3.5. Names, Numbers, Dates, Abbreviations, and Addresses]
model.noteLike: groups globally-available note-like elements. [3.8. Notes, Annotation, and Indexing]
model.oddDecl: groups elements which generate declarations in some markup language in ODD documents.
model.offsetLike: groups elements which can appear only as part of a place name. [13.2.3. Place Names]
model.pLike: groups paragraph-like elements.
model.pPart.data: groups phrase-level elements containing names, dates, numbers, measures, and similar data. [3.5. Names, Numbers, Dates, Abbreviations, and Addresses]
model.pPart.edit: groups phrase-level elements for simple editorial correction and transcription. [3.4. Simple Editorial Changes]
model.pPart.editorial: groups phrase-level elements for simple editorial interventions that may be useful both in transcribing and in authoring. [3.4. Simple Editorial Changes]
model.pPart.msdesc: groups phrase-level elements used in manuscript description. [10. Manuscript Description]
model.pPart.transcriptional: groups phrase-level elements used for editorial transcription of pre-existing source materials. [3.4. Simple Editorial Changes]
model.persNamePart: groups elements which form part of a personal name. [13.2.1. Personal Names]
model.phrase: groups elements which can occur at the level of individual words or phrases. [1.3. The TEI Class System]
model.phrase.xml: groups phrase-level elements used to encode XML constructs such as element names, attribute names, and attribute values [22. Documentation Elements]
model.placeNamePart: groups elements which form part of a place name. [13.2.3. Place Names]
model.placeStateLike: groups elements which describe changing states of a place.
model.profileDescPart: groups elements which may be used inside <profileDesc> and appear multiple times.
model.ptrLike: groups elements used for purposes of location and reference. [3.6. Simple Links and Cross-References]
model.publicationStmtPart.agency: groups the child elements of a <publicationStmt> element of the TEI header that indicate an authorising agent. [2.2.4. Publication, Distribution, Licensing, etc.]
model.publicationStmtPart.detail: groups the agency-specific child elements of the <publicationStmt> element of the TEI header. [2.2.4. Publication, Distribution, Licensing, etc.]
model.qLike: groups elements related to highlighting which can appear either within or between chunk-level elements. [3.3. Highlighting and Quotation]
model.quoteLike: groups elements used to directly contain quotations.
model.respLike: groups elements which are used to indicate intellectual or other significant responsibility, for example within a bibliographic element.
model.segLike: groups elements used for arbitrary segmentation. [16.3. Blocks, Segments, and Anchors 17.1. Linguistic Segment Categories]
model.specDescLike: groups elements for referring to specification elements. [22. Documentation Elements]
model.stageLike: groups elements containing stage directions or similar things defined by the module for performance texts. [7.3. Other Types of Performance Text]
monogr: (monographic level) contains bibliographic elements describing an item (e.g. a book or journal) published as an independent item (i.e. as a separate physical object). [3.11.2.1. Analytic, Monographic, and Series Levels]
name: (name, proper noun) contains a proper noun or noun phrase. [3.5.1. Referring Strings]
no-extent-in-fileDesc:
normalization: indicates the extent of normalization or regularization of the original source carried out in converting it to electronic form. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]
notesStmt: (notes statement) collects together any notes providing information about a text additional to that recorded in other parts of the bibliographic description. [2.2.6. The Notes Statement 2.2. The File Description]
onlyAllowedAttrs:
p: (paragraph) marks paragraphs in prose. [3.1. Paragraphs 7.2.5. Speech Contents]
postBox: (postal box or post office box) contains a number or other identifier for some postal delivery point other than a street address. [3.5.2. Addresses]
postCode: (postal code) contains a numerical or alphanumeric code used as part of a postal address to simplify sorting or delivery of mail. [3.5.2. Addresses]
profileDesc: (text-profile description) provides a detailed description of non-bibliographic aspects of a text, specifically the languages and sublanguages used, the situation in which it was produced, the participants and their setting. [2.4. The Profile Description 2.1.1. The TEI Header and Its Components]
projectDesc: (project description) describes in detail the aim or purpose for which an electronic file was encoded, together with any other relevant information concerning the process by which it was assembled or collected. [2.3.1. The Project Description 2.3. The Encoding Description 15.3.2. Declarable Elements]
pubPlace: (publication place) contains the name of the place where a bibliographic item was published. [3.11.2.4. Imprint, Size of a Document, and Reprint Information]
publisher: provides the name of the organization responsible for the publication or distribution of a bibliographic item. [3.11.2.4. Imprint, Size of a Document, and Reprint Information 2.2.4. Publication, Distribution, Licensing, etc.]
punctuation: specifies editorial practice adopted with respect to punctuation marks in the original. [2.3.3. The Editorial Practices Declaration 3.2. Treatment of Punctuation]
q: (quoted) contains material which is distinguished from the surrounding text using quotation marks or a similar method, for any one of a variety of reasons including, but not limited to: direct speech or thought, technical terms or jargon, authorial distance, quotations from elsewhere, and passages that are mentioned but not used. [3.3.3. Quotation]
quotation: specifies editorial practice adopted with respect to quotation marks in the original. [2.3.3. The Editorial Practices Declaration 15.3.2. Declarable Elements]
relatedItem: contains or references some other bibliographic item which is related to the present one in some specified manner, for example as a constituent or alternative version of it. [3.11.2.7. Related Items]
resp: (responsibility) contains a phrase describing the nature of a person's intellectual responsibility, or an organization's role in the production or distribution of a work. [3.11.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement 2.2.2. The Edition Statement 2.2.5. The Series Statement]
revisionDesc: (revision description) summarizes the revision history for a file. [2.6. The Revision Description 2.1.1. The TEI Header and Its Components]
row: contains one row of a table. [14.1.1. TEI Tables]
samplingDecl: (sampling declaration) contains a prose description of the rationale and methods used in sampling texts in the creation of a corpus or collection. [2.3.2. The Sampling Declaration 2.3. The Encoding Description 15.3.2. Declarable Elements]
series: (series information) contains information about the series in which a book or other bibliographic item has appeared. [3.11.2.1. Analytic, Monographic, and Series Levels]
seriesStmt: (series statement) groups information about the series, if any, to which a publication belongs. [2.2.5. The Series Statement 2.2. The File Description]
street: contains a full street address including any name or number identifying a building as well as the name of the street or route on which it is located. [3.5.2. Addresses]
table: contains text displayed in tabular form, in rows and columns. [14.1.1. TEI Tables]
tag: contains text of a complete start- or end-tag, possibly including attribute specifications, but excluding the opening and closing markup delimiter characters. [22. Documentation Elements]
teidata.certainty: defines the range of attribute values expressing a degree of certainty.
teidata.count: defines the range of attribute values used for a non-negative integer value used as a count.
teidata.duration.iso: defines the range of attribute values available for representation of a duration in time using ISO 8601 standard formats
teidata.duration.w3c: defines the range of attribute values available for representation of a duration in time using W3C datatypes.
teidata.enumerated: defines the range of attribute values expressed as a single XML name taken from a list of documented possibilities.
teidata.language: defines the range of attribute values used to identify a particular combination of human language and writing system. [6.1. Language Identification]
teidata.name: defines the range of attribute values expressed as an XML Name.
teidata.namespace: defines the range of attribute values used to indicate XML namespaces as defined by the W3C Namespaces in XML Technical Recommendation.
teidata.numeric: defines the range of attribute values used for numeric values.
teidata.outputMeasurement: defines a range of values for use in specifying the size of an object that is intended for display.
teidata.pattern: defines attribute values which are expressed as a regular expression.
teidata.pointer: defines the range of attribute values used to provide a single URI, absolute or relative, pointing to some other resource, either within the current document or elsewhere.
teidata.probCert: defines a range of attribute values which can be expressed either as a numeric probability or as a coded certainty value.
teidata.probability: defines the range of attribute values expressing a probability.
teidata.replacement: defines attribute values which contain a replacement template.
teidata.temporal.w3c: defines the range of attribute values expressing a temporal expression such as a date, a time, or a combination of them, that conform to the W3C XML Schema Part 2: Datatypes Second Edition specification.
teidata.text: defines the range of attribute values used to express some kind of identifying string as a single sequence of unicode characters possibly including whitespace.
teidata.truthValue: defines the range of attribute values used to express a truth value.
teidata.unboundedInt: defines an attribute value which can be either any non-negative integer or the string "unbounded".
teidata.version: defines the range of attribute values which may be used to specify a TEI or Unicode version number.
teidata.versionNumber: defines the range of attribute values used for version numbers.
teidata.word: defines the range of attribute values expressed as a single word or token.
teidata.xmlName: defines attribute values which contain an XML name.
term: contains a single-word, multi-word, or symbolic designation which is regarded as a technical term. [3.3.4. Terms, Glosses, Equivalents, and Descriptions]
text: contains a single text of any kind, whether unitary or composite, for example a poem or drama, a collection of essays, a novel, a dictionary, or a corpus sample. [4. Default Text Structure 15.1. Varieties of Composite Text]
textClass: (text classification) groups information which describes the nature or topic of a text in terms of a standard classification scheme, thesaurus, etc. [2.4.3. The Text Classification]
textLang: (text language) describes the languages and writing systems identified within the bibliographic work being described, rather than its description. [3.11.2.4. Imprint, Size of a Document, and Reprint Information 10.6.6. Languages and Writing Systems]
titleStmt: (title statement) groups information about the title of a work and those responsible for its content. [2.2.1. The Title Statement 2.2. The File Description]
val: (value) contains a single attribute value. [22. Documentation Elements 22.5.4. Attribute List Specification]
when-or-before-after:
TEI SIG on Libraries. Date: 2017-10-30