TEI by Example. Module 8: Customising TEI, ODD, Roma Edward Vanhoutte Ron Van den Branden Edward Vanhoutte Ron Van den Branden Melissa Terras Association for Literary and Linguistic Computing (ALLC) Centre for Digital Humanities (CDH), University College London, UK Centre for Computing in the Humanities (CCH), King's College London, UK Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium
Centre for Scholarly Editing and Document Studies (CTB) Royal Academy of Dutch Language and Literature Koningstraat 18 9000 Gent Belgium
ctb@kantl.be
Edward Vanhoutte Melissa Terras Ron Van den Branden
Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium Gent
Centre for Scholarly Editing and Document Studies (CTB) Royal Academy of Dutch Language and Literature Koningstraat 18 9000 Gent Belgium

Licensed under a Creative Commons Attribution ShareAlike 3.0 License

9 July 2010
TEI By Example. Edward Vanhoutte editor Ron Van den Branden editor Melissa Terras editor

Digitally born

TEI By Example offers a series of freely available online tutorials walking individuals through the different stages in marking up a document in TEI (Text Encoding Initiative). Besides a general introduction to text encoding, step-by-step tutorial modules provide example-based introductions to eight different aspects of electronic text markup for the humanities. Each tutorial module is accompanied with a dedicated examples section, illustrating actual TEI encoding practise with real-life examples. The theory of the tutorial modules can be tested in interactive tests and exercises.

en-GB added distinction gi -- gi scheme="..." -- tag final spellcheck release updated to TEI P5-1.2.0 + Roma 3.5 (04/11/2008)corrected errors + typos corrected typos elaborated on didactic motivations for some choices in the tutorial replaced "Alice's Adventures Under Ground" example with "Alice's Adventures in Wonderland" due to copyright concerns with the images revisions creation
Examples for Customising TEI, ODD, Roma
Minimal customisation for journal articles

This ODD file defines a minimal TEI schema (containing the core, tei, header, and textstructure modules) that could be used to encode journal articles, adding some provisions to encode journal abstracts as metadata in the header. Of course, abstracts that are present in a printed journal articles should be encoded in the front part of the text, possibly in a dedicated div type="abstract" section. Yet, as such, the TEI header does not contain a formal way of entering an abstract as metadata, apart from perhaps a standard TEI note type="abstract" element inside the bibl part of the sourceDesc section of the TEI header. It could be argued that a more formalised way is desirable, and that a list of keywords as well as a prose description could qualify as structural parts of an abstract.

Therefore, this ODD file defines two new elements in a separate namespace ("http://www.teibyexample.org/"). Both extension elements are defined in a dedicated elementSpec element, with an add value for their mode attributes. The class declaration for the abstract element (inside classes) states that it is a member of the model.biblPart class. This means that it can occur as content of the bibl element. Furthermore, it is declared a member of the att.typed attribute class, adding the attributes type and subtype besides the global attributes. Its content (defined in the content section) is defined as a sequence of an optional abstractKeywords element and one or more members of the model.pLike class (ie, p or ab elements). The abstractKeywords element is defined next, declared as member of the att.typed class as well, with plain text as its possible contents. This new element was introduced as the existing keywords element was considered too formal for these purposes.

A minimal TEI extension for journal articles The TBE crew

for use by whoever wants it

no source, born digital

This customisation only selects the minimal TEI modules (core, tei, header, and textstructure) for brevity's sake, and adds 2 specific elements: abstract: a specific header element to express the content of an article as metadata, including keywords list and paragraphs abstractKeywords: a specific header element to encode a list of keywords in an abstract

summarises the contents of a text provides informal keywords for a text
TBE crafted example encoding, no material source.
Abolishing numbered text divisions

Following ODD file defines a minimal TEI schema (containing the core, tei, header, and textstructure modules). Besides that, it does away with numbered text divisions (div1, ..., div7) by specifying the value delete for the mode attribute on their respective elementSpec declarations.

Note that strictly speaking, only deletion of div1 is necessary, as all further numbered subdivisions should nest according to the TEI scheme. By definition, if the topmost level is deleted, all further subdivisions are practically excluded from the document model. Although they are still declared, they can't be used in documents according to this schema.

numbered divisions The TBE crew

for use by whoever wants it

no source, born digital

This customisation only selects the minimal TEI modules, and deletes all numbered subdivisions.

TBE crafted example encoding, no material source.