The Basic TEI Document

  1. Introductory Note
  2. The XML Declaration and TEI Container
  3. Comments
  4. The <teiHeader>
  5. The <text> Element
  6. Basic Division Elements
  7. Global Attributes
  8. Elements Used for Poetry
  9. Typographic Divisions
  10. Changes in Textual Appearance
  11. Manuscript and Scribal Features
  12. Abbreviations
  13. Editorial Interventions
  14. Names, Dates, Numbers
  15. Bibliographic Citations
  16. References and Links

Introductory Note

This document is meant to be a quick and usable mnemonic for the Chronicle Schema. It does not follow precisely the conventions of the TEI in its presentation. For further information about the elements described here, see the full TEI documentation.

Last Revised: 19 April, 2009.

The XML Declaration and TEI Container

The document should begin with

<?xml version="1.0" encoding="UTF-8"?>

<TEI>

The document should end with </TEI>. The xml declaration does not need a closing tag at the end of the document.

Comments

<!-- Insert Comment Text Here -->

The <teiHeader>

Descriptive information about the document should be placed inside the <teiHeader> element at the beginning of the document.

The <text> Element

The <text> element contains the literary text. It can occur inside the <group> element, and it can contain <front> and <back> elements. It is not expected that these elements will be needed in the Chronicle Schema, but an explanation of their use can be found here.

Return to Top

Basic Division Elements

<div> Marks divisions in texts without specifying the semantic nature of the division.
<seg> Indicates a larger structure containing sentences.
<p> Marks paragraphs in prose texts.
<s> Indicates an orthographic sentence.

Return to Top

Global Attributes

type This attribute can have values like “chapter”, “story”, “poem”, “song”, etc.
xml:id The value is a unique identifier for the element. Useful for links and cross references.
n The value is a unique name for the element. It can be more descriptive than an ID number.
xml:lang The value indicates the language of the element. Conventional language codes are:

en: English, enm: Middle English, fr or fra: French, la or lat: Latin

Usage: <text type=”poem”>.

Return to Top

Elements Used for Poetry

<l> Indicates a verse line (identified metrically, not typographically).
<lg> Indicates a group of lines functioning as a formal unit (e.g. a stanza).

Return to Top

Typographic Divisions

<pb/> Indicates a typographic page break.
<lb/> Indicates a typographic line break.

Return to Top

Changes in Textual Appearance

<hi> Indicates that the text is graphically distinct from surrounding text (but does not specify a reason).
<emph> Indicates that the text is more linguistically or rhetorically emphatic.

<foreign> Indicates that the language of the text is different from the surrounding text.
<gloss> Indicates that the text is a gloss.
<title> Indicates that the text is a title.
<note> Indicates that the text is a note, footnote, or endnote.
<label> Indicates that the text is a label
<g> Indicates that the text is distinct from the surrounding text (but does not specify how).

@hand Indicates which editor is responsible for the text.

If it becomes necessary to specify how the text should appear (e.g. when reproducing meaningful formatting from a printed edition), it is possible to use the @rend attribute. For instance, <hi rend="italic">The Anglo-Saxon Chronicle</hi>. Note that in most cases it would be better to use the <title> element, e.g. <title>The Anglo-Saxon Chronicle</title>.

Return to Top

Manuscript and Scribal Features

<add> Indicates that the text is a scribal addition.
<del> Indicates that the text is a scribal deletion.
@hand Indicates which scribe is responsible for the text. May be applied to any division element (e.g .<del>).

@scribe Indicates the scribe of the text.
@script Indicates the script of the text.
@medium Indicates the tint or type of ink.
@scope Indicates whether the hand is the sole, major, or minor hand in the manuscript.

Return to Top

Abbreviations

<abbr> Indicates that the text is an abbreviation.

<expan> Indicates that the text is an expansion of an abbreviation.

Return to Top

Editorial Interventions

<corr> Indicates that the text is a correction.
<sic> Indicates that the text is reproduced from the original, even though it is apparently incorrect or inaccurate.

<gap> Indicates that the text has been left out because of illegibility or editorial decision.

<unclear> Indicates that the text is illegible.
<reg> Indicates that the text has been regularised.
<orig> Indicates that the text is an original reading has been kept.
@resp Indicates which editor is responsible for the text.

The elements <reg> and <orig> can be combined with <choice>:

<choice>
<orig>Reading A</orig>
<reg>Reading B</reg>
</choice>

Return to Top

Names, Dates, Numbers

<name> Indicates that the text is a name or proper noun.
<date> Indicates that the text is a date.

<num> Indicates that the text is a number.

Return to Top

Bibliographic Citations

<bibl> Indicates that the text a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged.
<author> In a bibliographic reference, contains the name of the author(s), personal or corporate, of a work.
<biblScope> Defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work.
<date> Contains a date in any format.
<editor> Indicates an editor.
<publisher> Indicates a publisher.
<pubPlace> Indicates a place of publication.
<title> Indicates a title.

Return to Top

References and Links

Cross references and links to other documents can be created with reference, pointer, or anchor elements.

<ref> Indicates that the text is a reference to an id or URL.
<ptr/> Indicates a pointer to an id or URL before or after an element.

<anchor/> Indicates a link to an id or URL not attached to a specific element.
<seg> Indicates a segment or sequence of words not otherwise tagged to which a link can be attached.
@target Location of the link target. May refer to an xmll:id (e.g. #SEC12) or a URL (e.g. http://www.csun.edu/filename.html).

Return to Top