ODD

ODD stands for "One Document Does it all". It is a TEI XML-conformant specification format that allows one to customize TEI P5 in a literate programming fashion. It uses elements from the new Tag Documentation module.

Description

The TEI Guidelines, its DTD, and its schema fragments, are all produced from a single XML resource containing:

1. Descriptive prose (lots of it)
2. Examples of usage (plenty)
3. Formal declarations for components of the TEI Abstract Model:
   1. elements and attributes
   2. modules
   3. classes and macros

We call this resource an ODD (One Document Does it all), although the master source is instantiated as a gazillion XML mini-documents.

A system of XSLT stylesheets called Roma has been created for the purpose of easy manipulation of ODD files.

Example

The TEI scheme can only be used by customizing it. Customizations are also expressed in the ODD language. For example:

<schemaSpec ident="myTEIlite">
<desc>This is TEI Lite with simplified heads</desc>
  <moduleRef name="teistructure"/>
  <moduleRef name="linking"/>
  <moduleRef name="core"/>
  <moduleRef name="teiheader"/>
  <elementSpec ident="head" mode="change">
    <content><rng:text/></content>
  </elementSpec>
</schemaSpec>

produces the schema for TEI Lite, with a slight change.

See also

• Getting Started with P5 ODDs
• A talk about the ODD system, given on 13 Feb 2007 by Lou Burnard and Sebastian Rahtz at the OUCS Encoding Digital Texts workshop
• A PowerPoint presentation on TEI/ODD by Laurent Romary; OUCS, September 2006
• A fragment of W3C's Best Practices for XML Internationalization concerning ODD customization for the Internationalization Tag Set (ITS).
• Odd Customizations, by Syd Bauman and Julia Flanders.
• RelaxNG with Son of ODD, by Lou Burnard and Sebastian Rahtz.
• Freedom to Constrain by Syd Bauman