Difference between revisions of "ODD"

From TEIWiki
Jump to navigation Jump to search
m (Reverted edit of Recito, changed back to last version by James)
(more intro, sections, + category, + links to external resources)
Line 1: Line 1:
'''ODD''' is "One Document Does it all".
+
'''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:
 
The TEI Guidelines, its DTD, and its schema fragments, are all produced from a single XML resource containing:
  
Line 10: Line 12:
 
# We call this resource an ODD (One Document Does it all) although the master source is instantiated as a gazillion XML mini-documents.
 
# We call this resource an ODD (One Document Does it all) although the master source is instantiated as a gazillion XML mini-documents.
  
 
+
== Example ==
 
The TEI scheme can only be used by customizing it. Customizations are also expressed in the ODD language. For example:  
 
The TEI scheme can only be used by customizing it. Customizations are also expressed in the ODD language. For example:  
  
Line 26: Line 28:
 
</pre>
 
</pre>
  
produces the schema for TEI Lite, with a slight change
+
produces the schema for TEI Lite, with a slight change.
 +
 
 +
== See also ==
 +
*[http://tei.oucs.ox.ac.uk/Oxford/2007-02-13-oucs/talk-odds.xml A talk about the ODD system], given on 13 Feb 2007 <!-- by someone, somewhere -->
 +
*[http://www.tei-c.org/Drafts/edw88.xml A draft of a P5 ODD HowTo], by Lou Burnard
 +
 
 
[[Category:Acronyms]]
 
[[Category:Acronyms]]
 +
[[Category:Customization|!]]

Revision as of 02:05, 4 April 2007

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
  4. We call this resource an ODD (One Document Does it all) although the master source is instantiated as a gazillion XML mini-documents.

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