OpenStemmata

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>
 <elementRef key="teiHeader"/>
 <elementRef key="facsimile"/>
 <elementRef key="text"/>
</content>
    ⚓

element TEI
{
   att.global.attributes,
   att.typed.attributes,
   attribute version { text }?,
   teiHeader,
   facsimile,
   text
}⚓

The <arc> element must be used if the arcs are labeled. Otherwise, arcs can be encoded using the adj, adjTo and adjFrom attributes on the <node> tags in the graph. Both <arc> tags and adjacency attributes can be used, but the resulting encoding would be highly redundant.

Zero, one, or two children <label> elements may be present. The first occurence of <label> provides a label for the arc; the second provides a second label for the arc, and should be used if a transducer is being encoded.

<content>
 <elementRef key="label" minOccurs="0"
  maxOccurs="1"/>
</content>
    ⚓

element arc
{
   att.global.attribute.xmlid,
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.responsibility.attribute.resp,
   attribute cert { text },
   attribute [http://openstemmata.github.io/odd.html]type
   {
      "filiation" | "contamination"
   },
   attribute from { text },
   attribute to { text },
   label?
}⚓

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
{
   att.global.attributes,
   att.naming.attributes,
   att.datable.attributes,
   macro.phraseSeq
}⚓

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="orgName" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="ptr" minOccurs="1"
   maxOccurs="1"/>
 </sequence>
</content>
    ⚓

element authority
{
   att.global.attributes,
   att.canonical.attributes,
   ( orgName, ptr )
}⚓

A consistent format should be adopted

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

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

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

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="title" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="date" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="pubPlace" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="series" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="biblScope" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="author" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="biblScope" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="ptr" minOccurs="1"
   maxOccurs="1"/>
 </sequence>
</content>
    ⚓

element bibl
{
   att.global.attributes,
   att.docStatus.attributes,
   attribute type { "book" | "publicationPart" },
   ( title, date, pubPlace, series, biblScope, author, biblScope, ptr )
}⚓

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
{
   att.global.attributes,
   att.citing.attributes,
   macro.phraseSeq
}⚓

<content>
 <elementRef key="graph"/>
</content>
    ⚓

element body { att.global.attributes, graph }⚓

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
{
   att.ascribed.attributes,
   att.datable.attributes,
   att.docStatus.attributes,
   att.global.attributes,
   att.typed.attributes,
   attribute target { list { + } }?,
   macro.specialPara
}⚓

The <creation> element may be used to record details of a text's creation, e.g. the date and place it was composed, if these are of interest.

It may also contain a more structured account of the various stages or revisions associated with the evolution of a text; this should be encoded using the <listChange> element. It should not be confused with the <publicationStmt> element, which records date and place of publication.

<content>
 <elementRef key="title" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="persName" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="origDate" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="origPlace" minOccurs="1"
  maxOccurs="1"/>
</content>
    ⚓

element creation
{
   att.global.attributes,
   att.datable.attributes,
   title,
   persName,
   origDate,
   origPlace
}⚓

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

element date
{
   att.global.attributes,
   att.canonical.attributes,
   att.datable.attributes,
   att.typed.attributes,
   ( text | model.gLike | model.phrase | model.global )*
}⚓

<content>
 <sequence>
  <elementRef key="front" minOccurs="0"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.graphicLike"/>
   <elementRef key="surface"/>
   <elementRef key="surfaceGrp"/>
  </alternate>
  <elementRef key="back" minOccurs="0"/>
 </sequence>
</content>
    ⚓

element facsimile
{
   att.global.attributes,
   ( front?, ( model.graphicLike | surface | surfaceGrp )+, back? )
}⚓

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>
 <elementRef key="titleStmt"/>
 <elementRef key="publicationStmt"/>
 <elementRef key="notesStmt"/>
 <elementRef key="sourceDesc"/>
</content>
    ⚓

element fileDesc
{
   att.global.attributes,
   titleStmt,
   publicationStmt,
   notesStmt,
   sourceDesc
}⚓

One or more nodes and zero or more arcs in any order.

<content>
 <elementRef key="label"/>
 <elementRef key="node" minOccurs="1"
  maxOccurs="unbounded"/>
 <elementRef key="arc" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓

element graph
{
   att.global.attributes,
   attribute type
   {
      "undirected" | "directed" | "transitionNetwork" | "transducer"
   },
   attribute order { text },
   attribute size { text },
   label,
   node+,
   arc+
}⚓

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

Within the body of a text, a <graphic> element indicates the presence of a graphic component in the source itself. Within the context of a <facsimile> or <sourceDoc> element, however, a <graphic> element provides an additional digital representation of some part of the source being encoded.

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

element graphic
{
   att.global.attributes,
   att.resourced.attributes,
   model.descLike*
}⚓

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

<content>
 <textNode/>
</content>
    ⚓

element idno
{
   att.global.attributes,
   att.datable.attributes,
   attribute type
   {
      "ISBN" | "ISSN" | "DOI" | "URI" | "VIAF" | "ESTC" | "OCLC"
   }?,
   text
}⚓

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

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

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

element keywords { att.global.attributes, attribute scheme { text }?, term+ }⚓

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

element label
{
   att.global.attributes,
   att.placement.attributes,
   attribute type { "siglum" }?,
   macro.phraseSeq
}⚓

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

element langUsage { att.global.attributes, language+ }⚓

Particularly for sublanguages, an informal prose characterization should be supplied as content for the element.

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

element language
{
   att.global.attributes,
   attribute ident
   {
      "fro"
    | "frm"
    | "gmh"
    | "lat"
    | "dum"
    | "enm"
    | "wlm"
    | "osp"
    | "pro"
    | "cat"
    | "ita"
    | "grc"
    | "other"
   },
   attribute usage { text }?,
   macro.phraseSeq.limited
}⚓

A <licence> element should be supplied for each licence agreement applicable to the text in question. The target attribute may be used to reference a full version of the licence. The when, notBefore, notAfter, from or to attributes may be used in combination to indicate the date or dates of applicability of the licence.

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

element licence
{
   att.global.attributes,
   att.pointing.attributes,
   att.datable.attributes,
   macro.specialPara
}⚓

May contain a series of <witness> or <listWit> elements.

The provision of a <listWit> element simplifies the automatic processing of the apparatus, e.g. the reconstruction of the readings for all witnesses from an exhaustive apparatus.

Situations commonly arise where there are many more or less fragmentary witnesses, such that there may be quite distinct groups of witnesses for different parts of a text or collection of texts. Such groups may be given separately, or nested within a single <listWit> element at the beginning of the file listing all the witnesses, partial and complete, for the text, with the attestation of fragmentary witnesses indicated within the apparatus by use of the <witStart> and <witEnd> elements described in section 12.1.5. Fragmentary Witnesses.

Note however that a given witness can only be defined once, and can therefore only appear within a single <listWit> element.

<content>
 <sequence>
  <classRef key="model.headLike"
   minOccurs="0"/>
  <elementRef key="desc" minOccurs="0"
   maxOccurs="unbounded"/>
  <alternate minOccurs="1"
   maxOccurs="unbounded">
   <elementRef key="witness"/>
   <elementRef key="listWit"/>
  </alternate>
 </sequence>
</content>
    ⚓

element listWit
{
   att.global.attributes,
   ( model.headLike?, desc*, ( witness | listWit )+ )
}⚓

Zero, one, or two children <label> elements may be present. The first occurence of <label> provides a label for the arc; the second provides a second label for the arc, and should be used if a transducer is being encoded whose actions are associated with nodes rather than with arcs.

<content>
 <elementRef key="label"/>
</content>
    ⚓

element node
{
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute xml:id { text },
   attribute type { "hypothetical" | "witness" },
   attribute inDegree { text },
   attribute outDegree { text },
   label
}⚓

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

element note
{
   att.global.attributes,
   att.placement.attributes,
   att.pointing.attributes,
   att.typed.attributes,
   att.anchoring.attributes,
   macro.specialPara
}⚓

Information of different kinds should not be grouped together into the same note.

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

element notesStmt { att.global.attributes, ( model.noteLike | relatedItem )+ }⚓

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

element orgName
{
   att.global.attributes,
   att.datable.attributes,
   att.personal.attributes,
   att.typed.attributes,
   macro.phraseSeq
}⚓

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

element origDate
{
   att.global.attributes,
   att.datable.attributes,
   att.typed.attributes,
   ( text | model.gLike | model.phrase | model.global )*
}⚓

The type attribute may be used to distinguish different kinds of ‘origin’, for example original place of publication, as opposed to original place of printing.

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

element origPlace
{
   att.global.attributes,
   att.naming.attributes,
   att.datable.attributes,
   att.typed.attributes,
   macro.phraseSeq
}⚓

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

element persName
{
   att.global.attributes,
   att.datable.attributes,
   att.personal.attributes,
   att.typed.attributes,
   macro.phraseSeq
}⚓

Although the content model permits it, it is rarely meaningful to supply multiple occurrences for any of the child elements of <profileDesc> unless these are documenting multiple texts.

<content>
 <elementRef key="creation" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="textClass" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="langUsage" minOccurs="1"
  maxOccurs="1"/>
</content>
    ⚓

element profileDesc { att.global.attributes, creation, textClass, langUsage }⚓

<content>
 <empty/>
</content>
    ⚓

element ptr
{
   att.global.attributes,
   attribute target { text }?,
   attribute type { "digitised" | "description" }?,
   empty
}⚓

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

element pubPlace
{
   att.global.attributes,
   att.naming.attributes,
   macro.phraseSeq
}⚓

Where a publication statement contains several members of the model.publicationStmtPart.agency or model.publicationStmtPart.detail classes rather than one or more paragraphs or anonymous blocks, care should be taken to ensure that the repeated elements are presented in a meaningful order. It is a conformance requirement that elements supplying information about publication place, address, identifier, availability, and date be given following the name of the publisher, distributor, or authority concerned, and preferably in that order.

<content>
 <alternate>
  <sequence minOccurs="1"
   maxOccurs="unbounded">
   <classRef key="model.publicationStmtPart.agency"/>
   <classRef key="model.publicationStmtPart.detail"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
  <classRef key="model.pLike" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>
    ⚓

element publicationStmt
{
   att.global.attributes,
   (
      ( model.publicationStmtPart.agency, model.publicationStmtPart.detail* )+
    | model.pLike+
   )
}⚓

The attribute ref, inherited from the class att.canonical may be used to indicate the kind of responsibility in a normalized form by referring directly to a standardized list of responsibility types, such as that maintained by a naming authority, for example the list maintained at http://www.loc.gov/marc/relators/relacode.html for bibliographic usage.

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

element resp
{
   att.global.attributes,
   att.canonical.attributes,
   att.datable.attributes,
   macro.phraseSeq.limited
}⚓

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="resp" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="persName" minOccurs="1"
   maxOccurs="1"/>
 </sequence>
</content>
    ⚓

element respStmt
{
   att.global.attributes,
   att.canonical.attributes,
   ( resp, persName )
}⚓

If present on this element, the status attribute should indicate the current status of the document. The same attribute may appear on any <change> to record the status at the time of that change. Conventionally <change> elements should be given in reverse date order, with the most recent change at the start of the list.

<content>
 <alternate>
  <elementRef key="list"/>
  <elementRef key="listChange"/>
  <elementRef key="change" minOccurs="1"
   maxOccurs="unbounded"/>
 </alternate>
</content>
    ⚓

element revisionDesc
{
   att.global.attributes,
   att.docStatus.attributes,
   ( list | listChange | change+ )
}⚓

<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <textNode/>
  <classRef key="model.gLike"/>
  <elementRef key="title"/>
  <classRef key="model.ptrLike"/>
  <elementRef key="editor"/>
  <elementRef key="respStmt"/>
  <elementRef key="biblScope"/>
  <elementRef key="idno"/>
  <elementRef key="textLang"/>
  <classRef key="model.global"/>
  <elementRef key="availability"/>
 </alternate>
</content>
    ⚓

element series
{
   att.global.attributes,
   (
      text
    | model.gLike
    | title
    | model.ptrLike
    | editor
    | respStmt
    | biblScope
    | idno
    | textLang
    | model.global
    | availability
   )*
}⚓

<content>
 <elementRef key="bibl" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="listWit" minOccurs="0"
  maxOccurs="1"/>
</content>
    ⚓

element sourceDesc { att.global.attributes, bibl, listWit? }⚓

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

<content>
 <elementRef key="fileDesc"/>
 <elementRef key="profileDesc"/>
 <elementRef key="revisionDesc"
  minOccurs="0" maxOccurs="1"/>
</content>
    ⚓

element teiHeader
{
   att.global.attributes,
   fileDesc,
   profileDesc,
   revisionDesc?
}⚓

When this element appears within an <index> element, it is understood to supply the form under which an index entry is to be made for that location. Elsewhere, it is understood simply to indicate that its content is to be regarded as a technical or specialised term. It may be associated with a <gloss> element by means of its ref attribute; alternatively a <gloss> element may point to a <term> element by means of its target attribute.

In formal terminological work, there is frequently discussion over whether terms must be atomic or may include multi-word lexical items, symbolic designations, or phraseological units. The <term> element may be used to mark any of these. No position is taken on the philosophical issue of what a term can be; the looser definition simply allows the <term> element to be used by practitioners of any persuasion.

As with other members of the att.canonical class, instances of this element occuring in a text may be associated with a canonical definition, either by means of a URI (using the ref attribute), or by means of some system-specific code value (using the key attribute). Because the mutually exclusive target and cRef attributes overlap with the function of the ref attribute, they are deprecated and may be removed at a subsequent release.

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

element term
{
   att.global.attributes,
   att.pointing.attributes,
   att.canonical.attributes,
   attribute type
   {
      "workGenre" | "stemmaType" | "contam" | "extraStemmContam" | "rootType"
   },
   macro.phraseSeq
}⚓

This element should not be used to represent a text which is inserted at an arbitrary point within the structure of another, for example as in an embedded or quoted narrative; the <floatingText> is provided for this purpose.

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

element text
{
   att.global.attributes,
   att.typed.attributes,
   (
      model.global*,
      ( front, model.global* )?,
      ( body | group ),
      model.global*,
      ( back, model.global* )?
   )
}⚓

<content>
 <elementRef key="keywords" minOccurs="1"
  maxOccurs="1"/>
</content>
    ⚓

element textClass { att.global.attributes, keywords }⚓

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.

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

element title
{
   att.global.attributes,
   att.canonical.attributes,
   att.datable.attributes,
   attribute type { text }?,
   attribute level { "a" | "m" | "j" | "s" | "u" }?,
   macro.paraContent
}⚓

<content>
 <elementRef key="title" minOccurs="2"
  maxOccurs="2"/>
 <elementRef key="author" minOccurs="1"
  maxOccurs="1"/>
 <elementRef key="respStmt" minOccurs="1"
  maxOccurs="unbounded"/>
</content>
    ⚓

element titleStmt
{
   att.global.attributes,
   ( title, title ),
   author,
   respStmt+
}⚓

The content of the <witness> element may give bibliographic information about the witness or witness group, or it may be empty.

<content>
 <sequence minOccurs="1" maxOccurs="1">
  <elementRef key="label" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="idno" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="origDate" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="origPlace" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="note" minOccurs="1"
   maxOccurs="1"/>
  <elementRef key="ptr" minOccurs="2"
   maxOccurs="2"/>
 </sequence>
</content>
    ⚓

element witness
{
   att.global.attribute.n,
   att.global.attribute.xmllang,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute xml:id { text },
   ( label, idno, origDate, origPlace, note, ( ptr, ptr ) )
}⚓

Note that this element class does not include members of the model.inter class, which can appear either within or between paragraph-level items.

A superset of the naming elements that may appear in datelines, addresses, statements of responsibility, etc.

This class is used in the content model of elements which reference names of people or organizations.

This class of elements can occur within paragraphs, list items, lines of verse, etc.