Difference between revisions of "ODD"

From TEIWiki
Jump to navigation Jump to search
(Example)
(Future plans: "Pure ODD")
Line 41: Line 41:
 
== Future plans: "Pure ODD" ==
 
== Future plans: "Pure ODD" ==
  
Over the years ODD has evolved progressively to reflect more and more needs of the TEI community, both as the core specification language for the TEI guidelines, but also as generic customization language for any TEI users. Still ODD remains a hybrid environment combining its own vacabulary with RelaxNG fragments and at times, validation vocabularies from external languages (e.g. Schematron). The Technical Council contemplates putting on its work program a revision of the ODD infrastructure, considering either to drop it altogether in favor of one existing schema language, or extend its capabilities to make it a self contained and generic specification language.  Some thoughts are included at [[ODD-dev]], and the effort to make it self-contained is now referred to as [https://github.com/TEIC/pureodd "Pure ODD"]. There is a mailing list for discussing Pure ODD called [https://lists.sourceforge.net/lists/listinfo/tei-odds tei-odds].
+
Over the years ODD has evolved in response to the needs of the TEI community, both as the core specification language for the TEI guidelines, and also as a generic customization language. Since 2004, much
 +
effort has been put into making it less of a hybrid language, combining its own vocabulary with RelaxNG fragments and Schematron rules. Versions of TEI P5 later than 2.5 contain elements which can be used to express content models directly in the TEI ODD language, rather than in RELAXNG. This work is ongoing in the TEI Technical Council, the goal being to make ODD an entirely self-contained generic specification language, independent
 +
of other existing grammars, and hence known as Pure ODD.  See further [https://github.com/TEIC/pureodd "Pure ODD"]. There is a mailing list for discussing Pure ODD called [https://lists.sourceforge.net/lists/listinfo/tei-odds tei-odds].
  
 
== See also ==
 
== See also ==

Revision as of 18:33, 23 March 2015

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 Documentation Elements 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 key="tei"/>
  <moduleRef key="textstructure"/>
  <moduleRef key="linking"/>
  <moduleRef key="core"/>
  <moduleRef key="header"/>
  <elementSpec ident="head" mode="change">
    <content><textNode/></content>
  </elementSpec>
</schemaSpec>

produces a schema a bit like TEI Lite, with a slight change : the element <head> now can contain only text nodes.

Uses besides the TEI Guidelines and various customizations

  • Internationalization Tag Set (ITS)
  • various standards proposal designed within ISO committee TC 37 have been totally or partially written in TEI/ODD: MLIF, MAF, ISO 16642 rev., ISOTimeML

Future plans: "Pure ODD"

Over the years ODD has evolved in response to the needs of the TEI community, both as the core specification language for the TEI guidelines, and also as a generic customization language. Since 2004, much effort has been put into making it less of a hybrid language, combining its own vocabulary with RelaxNG fragments and Schematron rules. Versions of TEI P5 later than 2.5 contain elements which can be used to express content models directly in the TEI ODD language, rather than in RELAXNG. This work is ongoing in the TEI Technical Council, the goal being to make ODD an entirely self-contained generic specification language, independent of other existing grammars, and hence known as Pure ODD. See further "Pure ODD". There is a mailing list for discussing Pure ODD called tei-odds.

See also

Documentation

Presentations

Articles