Examples for Module 2: The TEI Header
Desiderius Erasmus: Colloquia familiaria
This example features the TEI header for the transcription of Colloquia familiaria
, a series of colloquia written by Desiderius Erasmus. They are encoded and made available by the Stoa Consortium, University of Kentucky.
This is an excellent example of a TEI header. The file description provides the minimal information sections about the title and responsibilities of the electronic text, its publication, and its source. Editorial principles are documented in encodingDesc, which also has a statement about sampling decisions in samplingDesc (see the TEI Guidelines section
Jennifer K. Nelson
A. Ross Scaife
Cultural Heritage Language Technologies
Department of Modern and Classical Languages, Literatures and Cultures
1055 Patterson Office Tower
University of Kentucky
Lexington, KY 40506-0027
Erasmus, Desiderius, d. 1536
Desiderii Erasmi Roterodami colloquia familiaria
ad optimarum editionum fidem diligenter emendata, cum
succincta difficiliorum explanatione
sumptibus Ottonis Holtze
771 p. (2 vols) ; 15 cm.
[2.3.2 The Sampling Declaration](http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD52)). It also contains a formal declaration of a reference system, for which it makes use of refState/ elements (see the TEI Guidelines, section [220.127.116.11 Milestone Method](http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD54M)). Two classification systems are declared in classDecl: Library of Congress Subject Headings and Library of Congress Classification. The next header section, profileDesc, contains the actual classification of the text according to both systems, in textClass. This is a nice illustration of two classification strategies: using natural language keywords (keywords) or abstract classification codes (classCode). Also, the languages of the text are formally declared in langUsage. Finally, a complete revision history is available in revisionDesc.
Editorial notes in the Holtze edition have not been reproduced
Original punctuation conventions in the Holtze edition have been retained as much as
Hyphenated words that appear at the end of the line in the Holtze edition have been
Italics are recorded without interpretation
Library of Congress Subject Headings
Library of Congress Classification
[ed] added text of "De utilitate colloquiorum ad lectorem"
[ed] expanded TEI header to include more information, e.g. LC subject headings and LC classification
[markup]: began tei-compliant markup
Based on a TEI P4 XML encoding of
Erasmus, Desiderius (1867-1872). Desiderii Erasmi Roterodami colloquia familiaria. Lipsiae: sumptibus Ottonis Holtze. Encoded and made available by the Stoa Consortium, University of Kentucky at
- Dialogues, Latin (Medieval and modern)
- Folly -- Early works to 1800
Thomas Wentworth Higginson: Letter of 7 November 1885
This example shows the TEI header of the digital edition of a letter of 7 November 1885 by the American minister and writer Thomas Wentworth Higginson, encoded and made available by the Lincoln Electronic Text Center of the University of Nebraska.
This TEI header provides detailed documentation about the electronic text in fileDesc. The title statement not only identifies the people responsible for transcription and markup, but also for the technical processing of the letters by means of stylesheets. The extent section needs to be completed still; of course, this can only be done after completion of the encoding. Note the detailed statement of availability in availability. The source text in which this letter has been published is described using the biblFull element; note how its sections reflect the actual file description in the TEI header of the electronic text (apart from the sourceDesc section). The notesStmt seems to be used to record some loose annotations about the source text.
The encoding description section only contains a description of the editorial practice in editorialDecl. This is done in a prose paragraph. The header is concluded by a minimal revision description, recording only one change.
Correspondence of Thomas Wentworth Higginson, 1865—1910
Thomas Wentworth Higginson
Stylesheet created by
Brian L. Pytlik Zillig
Commentary on the Letters by
Linda Ray Pratt
University of Nebraska—Lincoln Electronic Text Center
This work is the property of the University of Nebraska—Lincoln. It
may be copied freely by individuals for personal use, research, and teaching
(including distribution to classes) as long as this statement of
availability is included in the text. It may be linked to freely in Internet
editions of all kinds, including for—profit works.
Publishers, libraries, and other information providers interested in
providing this text in a commercial or non—profit product or from
an information server must contact the University of
Nebraska—Lincoln for licensing and cost information.
Scholars interested in changing or adding to these texts by, for example,
creating a new edition of the text (electronically or in print) with
substantive editorial changes, may do so with the permission of the
University of Nebraska—Lincoln. This is the case whether the new
publication will be made available at a cost or free of charge.
Carlton and Territa Lowenberg Collection, Archives and Special
Collections, University of Nebraska—Lincoln Libraries.
Lowenberg, Carlton; Lowenberg, Territa A.,
Archives and Special Collections, Electronic Text
University of Nebraska—Lincoln Libraries
Electronic Text Center
319 Love Library
P.O. Box 884100
University of Nebraska—Lincoln
Lincoln, NE 68588—4100
Nov. 7, 1885
No other plays by Miss Parker have come to light.
Line breaks, paragraph breaks, and indentations have been preserved within the
transcription. The layout of the page has been preserved whenever possible.
Abbreviations and spellings have been maintained within the transcriptions, and
the full word and corrected or modern spellings have been provided. Images of
the original letters have been provided in order to show the original page
layout and other markings that are not the author's. Such markings include
letter head, postcards, postal stamps, etc. and writing by other people. Words
or phrases that are deemed indecipherable have been noted as "unclear." To
provide further information as to the context of a particular letter, notations
have been provided.
Add and revise header info, change lbs and divs
Based on a TEI P4 XML encoding of a letter by
Thomas Wentworth Higginson (1885). Encoded and made available by the Lincoln Electronic Text Center of the University of Nebraska at
Christopher Marlowe: The Tragedie of Doctor Faustus (B text)
This example contains the TEI header of the digital edition of Christopher Marlowe's The Tragedie of Doctor Faustus (B text)
, encoded and made available by the Perseus Digital Library.
This TEI header provides decent descriptions of the publication details of the electronic text (publicationStmt), and the languages occurring in the text (langUsage). A reference system is declared in the encodingDesc section of the header, using refState/ elements (see the TEI Guidelines, section
[18.104.22.168 Milestone Method](http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD54M)).
The revision description is interesting both in a positive and a negative way. It clearly contains a detailed list of the changes. The list seems to be generated by an automated versioning system, which allows one to keep complete track of a file's historical states, and document changes with log messages. Integrating automated revision control in the revisionDesc section of the TEI header is an interesting idea, as it combines processability and expressiveness. However, on the encoding level, this integration could be improved. In this case, a single change element is (ab)used to record the complete revision history. If the output of the automated version control system would be formatted to distinct change elements per revision (either directly, or via a post-processing step), this would make the information much more compliant with the semantics of the TEI header.
One essential point of critique concerns the lacking description of the source document in sourceDesc. In this case, the title and author of the source work (that can be recollected from the information in the titleStmt subsection) still provide cues to its origin, but this could be much harder for less known texts. It is reasonable to suppose that the source texts of the files in the Perseus Digital Library are documented externally, but then the TEI header sections of these files should at least contain a pointer to these resources.
The Tragedie of Doctor Faustus (B text)
Perseus Project, Tufts University
Prepared under the supervision of
Trustees of Tufts University
This text may be freely distributed, subject to the following
$Log: marl.faustb.xml,v $
Revision 1.2 2004/04/22 14:24:57 cwulfman
*** empty log message ***
Revision 1.1 2004/04/22 13:55:24 cwulfman
Making xml files the canonical ones.
Revision 1.11 2003/07/01 22:14:53 yorkc
Updated texts to TEI P4 and Perseus P4 extensions; minor cleanup (esp. character encodings and typos.)
Revision 1.10 2000/04/27 23:22:22 dasmith
Hopperized TEI header.
Revision 1.9 1999/09/01 17:15:34 dasmith
Fixed preamble and added encodingDesc.
Revision 1.8 1997/09/11 16:00:37 textgod
Updated for nsgmls.
Revision 1.7 1997/07/02 21:57:11 textgod
Added CASTLIST HEAD
Revision 1.6 1997/06/30 21:57:09 textgod
Added group for the prologue.
Revision 1.5 1997/06/25 14:51:39 textgod
Fixed broken NAME tag.
Revision 1.4 1997/06/25 14:40:00 textgod
Added log messages to file.
Based on a TEI P4 XML encoding of
Marlowe, Christopher (1616). The Tragedie of Doctor Faustus
. Encoded and made available by the Perseus Digital Library. Available online at
- You credit Perseus, as follows, whenever you use the document:
Text provided by Perseus Digital Library, with funding from Tufts University. Original version available for viewing and download at http://www.perseus.tufts.edu/hopper/.
- You leave this availability statement intact.
- You use it for non-commercial purposes only.
- You offer Perseus any modifications you make.
William Shakespeare: Sonnet 17
The following example illustrates the TEI header for a sonnet by William Shakespeare, containing a detailed metrical analysis of the poem. Both the electronic text and its source are bibliographically described in the fileDesc section. The text encoding process is described in encodingDecl, providing details about the encoding project (projectDesc), the editorial policy (editorialDecl), and the system used to analyse the metre of the poem (metDecl). Note how the editorialDecl subsection had to be repeated, as it both documents features that can be encoded in a TEI category (segmentation and interpretation), and features for which no such TEI labels are available. (p). The standard TEI scheme does not allow both systems (formal and informal) to be mixed, hence the repetition of the encodingDesc section. The same goes for the metDecl sections: as both a formal (metSym) and informal (p) description is provided for the metrical system, repeating the metDecl element was the easiest solution. Of course, this could have been addressed as well by adapting the TEI schema.
A Selection of Sonnets: electronic edition encoded in XML with a TEI DTD
Transribed and encoded by
University College London
The Complete Works of William Shakespeare
A total of ten sonnets collected and encoded according to the metrical
interpretation of the verse by Mubina Islam, August 2004. This document was
created as part of a Master's dissertation on the markup of poetic metre, for
the course MA Electronic Communication and Publishing at UCL.
Each sonnet has been divided into the stanzaic line groupings.
Line groups have been further divided to mark individual lines of verse.
Segmentation tags have been used to represent the division of each line into
The metrical interpretation of the text, defined with the segmentation of the
text into units of feet, was added by hand by the encoder. This has not been
checked and may be subject to alternative readings.
All punctuation marks, excluding dashes or hyphenation, have been encoded as entities.
Caesuras and line enjambement have been recorded in this document as accurately
as possible by the encoder.
metrical line boundary
Metrically prominent syllables are marked '+' and other syllables '-'. Foot
divisions are marked by a vertical bar, and line divisions with a solidus.
This notation may be applied to any metrical unit, of any size (including, for
example, individual feet as well as groups of lines).
The 'real' attribute has been used to indicate possible variations in the iambic
base metre. Where this attribute is not included, it is assumed each foot
inherits the iambic metre defined for the overall division of text.
The 'met' attribute has been used in feet which have a missing or additional
syllable rather than the two syllables expected, although the line may still
confirm to the metre of the poem.
Based on a TEI P4 XML encoding of
Islam, Mubina (2004). A Selection of Sonnets: electronic edition encoded in XML with a TEI DTD. Unpublished Master's Dissertation, London: University College London
Alexander, Peter (1978) The Complete Works of William Shakespeare. London: Collins.).
Walt Whitman: After the Argument
This example contains the TEI header of the digital edition of a manuscript draft of After the Argument
, a poem by Walt Whitman. It was encoded and made available by the Walt Whitman Archive.
This TEI header contains a detailed description of the electronic text in fileDesc. Apart from the required subsections, the edition of the electronic text is identified briefly in editionStmt. The notesStmt element contains a general remark about the dating of the manuscript.
Besides the file description, the header contains a detailed account of the file's history in revisionDesc.
Functioning as the header of a manuscript transcription, however, one would have expected at least an encodingDesc, documenting how the electronic version relates to the source text. When this text is seen in isolation, this header falls short in explaining the editorial choices (that are referred to, however, in the revisionDesc). Of course, this text probably features in the wider context of the Walt Whitman Archive, where uniform encoding practices were used for all texts. Still, without repeating boilerplate information in each text of the archive, it would have made sense to provide an editorialDecl section with at least pointers to the external documentation of these practices available at
[http://www.whitmanarchive.org/about/editorial.html](http://www.whitmanarchive.org/about/editorial.html) and [http://www.whitmanarchive.org/mediawiki/index.php/Whitman_Encoding_Guidelines](http://www.whitmanarchive.org/mediawiki/index.php/Whitman_Encoding_Guidelines). Furthermore, as the transcription is fairly detailed in the recording of editorial phenomena (additions, deletions, substitutions), identification of the different document hands in profileDesc could have made sense.
(Of course, these are only minor remarks, relative to the quality of the surrounding documentation of the archive in which this text is embedded. Yet, even if such external documentation exists, it makes sense to provide pointers in the document.)
After the Argument
a machine readable transcription
Transcription and encoding
the Walt Whitman Archive staff
The Institute for Advanced Technology in the Humanities
University of Iowa
University of Nebraska-Lincoln
The National Endowment for the Humanities
The United States Department of Education
The Walt Whitman Archive
The Institute for Advanced Technology in the Humanities
University of Virginia
P.O. Box 400115
Charlottesville, VA 22904-4115
Copyright © 2001 by Ed Folsom and Kenneth M. Price, all rights
reserved. Items in the Archive may be shared in accordance with the Fair Use
provisions of U.S. copyright law. Redistribution or republication on other
terms, in any medium, requires express written consent from the editors and
advance notification of the publisher, The Institute for Advanced Technology
in the Humanities. Permission to reproduce the graphic images in this
archive has been granted by the owners of the originals for this publication
This manuscript was likely written in 1890 or early 1891, shortly before the poem's
After the Argument
1890 or 1891
The Charles E. Feinberg Collection of the Papers of Walt
Whitman, Library of Congress, Washington, DC
Transcribed from Joel Myerson, ed. The Walt Whitman Archive
I: Whitman Manuscripts at the Library of Congress, New York: Garland, 1993,
Part I: 121; Major American Authors on Cd-Rom: Walt Whitman, Westport, CT:
Primary Source Media, 1997; our own digital image of original
Addition of Date and Work Markup
Conversion to camel-case
Updated to current practice
Checked by editor
Based on a TEI P4 XML encoding of
Whitman, Walt, After the Argument
, a manuscript encoded and made available by the Walt Whitman Archive at
Oscar Wilde: The Importance of Being Earnest
This example contains the TEI header for an electronic edition of Oscar Wilde's The Importance of Being Earnest
, encoded and made available by Corpus of Electronic Texts (CELT), a project of University College, Cork.
This is an excellent TEI header example, featuring quality descriptions of the electronic text (fileDesc), its relation to the source text (encodingDesc), the context in which it came about (profileDesc), and a revision history (revisionDesc).
An outstanding feature of this example is the level of detail for the bibliographic description of the source text, in sourceDesc. It contais a complete bibliography, in three sections:
The Importance of Being Earnest
A trivial comedy for serious people
An electronic edition
University College, Cork
First draft, revised and corrected.
Proof corrections by
CELT: Corpus of Electronic Texts: a project of University College,
College Road, Cork, Ireland.
CELT online at University College, Cork, Ireland.
select bibliography, and
the edition used in the digital edition. The former two categories consist of bibliographic lists, with a listBibl element grouping the separate bibl elements. The actual edition used for the electronic text is described in detail with a biblStruct element.
Available with prior consent of the CELT programme for purposes of academic
research and teaching only.
There is not as yet an authoritative edition of Wilde's works.
The writings of Oscar Wilde (London; New York: A. R. Keller
& Co. 1907) 15 vols.
Robert Ross (ed), The First Collected Edition of the Works of Oscar
Wilde (London: Methuen & Co. 1908). 15 vols. Reprinted Dawsons: Pall
Complete works of Oscar Wilde (Glasgow: HarperCollins, 1994).
'Notes for a bibliography of Oscar Wilde', Books and book-plates (A
quarterly for collectors) 5, no. 3 (April 1905), 170-183.
Karl E. Beckson, The Oscar Wilde encyclopedia (New York: AMS Press 1998).
AMS Studies in the nineteenth century 18.
Richard Ellmann (ed), The Artist as Critic: Critical Writings of Oscar
Wilde (Chicago 1982).
Richard Ellmann; John Espey, Oscar Wilde: two approaches: papers read at a
Clark Library seminar, April 17, 1976 (Los Angeles: William Andrews Clark
Memorial Library, University of California 1977).
Richard Ellmann, Oscar Wilde at Oxford: a lecture delivered at the Library
of Congress on March 1, 1983 (Washington, DC: Library of Congress
Richard Ellmann, Oscar Wilde: a biography (London: Hamilton 1987).
Juliet Gardiner, Oscar Wilde: a life in letters, writings and wit (Dublin:
Gill & Macmillan 1995).
Frank Harris, Oscar Wilde, including My memories of Oscar Wilde, by George
Bernard Shaw and an introductory note by Lyle Blair (London: Robinson,
Rupert Hart-Davis (ed), Selected letters of Oscar Wilde (Oxford: Oxford
University Press 1979).
Rupert Hart-Davis (ed), More letters of Oscar Wilde (London: Murray
Vyvyan Beresford Holland, Oscar Wilde: a pictorial biography (London:
Thames & Hudson 1960).
H. Montgomery Hyde, Oscar Wilde: a biography (London: Methuen
Andrew McDonnell, Oscar Wilde at Oxford: an annotated catalogue of Wilde
manuscripts and related items at the Bodleian Library, Oxford, including
many hitherto unpublished letters, photographs and illustrations (A.
McDonnell 1996). Limited edition of 170 copies.
Stuart Mason, Bibliography of Oscar Wilde (London: E. G. Richards 1907).
Also pubd. New York 1908, London 1914 in 2 vols. Repr. of 1914 edition: New
York: Haskell House 1972.
E. H. Mikhail, Oscar Wilde: an annotated bibliography of criticism
(London: Macmillan 1978). Also pubd. Totowa NJ: Rowman & Littlefield
Thomas A. Mikolyzk, Oscar Wilde: an annotated bibliography (Westport CT:
Greenwood Press 1993). Bibliographies and indexes in world literature,
Norman Page, An Oscar Wilde chronology (London: Macmillan 1991).
Hesketh Pearson, A Life of Oscar Wilde (London 1946).
Richard Pine, The thief of reason: Oscar Wilde and modern Ireland (Dublin:
Gill & Macmillan 1996).
Horst Schroeder, Additions and corrections to Richard Ellmann's Oscar
Wilde (Braunschweig: H. Schroeder 1989)
The edition used in the digital edition.
The Importance of Being Earnest
Plays, Prose Writings and Poems
CELT: Corpus of Electronic Texts
All the editorial text with the corrections of the editor has been retained.
Text has been checked, proof-read and parsed using NSGMLS.
The electronic text represents the edited text. Compound words have not been
hyphenated after CELT practice.
Direct speech is marked q.
The editorial practice of the hard-copy editor has been retained.
div0=the whole text.
Names of persons (given names), and places are not tagged. Terms for cultural
and social roles are not tagged.
The n attribute of each text in this corpus carries a unique
identifying number for the whole text.
The title of the text is held as the first head element within each
div0 is reserved for the text (whether in one volume or many).
By Oscar Wilde (1854-1900). 1895
Whole text in English.
One word occurring twice in Anglo-French.
Text parsed using NSGMLS.
Proof corrections entered and mark-up corrected; text spell-checked.
Header created; structural mark-up inserted.
Text captured by scanning.
Based on a TEI P3 SGML encoding of
Wilde, Oscar, The Importance of Being Earnest
. Encoded and made available by CELT: Corpus of Electronic Texts: a project of University College, Cork. Available online at