element abbr
{
   toctoc_att.global.attributes,
   toctoc_att.responsibility.attributes,
   toctoc_att.typed.attribute.subtype,
   attribute type { data.enumerated }?,
   macro.phraseSeq
}

The abbr tag is not required; if appropriate, the encoder may transcribe abbreviations in the source text silently, without tagging them. If abbreviations are not transcribed directly but expanded silently, then the TEI header should so indicate.

element address
{
   toctoc_att.global.attributes,
   ( model.global*, ( ( model.addrPart ), model.global* )+ )
}

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.

element addrLine { toctoc_att.global.attributes, 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.

element altIdent
{
   toctoc_att.global.attributes,
   toctoc_att.typed.attributes,
   text
}

All documentation elements in ODD have a canonical name, supplied as the value for their ident attribute. The altIdent element is used to supply an alternative name for the corresponding XML object, perhaps in a different language.

element att
{
   toctoc_att.global.attributes,
   attribute scheme { data.enumerated }?,
   data.name
}

A namespace prefix may be used in order to specify the scheme as an alternative to specifying it via the scheme attribute: it takes precedence

element attDef
{
   toctoc_att.global.attributes,
   toctoc_att.identified.attributes,
   attribute usage { "req" | "mwa" | "rec" | "rwa" | "opt" }?,
   attribute ns { data.namespace }?,
   (
      ( model.glossLike | model.descLike )*,
      datatype?,
      constraintSpec*,
      defaultVal?,
      ( valList | valDesc+ )?,
      exemplum*,
      remarks*
   )
}

element attList
{
   toctoc_att.global.attributes,
   attribute org { "group" | "choice" }?,
   ( attRef | attDef | attList )+
}

element attRef
{
   toctoc_att.global.attributes,
   attribute name { data.word },
   empty
}

element author
{
   toctoc_att.global.attributes,
   toctoc_att.naming.attributes,
   macro.phraseSeq
}

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.

element authority { toctoc_att.global.attributes, macro.phraseSeq.limited }

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

A consistent format should be adopted

element back
{
   toctoc_att.global.attributes,
   toctoc_att.declaring.attributes,
   (
      ( model.frontPart | model.pLike.front | model.global )*,
      (
         (
            (
               ( model.div1Like ),
               ( model.frontPart | model.div1Like | model.global )*
            )
          | (
               ( model.divLike ),
               ( model.frontPart | model.divLike | model.global )*
            )
         )?
      ),
      ( ( ( model.divBottomPart ), ( model.divBottomPart | model.global )* )? )
   )
}

The content model of back matter is identical to that of front matter, reflecting the facts of cultural history.

element bibl
{
   toctoc_att.global.attributes,
   toctoc_att.declarable.attributes,
   toctoc_att.typed.attributes,
   toctoc_att.sortable.attributes,
   toctoc_att.docStatus.attributes,
   (
      text
    | model.gLike
    | model.highlighted
    | model.pPart.data
    | model.pPart.edit
    | model.segLike
    | model.ptrLike
    | model.biblPart
    | model.global
   )*
}

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

element biblFull
{
   toctoc_att.global.attributes,
   toctoc_att.declarable.attributes,
   toctoc_att.sortable.attributes,
   toctoc_att.docStatus.attributes,
   (
      (
         titleStmt,
         editionStmt?,
         extent?,
         publicationStmt,
         seriesStmt?,
         notesStmt?
      ),
      sourceDesc*
   )
}

element biblScope
{
   toctoc_att.global.attributes,
   attribute unit
   {
      "vol" | "issue" | "pp" | "ll" | "chap" | "part" | xsd:Name
   }?,
   attribute type
   {
      "vol" | "issue" | "pp" | "ll" | "chap" | "part" | xsd:Name
   }?,
   attribute from { data.word }?,
   attribute to { data.word }?,
   macro.phraseSeq
}

element body
{
   toctoc_att.global.attributes,
   toctoc_att.declaring.attributes,
   (
      model.global*,
      ( ( model.divTop ), ( model.global | model.divTop )* )?,
      ( ( model.divGenLike ), ( model.global | model.divGenLike )* )?,
      (
         ( ( model.divLike ), ( model.global | model.divGenLike )* )+
       | ( ( model.div1Like ), ( model.global | model.divGenLike )* )+
       | (
            ( ( model.common ), model.global* )+,
            (
               ( ( model.divLike ), ( model.global | model.divGenLike )* )+
             | ( ( model.div1Like ), ( model.global | model.divGenLike )* )+
            )?
         )
      ),
      ( ( model.divBottom ), model.global* )*
   )
}

element calendar
{
   toctoc_att.global.attributes,
   toctoc_att.pointing.attributes,
   model.pLike+
}

element calendarDesc { toctoc_att.global.attributes, calendar+ }

In the first example above, calendars and short codes for xml:ids are from W3 guidelines at

element cell
{
   toctoc_att.global.attributes,
   toctoc_att.tableDecoration.attributes,
   macro.paraContent
}

element change
{
   toctoc_att.ascribed.attributes,
   toctoc_att.datable.attributes,
   toctoc_att.docStatus.attributes,
   toctoc_att.global.attributes,
   toctoc_att.typed.attributes,
   attribute target { list { data.pointer+ } }?,
   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.

element choice { toctoc_att.global.attributes, ( model.choicePart | choice )* }

An American encoding of Gulliver's Travels which retains the British spelling but also provides a version regularized to American spelling might be encoded as follows.

Because the children of a choice element all represent alternative ways of encoding the same sequence, it is natural to think of them as mutually exclusive. However, there may be cases where a full representation of a text requires the alternative encodings to be considered as parallel.

Note also that choice elements may self-nest.

Where the purpose of an encoding is to record multiple witnesses of a single work, rather than to identify multiple possible encoding decisions at a given point, the <app> element and associated elements discussed in section 12.1. The Apparatus Entry, Readings, and Witnesses should be preferred.

element cit
{
   toctoc_att.global.attributes,
   toctoc_att.typed.attributes,
   (
      model.qLike
    | model.egLike
    | model.biblLike
    | model.ptrLike
    | model.global
    | model.entryPart
   )+
}

element citedRange
{
   toctoc_att.global.attributes,
   toctoc_att.pointing.attributes,
   attribute unit
   {
      "vol" | "issue" | "pp" | "ll" | "chap" | "part" | xsd:Name
   }?,
   attribute from { data.word }?,
   attribute to { data.word }?,
   macro.phraseSeq
}

element classes
{
   toctoc_att.global.attributes,
   attribute mode { "change" | "replace" },
   ( memberOf* )
}

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

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

element classRef
{
   toctoc_att.global.attributes,
   toctoc_att.readFrom.attributes,
   attribute key { xsd:NCName },
   empty
}

Attribute and model classes are identified by the name supplied as value for the ident attribute on the classSpec element in which they are declared. All TEI names are unique; attribute class names conventionally begin with the latters att..

element classSpec
{
   toctoc_att.global.attributes,
   toctoc_att.identified.attribute.module,
   toctoc_att.identified.attribute.predeclare,
   toctoc_att.identified.attribute.status,
   toctoc_att.combinable.attribute.mode,
   attribute ident
   {
      "att.ascribed"
    | "att.breaking"
    | "att.cReferencing"
    | "att.canonical"
    | "att.combinable"
    | "att.coordinated"
    | "att.damaged"
    | "att.datable"
    | "att.datable.custom"
    | "att.datable.iso"
    | "att.datable.w3c"
    | "att.datcat"
    | "att.declarable"
    | "att.declaring"
    | "att.dimensions"
    | "att.divLike"
    | "att.docStatus"
    | "att.duration"
    | "att.duration.iso"
    | "att.duration.w3c"
    | "att.editLike"
    | "att.edition"
    | "att.enjamb"
    | "att.entryLike"
    | "att.fragmentable"
    | "att.global"
    | "att.global.analytic"
    | "att.global.change"
    | "att.global.facs"
    | "att.global.linking"
    | "att.handFeatures"
    | "att.identified"
    | "att.internetMedia"
    | "att.interpLike"
    | "att.lexicographic"
    | "att.measurement"
    | "att.media"
    | "att.metrical"
    | "att.milestoneUnit"
    | "att.msExcerpt"
    | "att.namespaceable"
    | "att.naming"
    | "att.patternReplacement"
    | "att.personal"
    | "att.placement"
    | "att.pointing"
    | "att.pointing.group"
    | "att.ranging"
    | "att.rdgPart"
    | "att.readFrom"
    | "att.resourced"
    | "att.responsibility"
    | "att.scoping"
    | "att.segLike"
    | "att.sortable"
    | "att.source"
    | "att.spanning"
    | "att.styleDef"
    | "att.tableDecoration"
    | "att.textCritical"
    | "att.timed"
    | "att.transcriptional"
    | "att.translatable"
    | "att.typed"
    | "att.witnessed"
    | "model.addrPart"
    | "model.addressLike"
    | "model.applicationLike"
    | "model.availabilityPart"
    | "model.biblLike"
    | "model.biblPart"
    | "model.castItemPart"
    | "model.catDescPart"
    | "model.certLike"
    | "model.choicePart"
    | "model.common"
    | "model.dateLike"
    | "model.descLike"
    | "model.dimLike"
    | "model.div1Like"
    | "model.div2Like"
    | "model.div3Like"
    | "model.div4Like"
    | "model.div5Like"
    | "model.div6Like"
    | "model.div7Like"
    | "model.divBottom"
    | "model.divBottomPart"
    | "model.divGenLike"
    | "model.divLike"
    | "model.divPart"
    | "model.divPart.spoken"
    | "model.divTop"
    | "model.divTopPart"
    | "model.divWrapper"
    | "model.editorialDeclPart"
    | "model.egLike"
    | "model.emphLike"
    | "model.encodingDescPart"
    | "model.entryLike"
    | "model.entryPart"
    | "model.entryPart.top"
    | "model.featureVal"
    | "model.featureVal.complex"
    | "model.featureVal.single"
    | "model.formPart"
    | "model.frontPart"
    | "model.frontPart.drama"
    | "model.gLike"
    | "model.global"
    | "model.global.edit"
    | "model.global.meta"
    | "model.global.spoken"
    | "model.glossLike"
    | "model.gramPart"
    | "model.graphicLike"
    | "model.headLike"
    | "model.hiLike"
    | "model.highlighted"
    | "model.imprintPart"
    | "model.inter"
    | "model.lLike"
    | "model.lPart"
    | "model.labelLike"
    | "model.limitedPhrase"
    | "model.linePart"
    | "model.listLike"
    | "model.measureLike"
    | "model.milestoneLike"
    | "model.morphLike"
    | "model.msItemPart"
    | "model.msQuoteLike"
    | "model.nameLike"
    | "model.nameLike.agent"
    | "model.noteLike"
    | "model.oddDecl"
    | "model.oddRef"
    | "model.offsetLike"
    | "model.orgPart"
    | "model.orgStateLike"
    | "model.pLike"
    | "model.pLike.front"
    | "model.pPart.data"
    | "model.pPart.edit"
    | "model.pPart.editorial"
    | "model.pPart.msdesc"
    | "model.pPart.transcriptional"
    | "model.persEventLike"
    | "model.persNamePart"
    | "model.persStateLike"
    | "model.personLike"
    | "model.personPart"
    | "model.phrase"
    | "model.phrase.xml"
    | "model.physDescPart"
    | "model.placeEventLike"
    | "model.placeLike"
    | "model.placeNamePart"
    | "model.placeStateLike"
    | "model.profileDescPart"
    | "model.ptrLike"
    | "model.ptrLike.form"
    | "model.publicationStmtPart"
    | "model.qLike"
    | "model.quoteLike"
    | "model.rdgLike"
    | "model.rdgPart"
    | "model.recordingPart"
    | "model.resourceLike"
    | "model.respLike"
    | "model.segLike"
    | "model.settingPart"
    | "model.sourceDescPart"
    | "model.specDescLike"
    | "model.stageLike"
    | "model.teiHeaderPart"
    | "model.textDescPart"
    | "model.titlepagePart"
    | xsd:Name
   },
   attribute type { "model" | "atts" },
   attribute generate
   {
      list
      {
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         ),
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?,
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?,
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?,
         (
            "alternation"
          | "sequence"
          | "sequenceOptional"
          | "sequenceOptionalRepeatable"
          | "sequenceRepeatable"
         )?
      }
   }?,
   (
      model.glossLike_sequenceOptional,
      model.descLike_sequenceOptional,
      classes?,
      constraintSpec*,
      attList?,
      exemplum*,
      remarks*,
      listRef*
   )
}

The content of the TOCTOC classSpec is somewhat more restrictive than TEI. To wit, neither altIdent nor equiv are permitted, there can be at most one gloss and must be one and only one desc.

element code
{
   toctoc_att.global.attributes,
   attribute lang { data.word }?,
   text
}

element constraint
{
   toctoc_att.global.attributes,
   ( sch_assert | sch_ns | sch_report | sch_rule | sch_pattern )+
}

For our purposes, constraints must be expressed in ISO Schematron. (TEI permits others, including non-XML expressions, although there is no processing of anything other than Schematron 1.x or ISO Schematron.)

element constraintSpec
{
   toctoc_att.global.attributes,
   toctoc_att.identified.attributes,
   toctoc_att.typed.attributes,
   attribute scheme { "schematron" | "isoschematron" | "xsl" | "private" },
   model.descLike*,
   model.glossLike*,
   constraint?
}

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

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

element content
{
   toctoc_att.global.attributes,
   attribute autoPrefix { "true" | "false" }?,
   macro.schemaPattern*
}

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

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

The macro macro.schemaPattern defines which elements may be used to define content models. Alternatively, a content model may be expressed using the TEI valList element.

element datatype
{
   toctoc_att.global.attributes,
   attribute minOccurs { data.count }?,
   attribute maxOccurs { data.count | "unbounded" }?,
   macro.schemaPattern*
}

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

In the TEI scheme, most datatypes are expressed using pre-defined TEI macros, which map a name in the form data.xxxx to a RelaxNG or WSD defined datatype.

element date
{
   toctoc_att.global.attributes,
   toctoc_att.datable.attributes,
   toctoc_att.editLike.attributes,
   toctoc_att.typed.attributes,
   ( text | model.gLike | model.phrase | model.global )*
}

element defaultVal { toctoc_att.global.attributes, text }

any legal declared value or TEI-defined keyword

element desc
{
   toctoc_att.global.attributes,
   toctoc_att.translatable.attributes,
   macro.limitedContent
}

TEI convention requires that this be expressed as a finite clause, begining with an active verb.

element distributor { toctoc_att.global.attributes, macro.phraseSeq }

element div
{
   toctoc_att.global.attributes,
   toctoc_att.divLike.attributes,
   toctoc_att.typed.attribute.subtype,
   toctoc_att.declaring.attributes,
   attribute type { "section" | "subsection" | "subsubsection" | xsd:Name }?,
   (
      ( model.divTop | model.global )*,
      (
         (
            ( ( ( model.divLike | model.divGenLike ), model.global* )+ )
          | (
               ( ( model.common ), model.global* )+,
               ( ( model.divLike | model.divGenLike ), model.global* )*
            )
         ),
         ( ( model.divBottom ), model.global* )*
      )?
   )
}

element divGen
{
   toctoc_att.global.attributes,
   attribute type
   {
      "attcat"
    | "attclasscat"
    | "elementcat"
    | "macrocat"
    | "modelclasscat"
    | "toc"
   }?,
   model.headLike*
}

One use for this element is to allow document preparation software to generate an index and insert it in the appropriate place in the output. The example below assumes that the indexName attribute on <index> elements in the text has been used to specify index entries for the two generated indexes, named NAMES and THINGS:

Another use for divGen is to specify the location of an automatically produced table of contents:

This element is intended primarily for use in document production or manipulation, rather than in the transcription of pre-existing materials; it makes it easier to specify the location of indices, tables of contents, etc., to be generated by text preparation or word processing software.

element editor
{
   toctoc_att.global.attributes,
   toctoc_att.naming.attributes,
   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.

element eg { toctoc_att.global.attributes, text }

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.

element egXML
{
   toctoc_att.global.attributes,
   toctoc_att.source.attributes,
   attribute valid { "true" | "feasible" | "false" }?,
   text | egXML | macro.anyXML*
}

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. In a TEI context use of the rend attribute in the TEI namespace, as opposed to the TEI Examples namespace, enables recording of rendition information.