element altIdentifier
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   (
      model.placeNamePart_sequenceOptional,
      institution?,
      repository?,
      collection?,
      idno,
      note?
   )
}

An identifying number of some kind must be supplied if known; if it is not known, this should be stated.

element author
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute n { data.text }?,
   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 biblScope { att.global.attributes, macro.phraseSeq }

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 should be used without to. For example, if the citation has ‘p. 3ff’ as a page reference.

element change
{
   att.ascribed.attributes,
   att.datable.attributes,
   att.docStatus.attributes,
   att.global.attributes,
   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 collection
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.xtext
}

element date
{
   att.typed.attribute.type,
   attribute when { data.temporal.iso },
   ( text | model.gLike | model.phrase | model.global )*
}

element editor
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute n { data.text }?,
   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 elementSpec
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.deprecated.attribute.validUntil,
   attribute ident
   {
      "Lexical"
    | "Syntactical"
    | "Morphological"
    | "MarkUp"
    | "Graphical"
    | "Transcription"
    | "Other"
    | "Meta"
   },
   (
      ( model.glossLike | model.descLike )*,
      classes?,
      content?,
      valList?,
      constraintSpec*,
      attList?,
      exemplum*,
      remarks*,
      listRef*
   )
}

element encodingDesc
{
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   ( ( model.encodingDescPart | model.pLike )+ )
}

element extent
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.typed.attribute.subtype,
   attribute type { "Tokens" | "Words" },
   macro.phraseSeq
}

The <measure> element may be used to supplied normalised or machine tractable versions of the size or sizes concerned.

element fileDesc
{
   att.global.attribute.xmlid,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   (
      (
         titleStmt,
         editionStmt?,
         extent?,
         publicationStmt,
         seriesStmt?,
         notesStmt?
      ),
      sourceDesc+
   )
}

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.

element forename
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.phraseSeq
}

element history
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   ( model.pLike+ | ( summary?, origin?, provenance*, acquisition? ) )
}

element idno
{
   att.global.attributes,
   att.sortable.attributes,
   attribute type { data.enumerated }?,
   ( text | model.gLike | 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.

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.

element language
{
   att.global.attribute.n,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute style { "Language" | "LanguageType" | "LanguageArea" },
   attribute ident { data.language },
   macro.phraseSeq.limited
}

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

element langUsage
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   language+
}

element locus
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.xtext
}

The facs attribute is available globally when the transcr module is included in a schema. It may be used to point directly to an image file, as in the following example:

The target attribute should only be used to point to elements that contain or indicate a transcription of the locus being described, as in the first example above. To associate a locus element with a page image or other comparable representation, the global facs attribute should be used instead, as shown in the second example. Use of the target attribute to indicate an image is strongly deprecated. The facs attribute may be used to indicate one or more image files, as above, or alternatively it may point to one or more appropriate XML elements, such as the <surface>, <zone> element, <graphic>, or <binaryObject> elements.

When the location being defined consists of a single page, use the from and to attributes with an identical value. When no clear endpoint is given the from attribute should be used without to. For example, if the manuscript description being transcribed has ‘p. 3ff’ as the locus.

element locusGrp
{
   att.global.attributes,
   attribute scheme { data.pointer }?,
   locus+
}

element msDesc
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.declaring.attributes,
   (
      msIdentifier,
      model.headLike*,
      (
         model.pLike+
       | ( msContents?, physDesc?, history?, additional?, msPart* )
      )
   )
}

element msIdentifier
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   (
      (
         model.placeNamePart_sequenceOptional,
         institution?,
         repository?,
         collection*,
         idno?
      ),
      ( msName | altIdentifier )*
   )
}

element msName
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.xtext
}

element objectType
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.phraseSeq
}

The ref attribute may be used to point to one or more items within a taxonomy of types of object, defined either internally or externally.

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

element origDate
{
   att.datable.custom.attribute.notBefore-custom,
   att.datable.custom.attribute.notAfter-custom,
   att.dimensions.attribute.precision,
   ( text | model.gLike | model.phrase | model.global )*
}

element origin { macro.specialPara }

element origPlace { macro.phraseSeq }

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.

element p
{
   att.global.attributes,
   att.declaring.attributes,
   att.fragmentable.attributes,
   macro.paraContent
}

element persName { macro.phraseSeq }

element profileDesc
{
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   ( model.profileDescPart* )
}

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.

In earlier versions of these Guidelines, it was required that the <creation> element appear first.

element publicationStmt
{
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   (
      (
         ( model.publicationStmtPart.agency ),
         model.publicationStmtPart.detail*
      )+
    | model.pLike+
   )
}

Where a publication statement contains several members of the model.publicationStmtPart 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.

element publisher { att.global.attributes, macro.phraseSeq }

Use the full form of the name by which a company is usually referred to, rather than any abbreviation of it which may appear on a title page

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

element recordHist
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   ( model.pLike+ | ( source, change* ) )
}

element ref
{
   att.global.attributes,
   att.pointing.attributes,
   att.internetMedia.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   att.cReferencing.attributes,
   macro.paraContent
}

The target and cRef attributes are mutually exclusive.

element repository
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.xtext
}

element revisionDesc
{
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.docStatus.attributes,
   ( list | listChange | change+ )
}

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.

element schemaSpec
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.identified.attribute.ident,
   att.deprecated.attribute.validUntil,
   ( ( model.glossLike | model.descLike )*, ( model.oddRef | model.oddDecl )* )
}

This schema combines elements from the current versions of the drama and core modules, the current release version of the header module, and elements from an existing RELAXNG schema available from the URL indicated.

A schemaSpec combines references to modules, individual element or macro declarations, and specification groups together to form a unified schema. The processing of the schemaSpec element must resolve any conflicts amongst the declarations it contains or references. Different ODD processors may generate schemas and documentation using different concrete syntaxes.

element seriesStmt
{
   att.global.attributes,
   ( model.pLike+ | ( title+, ( editor | respStmt )*, ( idno | biblScope )* ) )
}

element source
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute facs { text },
   macro.specialPara
}

element sourceDesc
{
   att.global.attributes,
   att.declarable.attributes,
   (
      model.pLike+
    | ( model.biblLike | model.sourceDescPart | model.listLike )+
   )
}

element surname
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   macro.phraseSeq
}

element TEI
{
   att.global.attributes,
   attribute version { data.version }?,
   ( teiHeader, ( ( model.resourceLike+, text? ) | text ) )
}

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.

element teiHeader
{
   att.global.attribute.n,
   att.global.rendition.attribute.style,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute type { "CorpusHeader" | "DocumentHeader" | "PreparationHeader" },
   ( fileDesc, model.teiHeaderPart*, revisionDesc? )
}

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

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

The body of a text may be replaced by a group of nested texts, as in the following schematic:

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.

element title
{
   att.global.attribute.xmlbase,
   att.global.attribute.xmlspace,
   att.global.rendition.attribute.rend,
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   attribute type { "Document" }?,
   macro.paraContent
}

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.

element titleStmt
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   ( title+, model.respLike* )
}

element valItem
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.deprecated.attribute.validUntil,
   attribute corresp { text },
   attribute ident { data.text },
   ( model.descLike | model.glossLike )*
}

element valList
{
   att.global.responsibility.attribute.cert,
   att.global.responsibility.attribute.resp,
   att.deprecated.attribute.validUntil,
   valItem*
}

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.

The ‘agency’ child elements, while not required, are required if one of the ‘detail’ child elements is to be used. It is not valid to have a ‘detail’ child element without a preceding ‘agency’ child element.

See also model.publicationStmtPart.detail.