Text only | Skip links
Skip links||IT Services, University of Oxford

1. The TEI Guidelines

This talk gives a whirlwind survey of some of the other thing that the TEI provides for its community, starting with the TEI Guidelines.

1.1. TEI Chapters (1)

In addition to Front Matter and Back Matter, the TEI Guidelines contain chapters on:
  • 1. The TEI Infrastructure
  • 2. The TEI Header
  • 3. Elements Available in All TEI Documents
  • 4. Default Text Structure
  • 5. Representation of Non-standard Characters and Glyphs
  • 6. Verse
  • 7. Performance Texts
  • 8. Transcriptions of Speech
  • 9. Dictionaries
  • 10. Manuscript Description
  • 11. Representation of Primary Sources
  • 12. Critical Apparatus

1.2. TEI Chapters (2)

  • 13. Names, Dates, People, and Places
  • 14. Tables, Formulæ, and Graphics
  • 15. Language Corpora
  • 16. Linking, Segmentation, and Alignment
  • 17. Simple Analytic Mechanisms
  • 18. Feature Structures
  • 19. Graphs, Networks, and Trees
  • 20. Non-hierarchical Structures
  • 21. Certainty and Responsibility
  • 22. Documentation Elements
  • 23. Using the TEI

1.3. v. A Gentle Introduction to XML

  • Explains up-to-date use of XML, namespaces, schemas, etc.
  • A must-read for those new to XML
  • Considers the nature of markup, why XML is so special, and the structures we create with them

1.4. 6. Verse

  • <rhyme> element added to make rhyming part of metrical line
  • Core: <lg> (line-groups) enclose <l> (line) elements
  • Module Elements: <caesura>, <metDecl>, <metSym>, <rhyme>
<lg rhyme="abab">
 <l>A pleasing land of drowsy head it <rhyme label="a">was</rhyme>,</l>
 <l> Of dreams that wave before the half-shut <rhyme label="b">eye</rhyme>;</l>
 <l>And of gay castles in the clouds that <rhyme label="a">pass</rhyme>,</l>
 <l> For ever flushing round a summer <rhyme label="b">sky</rhyme>.</l>
 <trailer>CASTLE OF INDOLENCE.</trailer>

1.5. 7. Performance Texts

  • Core: <sp>, <speech>, <speaker>
  • Module Elements: <actor>, <camera>, <caption>, <castGroup>, <castItem>, <castList>, <epilogue>, <move>, <performance>, <prologue>, <role>, <roleDesc>, <set>, <sound>, <tech>, <view>
  <role>Ichabod Crane</role>
  <actor>James Cummings</actor>
  <role>Katrina Van Tassel</role>
  <actor>Dot Porter</actor>

1.6. 8. Transcriptions of Speech

  • Module Elements: <broadcast>, <equipment>, <incident>, <kinesic>, <pause>, <recording>, <recordingStmt>, <scriptStmt>, <shift>, <u>, <vocal>, <writing>
  • <incident> replaces <event> which has been re-purposed
<u>What passed at this interview I will not pretend to say, for in fact I do not
know.<pause dur="PT5S"/> Something, however, I fear me, must have gone wrong.<gap/>
 <vocal dur="PT2S">
  <desc>cries in anguish</desc>
 </vocal>Oh these women! these women! <kinesic dur="PT1.5S">
  <desc>shakes head sadly</desc>
 </kinesic> Could that girl have been playing off any of her coquettish tricks?</u>

1.7. 9. Dictionaries

  • Module Elements: <case>, <colloc>, <def>, <dictScrap>, <entry>, <entryFree>, <etym>, <form>, <gen>, <gram>, <gramGrp>, <hom>, <hyph>, <iType>, <lang>, <lbl>, <mood>, <number>, <oRef>, <oVar>, <orth>, <pRef>, <pVar>, <per>, <pos>, <pron>, <re>, <sense>, <stress>, <subc>, <superEntry>, <syll>, <tns>, <usg>, <xr>
 <sense n="1">
  <def>a rider or driver of horses; especially: one whose skill is exceptional</def>

1.8. 10. Manuscript Description

Module Elements: <accMat>, <acquisition>, <additional>, <additions>, <adminInfo>, <altIdentifier>, <binding>, <bindingDesc>, <catchwords>, <collation>, <collection>, <colophon>, <condition>, <custEvent>, <custodialHist>, <decoDesc>, <decoNote>, <depth>, <dimensions>, <explicit>, <filiation>, <finalRubric>, <foliation>, <handDesc>, <height>, <heraldry>, <history>, <incipit>, <institution>, <layout>, <layoutDesc>, <locus>, <locusGrp>, <material>, <msContents>, <msDesc>, <msIdentifier>, <msItem>, <msItemStruct>, <msName>, <msPart>, <musicNotation>, <objectDesc>, <origDate>, <origPlace>, <origin>, <physDesc>, <provenance>, <recordHist>, <repository>, <rubric>, <seal>, <sealDesc>, <secFol>, <signatures>, <source>, <stamp>, <summary>, <support>, <supportDesc>, <surrogates>, <textLang>, <typeDesc>, <watermark>, <width>

1.9. 10. Manuscript Description

  <repository>Bodleian Library</repository>
  <idno>MS. Add. A. 61</idno>
  <altIdentifier type="SC">
 <p>In Latin, on parchment: written in more than one hand of the 13th cent. in England:
   7¼ x 5⅜ in., i + 55 leaves, in double columns: with a few coloured capitals.</p>
 <p>'Hic incipit Bruitus Anglie,' the De origine et gestis Regum Angliae of Geoffrey of
   Monmouth (Galfridus Monumetensis: beg. 'Cum mecum multa &amp; de multis.'</p>
 <p>On fol. 54v very faint is 'Iste liber est fratris guillelmi de buria de ... Roberti
   ordinis fratrum Pred[icatorum],' 14th cent. (?): 'hanauilla' is written at the foot
   of the page (15th cent.). Bought from the rev. W. D. Macray on March 17, 1863, for
   £1 10s.</p>

1.10. 11. Representation of Primary Sources

  • Elements defined: <addSpan>, <am>, <damage>, <damageSpan>, <delSpan>, <ex>, <facsimile>, <fw>, <handNotes>, <handShift>, <restore>, <space>, <subst>, <supplied>, <surface>, <zone>

1.11. 12. Critical Apparatus

  • Module Elements: <app>, <lacunaEnd>, <lacunaStart>, <lem>, <listWit>, <rdg>, <rdgGrp>, <variantEncoding>, <wit>, <witDetail>, <witEnd>, <witStart>, <witness>
<p>Certain it is, this was not the case with the redoubtable Brom Bones; and <app>
  <rdg wit="#msA">from the moment Ichabod Crane made his advances,</rdg>
  <rdg wit="#msB">coincidentally when Ichabod Crane made his advances,</rdg>
  <rdg wit="#msC">from the moment Ichabod Crane started to sing,</rdg>
 </app> the interests of the former evidently declined;</p>

1.12. 13. Names, Dates, People, Places

  • Elements defined: <addName>, <affiliation>, <age>, <birth>, <bloc>, <climate>, <country>, <death>, <district>, <education>, <event>, <faith>, <floruit>, <forename>, <genName>, <geo>, <geogFeat>, <geogName>, <langKnowledge>, <langKnown>, <listEvent>, <listNym>, <listOrg>, <listPerson>, <listPlace>, <location>, <nameLink>, <nationality>, <nym>, <occupation>, <offset>, <org>, <orgName>, <persName>, <person>, <personGrp>, <place>, <placeName>, <population>, <region>, <relation>, <relationGrp>, <residence>, <roleName>, <settlement>, <sex>, <socecStatus>, <state>, <surname>, <terrain>, <trait>

1.13. 13. Names, Dates, People, Places

<p>... <name ref="#jsbachtype="person"> Johann Sebastian Bach </name> was a prolific
German composer ... </p>
<listPerson type="composers">
 <person xml:id="kfabel">
  <persName>Karl Friedrich Abel</persName>
 <person xml:id="jsbach">
  <persName>Johann Sebastian Bach</persName>
 <person xml:id="cpebach">
  <persName>Carl Philipp Emanuel Bach</persName>

1.14. 14. Tables, Formulae, and Graphics

  • Module Elements: <cell>, <figDesc>, <figure>, <formula>, <row>, <table>
  <cell>Van Tassel, Katrina</cell>
  <cell>As beautiful as she is talented</cell>
<!-- more table rows of Ichabod's grading book-->

1.15. 15. Language Corpora

  • Module Elements: <activity>, <channel>, <constitution>, <derivation>, <domain>, <factuality>, <interaction>, <locale>, <particDesc>, <preparedness>, <purpose>, <setting>, <settingDesc>, <textDesc>
 <setting who="#p1 #p2">
  <name type="village">Sleep Hollow</name>
  <date>early spring, 1789</date>
  <locale>a farm house, sat by the hearth</locale>
 <setting who="#p3">
  <name type="city">Sleepy Hollow</name>
  <date>early spring, 1789</date>
  <locale>school house</locale>

1.16. 16. Linking, Segmentation, and Alignment

  • Module Elements: <ab>, <alt>, <altGrp>, <anchor>, <join>, <joinGrp>, <link>, <linkGrp>, <seg>, <timeline>, <when>
<p xml:id="p123">These magic books and the poetic scrawls were forthwith consigned to
the flames by <persName xml:id="HVR5">Hans Van Ripper</persName>; who from that time
forward determined to send his children no more to school; observing, that he never
knew any good come of this same reading and writing. </p> [...]
 <link targets="#p123 facs.xml#graphic-p123"/>
 <link targets="#HVR5 people.xml#VanRipperH5"/>

1.17. 17. Simple Analytic Mechanisms

  • Module Elements: <c>, <cl>, <interp>, <interpGrp>, <m>, <phr>, <s>, <span>, <spanGrp>, <w>
  <w ana="#AT0">The</w>
  <w ana="#NN1">victim</w>
  <w ana="#POS">'s</w>
  <w ana="#NN2">friends</w>
  <w ana="#VVD">told</w>
  <w ana="#NN2">villagers</w>
  <w ana="#CJT">that</w>
  <w ana="#AT0">the</w>
  <w ana="NPO">Headless</w>
  <w ana="NPO">Horseman</w>
  <w ana="#VVD">rode</w>
  <w ana="#PRP">into</w>
  <w ana="#AT0">the</w>
  <w ana="#NN1">forest</w>
  <w ana="#CJC">and</w>
  <w ana="#AV0">never</w>
  <w ana="#VVD">surfaced</w>

1.18. 18. Feature Structures

  • Elements defined: <bicond>, <binary>, <cond>, <default>, <f>, <fDecl>, <fDescr>, <fLib>, <fs>, <fsConstraints>, <fsDecl>, <fsDescr>, <fsdDecl>, <fsdLink>, <fvLib>, <if>, <iff>, <numeric>, <string>, <symbol>, <then>, <vAlt>, <vColl>, <vDefault>, <vLabel>, <vMerge>, <vNot>, <vRange>
<fs type="real_estate_listing">
 <f name="selling.points">
  <vColl org="set">
   <string>alarm system</string>
   <string>good view</string>

1.19. 19. Graphs, Networks, and Trees

  • Elements defined: <arc>, <eLeaf>, <eTree>, <forest>, <forestGrp>, <graph>, <iNode>, <leaf>, <node>, <root>, <tree>, <triangle>
 <node xml:id="LAX2degree="2adj="#LVG2 #PHX2">
 <node xml:id="LVG2degree="2adj="#LAX2 #PHX2">
<!-- ... -->

1.20. 20. Non-hierarchical Structures

This chapter does not define a module, but explores methods to deal with overlapping structures while keeping XML well-formed. In particular:
  • 20.1 Multiple Encodings of the Same Information
  • 20.2 Boundary Marking with Empty Elements
  • 20.3 Fragmentation and Reconstitution of Virtual Elements
  • 20.4 Stand-off Markup
  • 20.5 Non-XML-based Approaches

1.21. 21. Certainty and Responsibility

  • Elements defined: <certainty>,<respons> and soon <precision>
<certainty target="#CE-pl1locus="gidegree="0.6">
 <desc>probably a placename, but possibly not</desc>

 <desc>may refer to the Earl of Essex</desc>

1.22. 22. Documentation Elements

  • This chapter defines the module which contains all the elements used in ODD.
<schemaSpec prefix="TEI_ident="testsvgstart="TEI svg">
 <moduleRef key="header"/>
 <moduleRef key="core"/>
 <moduleRef key="tei"/>
 <moduleRef key="textstructure"/>
 <moduleRef url="svg11.rng"/>

1.23. 23. Using the TEI

  • The 'Using the TEI' chapter does not define a module of elements
  • It contains sections on:
    • 23.1 Obtaining the TEI Schemas
    • 23.2 Personalization and Customization
    • 23.3 Conformance
    • 23.4 Implementation of an ODD system

2. Live Demos

Now if I have time, and an internet connection, I'll do some live demos looking around the Guidelines, Reference Material, Roma, TEI-by-Example, etc.

3. Listserv


The official listserv of the TEI community. Most inter-community communication takes place on the list. People ask technical questions about using the Guidelines and specific elements. It's also a good place to learn about what is happening in the community, with announcements of upcoming meetings and conferences.

4. Guidelines


On the website you can read and refer to the online version, purchase printed copies of the Guidelines, download the PDF version, or download the schemas, source files, documentation and other materials as zip packages from the TEI Sourceforge site.

5. Reference


The Element Index (Appendix C of the Guidelines) provides lists of all elements defined by the TEI, both alphabetically and by module.

Each element is given a brief description and a link to the portion(s) of the Guidelines providing more extensive description. Also provided are information about the module in which the element is found, attributes, model(s) the element belings to, other elements the element may contained or which may be contained within it, the schema declaration (in both RNG compact and XML formats), examples pulled from throughout the Guidelines, and any notes.

6. Roma


Website to help users design TEI validators, as a DTD, RelaxNG, or W3C Schema. Build a new customization by either adding elements and modules to the smallest possible schema or removing elements and modules from the largest possible schema, or create customizations from templates (e.g., TEI for Manuscript Description, TEI with Drama).

7. Stylesheets


"This is a set of XSLT specifications to transform TEI XML documents to HTML, to LaTeX, and to XSL Formatting Objects. It can be downloaded from the Releases area of the TEI SourceForge site. It concentrates on TEI Lite, but adding support for other modules is fairly easy. These stylesheets are primarily for use on ‘new’ documents, i.e. reports and web pages that have been authored from scratch, rather than traditional TEI-encoded existing material."

8. Badges


"Many projects use the TEI Guidelines ‘behind the scenes’ while delivering their content to the public using HTML. The following buttons provide an easy way of letting others know that an individual, group, or project makes use of the Guidelines in its work. Publicising your use of the TEI is an important part of ensuring the continuing viability of the TEI community and the TEI's profile within your discipline. The code snippets associated with each button direct users to the TEI website, encouraging your visitors and colleagues to investigate the use of the TEI for their own digital work."

9. Wiki


The TEI Wiki provides a place for TEI users to share technical information and participate in a community in addition to the TEI Listserv. There are sections on technical issues, including markup samples, customizations, and stylesheets, as well as a section on the TEI community, with information on conferences and other events, and the Special Interest Groups (SIGs). SIGs focus on particular TEI issues, including Manuscripts, Scholarly Publishing, Education, Libraries, Music, and Text and Graphics.

10. TEI-By-Example

Not finished yet:

Home Page:http://www.kantl.be/ctb/project/2006/tei-ex.htm

Not finished yet, but will give freely available online tutorials walking individuals through the different stages in marking up a document in TEI, these online tutorials will provide examples for users of all levels. Examples will be provided of different document types, with varying degrees in the granularity of markup, to provide a useful teaching and reference aid for those involved in the marking up of texts.

11. Sourceforge


The TEI Sourceforge site is where the action happens! All TEI code is stored here; there is also a bug tracker (where users can report bugs in the TEI) and a feature request area (where users can suggest new elements, attributes, models, or usage). The TEI depends on input from the community for continued improvement, both through Listserv discussion and feature requests.

Dot Porter. Date: July 2009
Copyright University of Oxford