TEI customization for documentation of Gezelle correspondence edition.

This element is required. It is customary to specify the TEI namespace http://www.tei-c.org/ns/1.0 on it, using the xmlns attribute.

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="teiHeader"/>
  <alternate minOccurs="1" maxOccurs="1">
   <sequence minOccurs="1" maxOccurs="1">
    <classRef key="model.resource"
     minOccurs="1" maxOccurs="unbounded"/>
    <elementRef key="TEI" minOccurs="0"
     maxOccurs="unbounded"/>
   </sequence>
   <elementRef key="TEI" minOccurs="1"
    maxOccurs="unbounded"/>
  </alternate>
 </sequence>
</content>
    

element TEI
{
   tei_att.global.attributes,
   tei_att.typed.attributes,
   ( tei_teiHeader, ( ( tei_model.resource+, tei_TEI* ) | tei_TEI+ ) )
}

If abbreviations are expanded silently, this practice should be documented in the <editorialDecl>, either with a <normalization> element or a <p>.

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

element abbr
{
   tei_att.global.attributes,
   attribute type { text }?,
   tei_macro.phraseSeq
}

Addresses may be encoded either as a sequence of lines, or using any sequence of component elements from the model.addrPart class. Other non-postal forms of address, such as telephone numbers or email, should not be included within an <address> element directly but may be wrapped within an <addrLine> if they form part of the printed address in some source text.

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

element addrLine { tei_att.global.attributes, tei_macro.phraseSeq }

This element should be used for postal addresses only. Within it, the generic element <addrLine> may be used as an alternative to any of the more specialized elements available from the model.addrPart class, such as <street>, <postCode> etc.

<content>
 <sequence>
  <classRef key="model.global"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.addrPart"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
    

element address
{
   tei_att.global.attributes,
   ( tei_model.global*, ( tei_model.addrPart, tei_model.global* )+ )
}

If included, the name of an organization may be tagged using either the <name> element as above, or the more specific <orgName> element.

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

element affiliation
{
   tei_att.global.attributes,
   tei_att.editLike.attributes,
   tei_att.datable.w3c.attribute.when,
   tei_att.datable.w3c.attribute.notBefore,
   tei_att.datable.w3c.attribute.from,
   tei_att.datable.w3c.attribute.to,
   attribute type { text }?,
   tei_macro.phraseSeq
}

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

element appInfo { tei_att.global.attributes, tei_model.applicationLike+ }

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

element application
{
   tei_att.global.attributes,
   tei_att.datable.w3c.attribute.when,
   tei_att.datable.w3c.attribute.notBefore,
   tei_att.datable.w3c.attribute.from,
   tei_att.datable.w3c.attribute.to,
   attribute ident { text },
   attribute version { text },
   ( tei_model.labelLike+, ( tei_model.ptrLike* | tei_model.pLike* ) )
}

As an alternative to using the scheme attribute a namespace prefix may be used. Where both scheme and a prefix are used, the prefix takes precedence.

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

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

Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use a generally recognized name authority file to supply the content for this element. The attributes key or ref may also be used to reference canonical information about the author(s) intended from any appropriate authority, such as a library catalogue or online resource.

In the case of a broadcast, use this element for the name of the company or network responsible for making the broadcast.

Where an author is unknown or unspecified, this element may contain text such as Unknown or Anonymous. When the appropriate TEI modules are in use, it may also contain detailed tagging of the names used for people, organizations or places, in particular where multiple names are given.

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

element author
{
   tei_att.global.attributes,
   tei_att.naming.attributes,
   tei_macro.phraseSeq
}

A consistent format should be adopted

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

element availability
{
   tei_att.global.attributes,
   attribute status { "free" | "unknown" | "restricted" }?,
   ( tei_model.availabilityPart | tei_model.pLike )+
}

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.

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.frontPart"/>
   <classRef key="model.pLike.front"/>
   <classRef key="model.pLike"/>
   <classRef key="model.listLike"/>
   <classRef key="model.global"/>
  </alternate>
  <alternate minOccurs="0" maxOccurs="1">
   <sequence minOccurs="1" maxOccurs="1">
    <classRef key="model.div1Like"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.frontPart"/>
     <classRef key="model.div1Like"/>
     <classRef key="model.global"/>
    </alternate>
   </sequence>
   <sequence minOccurs="1" maxOccurs="1">
    <classRef key="model.divLike"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.frontPart"/>
     <classRef key="model.divLike"/>
     <classRef key="model.global"/>
    </alternate>
   </sequence>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <classRef key="model.divBottomPart"/>
   <alternate minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottomPart"/>
    <classRef key="model.global"/>
   </alternate>
  </sequence>
 </sequence>
</content>
    

element back
{
   tei_att.global.attributes,
   (
      (
         tei_model.frontPart
       | tei_model.pLike.front
       | tei_model.pLike
       | tei_model.listLike
       | tei_model.global
      )*,
      (
         (
            tei_model.div1Like,
            ( tei_model.frontPart | tei_model.div1Like | tei_model.global )*
         )
       | (
            tei_model.divLike,
            ( tei_model.frontPart | tei_model.divLike | tei_model.global )*
         )
      )?,
      (
         tei_model.divBottomPart,
         ( tei_model.divBottomPart | tei_model.global )*
      )?
   )
}

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

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

element bibl
{
   tei_att.global.attributes,
   (
      text
    | tei_model.gLike
    | tei_model.highlighted
    | tei_model.pPart.data
    | tei_model.pPart.edit
    | tei_model.segLike
    | tei_model.ptrLike
    | tei_model.biblPart
    | tei_model.global
   )*
}

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

It is now considered good practice to supply this element as a sibling (rather than a child) of <imprint>, since it supplies information which does not constitute part of the imprint.

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

element biblScope
{
   tei_att.global.attributes,
   attribute unit { "chapter" | "issue" | "page" | "part" | "volume" }?,
   tei_macro.phraseSeq
}

<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.divLike"/>
      <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.divLike"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    

element body
{
   tei_att.global.attributes,
   (
      ( tei_model.divTop | tei_model.global )*,
      (
         (
            ( ( tei_model.divLike | tei_model.divGenLike ), tei_model.global* )+
          | (
               ( tei_model.common, tei_model.global* )+,
               (
                  ( tei_model.divLike | tei_model.divGenLike ),
                  tei_model.global*
               )*
            )
         ),
         ( tei_model.divBottom, tei_model.global* )*
      )?
   )
}

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

<content>
 <empty/>
</content>
    

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

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

element cell
{
   tei_att.global.attributes,
   tei_att.tableDecoration.attributes,
   tei_macro.specialPara
}

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.

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

element change
{
   tei_att.ascribed.attributes,
   tei_att.datable.attributes,
   tei_att.global.attributes,
   tei_att.typed.attributes,
   attribute target { list { + } }?,
   tei_macro.specialPara
}

<content>
 <alternate minOccurs="1"
  maxOccurs="unbounded">
  <elementRef key="quote"/>
  <classRef key="model.biblLike"/>
  <classRef key="model.ptrLike"/>
 </alternate>
</content>
    

element cit
{
   tei_att.global.attributes,
   ( tei_quote | tei_model.biblLike | tei_model.ptrLike )+
}

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

element classCode
{
   tei_att.global.attributes,
   attribute scheme { text },
   tei_macro.phraseSeq.limited
}

<content>
 <textNode/>
</content>
    

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

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <classRef key="model.phrase"/>
  <classRef key="model.global"/>
 </alternate>
</content>
    

element date
{
   tei_att.global.attributes,
   tei_att.datable.attributes,
   tei_att.editLike.attributes,
   tei_att.dimensions.attributes,
   ( text | tei_model.gLike | tei_model.phrase | tei_model.global )*
}

When used in a specification element such as <elementSpec>, TEI convention requires that this be expressed as a finite clause, begining with an active verb.

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

element desc { tei_att.global.attributes, tei_macro.limitedContent }

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

element distributor { tei_att.global.attributes, tei_macro.phraseSeq }

<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.divLike"/>
      <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.divLike"/>
       <classRef key="model.divGenLike"/>
      </alternate>
      <classRef key="model.global"
       minOccurs="0" maxOccurs="unbounded"/>
     </sequence>
    </sequence>
   </alternate>
   <sequence minOccurs="0"
    maxOccurs="unbounded">
    <classRef key="model.divBottom"/>
    <classRef key="model.global"
     minOccurs="0" maxOccurs="unbounded"/>
   </sequence>
  </sequence>
 </sequence>
</content>
    

element div
{
   tei_att.global.attributes,
   tei_att.divLike.attributes,
   tei_att.written.attributes,
   attribute type
   {
      "bibliography"
    | "challenge.question"
    | "challenge.solution"
    | "example"
    | "example.index"
    | "site.index"
   }?,
   (
      ( tei_model.divTop | tei_model.global )*,
      (
         (
            ( ( tei_model.divLike | tei_model.divGenLike ), tei_model.global* )+
          | (
               ( tei_model.common, tei_model.global* )+,
               (
                  ( tei_model.divLike | tei_model.divGenLike ),
                  tei_model.global*
               )*
            )
         ),
         ( tei_model.divBottom, tei_model.global* )*
      )?
   )
}

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

element edition { tei_att.global.attributes, tei_macro.phraseSeq }

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.

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

element editor
{
   tei_att.global.attributes,
   attribute role
   {
      list { ( "translator" | "guest" | "chief" | "managing" | "technical" )+ }
   }?,
   tei_macro.phraseSeq
}

If the example contains material in XML markup, either it must be enclosed within a CDATA marked section, or character entity references must be used to represent the markup delimiters. If the example contains well-formed XML, it should be marked using the more specific <egXML> element.

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

element eg { tei_att.global.attributes, tei_macro.phraseSeq }

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

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

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

The format of a modern Internet email address is defined in RFC 2822

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

element email { tei_att.global.attributes, tei_macro.phraseSeq }

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

element emph { tei_att.global.attributes, tei_macro.paraContent }

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

element encodingDesc
{
   tei_att.global.attributes,
   ( tei_model.encodingDescPart | tei_model.pLike )+
}

This element is intended for use as an alternative to the content of its parent <figure> element ; for example, to display when the image is required but the equipment in use cannot display graphic images. It may also be used for indexing or documentary purposes.

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

element figDesc { tei_att.global.attributes, tei_macro.limitedContent }

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="1" maxOccurs="1">
   <elementRef key="graphic"
    maxOccurs="unbounded"/>
   <elementRef key="egXML"
    maxOccurs="unbounded"/>
   <elementRef key="eg"
    maxOccurs="unbounded"/>
  </alternate>
  <elementRef key="figDesc" minOccurs="0"
   maxOccurs="unbounded"/>
  <elementRef key="head" minOccurs="1"
   maxOccurs="unbounded"/>
 </sequence>
</content>
    

element figure
{
   tei_att.global.attributes,
   tei_att.written.attributes,
   ( ( tei_graphic+ | tei_egXML+ | tei_eg+ ), tei_figDesc*, tei_head+ )
}

The major source of information for those seeking to create a catalogue entry or bibliographic citation for an electronic file. As such, it provides a title and statements of responsibility together with details of the publication or distribution of the file, of any series to which it belongs, and detailed bibliographic notes for matters not addressed elsewhere in the header. It also contains a full bibliographic description for the source or sources from which the electronic text was derived.

<content>
 <sequence>
  <sequence>
   <elementRef key="titleStmt"/>
   <elementRef key="editionStmt"
    minOccurs="0"/>
   <elementRef key="extent" minOccurs="0"/>
   <elementRef key="publicationStmt"/>
   <elementRef key="seriesStmt"
    minOccurs="0" maxOccurs="unbounded"/>
   <elementRef key="notesStmt"
    minOccurs="0"/>
  </sequence>
  <elementRef key="sourceDesc"
   minOccurs="1" maxOccurs="unbounded"/>
 </sequence>
</content>
    

element fileDesc
{
   tei_att.global.attributes,
   (
      (
         tei_titleStmt,
         editionStmt?,
         extent?,
         tei_publicationStmt,
         tei_seriesStmt*,
         notesStmt?
      ),
      tei_sourceDesc+
   )
}

A floating text has the same content as any other <text> and may thus be interrupted by another floating text, or contain a <group> of tesselated texts.

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <classRef key="model.global"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0" maxOccurs="1">
   <elementRef key="front"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
  <alternate minOccurs="1" maxOccurs="1">
   <elementRef key="body"/>
   <elementRef key="group"/>
  </alternate>
  <classRef key="model.global"
   minOccurs="0" maxOccurs="unbounded"/>
  <sequence minOccurs="0" maxOccurs="1">
   <elementRef key="back"/>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
    

element floatingText
{
   tei_att.global.attributes,
   attribute type { "challenge" },
   (
      tei_model.global*,
      ( tei_front, tei_model.global* )?,
      ( tei_body | group ),
      tei_model.global*,
      ( tei_back, tei_model.global* )?
   )
}

The global xml:lang attribute should be supplied for this element to identify the language of the word or phrase marked. As elsewhere, its value should be a language tag as defined in 6.1. Language Identification.

This element is intended for use only where no other element is available to mark the phrase or words concerned. The global xml:lang attribute should be used in preference to this element where it is intended to mark the language of the whole of some text element.

The <distinct> element may be used to identify phrases belonging to sublanguages or registers not generally regarded as true languages.

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

element foreign { tei_att.global.attributes, tei_macro.phraseSeq }

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

element forename { tei_att.global.attributes, tei_macro.phraseSeq }

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.

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.frontPart"/>
   <classRef key="model.pLike"/>
   <classRef key="model.pLike.front"/>
   <classRef key="model.global"/>
  </alternate>
  <sequence minOccurs="0" maxOccurs="1">
   <alternate minOccurs="1" maxOccurs="1">
    <sequence minOccurs="1" maxOccurs="1">
     <classRef key="model.div1Like"/>
     <alternate minOccurs="0"
      maxOccurs="unbounded">
      <classRef key="model.div1Like"/>
      <classRef key="model.frontPart"/>
      <classRef key="model.global"/>
     </alternate>
    </sequence>
    <sequence minOccurs="1" maxOccurs="1">
     <classRef key="model.divLike"/>
     <alternate minOccurs="0"
      maxOccurs="unbounded">
      <classRef key="model.divLike"/>
      <classRef key="model.frontPart"/>
      <classRef key="model.global"/>
     </alternate>
    </sequence>
   </alternate>
   <sequence minOccurs="0" maxOccurs="1">
    <classRef key="model.divBottom"/>
    <alternate minOccurs="0"
     maxOccurs="unbounded">
     <classRef key="model.divBottom"/>
     <classRef key="model.global"/>
    </alternate>
   </sequence>
  </sequence>
 </sequence>
</content>
    

element front
{
   tei_att.global.attributes,
   (
      (
         tei_model.frontPart
       | tei_model.pLike
       | tei_model.pLike.front
       | tei_model.global
      )*,
      (
         (
            (
               tei_model.div1Like,
               ( tei_model.div1Like | tei_model.frontPart | tei_model.global )*
            )
          | (
               tei_model.divLike,
               ( tei_model.divLike | tei_model.frontPart | tei_model.global )*
            )
         ),
         ( tei_model.divBottom, ( tei_model.divBottom | tei_model.global )* )?
      )?
   )
}

Funders provide financial support for a project; they are distinct from sponsors (see element <sponsor>), who provide intellectual support and authority.

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

element funder { tei_att.global.attributes, tei_macro.phraseSeq.limited }

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

The <gap> tag simply signals the editors decision to omit or inability to transcribe a span of text. Other information, such as the interpretation that text was deliberately erased or covered, should be indicated using the relevant tags, such as <del> in the case of deliberate deletion.