Text only | Skip links
Skip links||IT Services, University of Oxford

1. Introduction

ODD (One Document Does it all) is the XML vocabulary which the TEI system uses to describe itself, and which users of the TEI employ to create documentation and schemas appropriate to their varied needs. It can be used to document and describe any XML vocabulary. This workshop on Understanding ODD is taught by James Cummings and Sebastian Rahtz.

The first part of the course provides a hands-on practical introduction to the basic ideas of the ODD system, exploring the process of designing a TEI profile from the user perspective, and using the Roma application to model a schema. We will explore the capabilities of Roma, from designing and testing a basic XML schema with a few clicks, up to the design of a highly customized and multilingual application profile. Attendees are expected to have some basic knowledge of XML and the TEI, but more importantly should come with some specific sets of texts and applications in mind.

The second part explores the ODD encoding system itself. Using an XML editor, we will see how an ODD file is constructed and maintained, and explore parts of the markup scheme not supported directly by Roma.

2. Course Programme

The details of the course programme are as follows. Each of the teaching sessions will consist of two talks and two practical exercises.

Time Activity Details/learning outcome Leader
08.30 - 10.00 Using Roma to customize the TEI. Slides in PDF and TEI XML. For exercise see exercise-01-roma.xml Participants can use Roma confidently, generate schema and documentation, and use the schema in oXygen JC
10.30 - 12.00 Understanding the ODD language. Slides in PDF and TEI XML. For exercise see exercise-02-odd.xml Participants understand the ODD language, can edit an ODD file using oXygen and process the file using OxGarage or Roma, can work with multiple namespaces, and understand RELAX NG content patterns SR

3. Resources

Table 2. Data files
work/ex1.xml Sample TEI document to test validation
tei_odds.rnc Schema for validating ODD files
skeleton.odd Simple skeleton odd
demo.odd Complex demo ODD
demo.nvdl NVDL file for demo
This document
Roma: generating validators for the TEI
TEI By Example section on ODD
TEI @ Sourceforge
TEI P5: Guidelines for Electronic Text Encoding and Interchange
TEI: Stylesheets
W3C XML Schema
oXygen XML Editor

James Cummings and Sebastian Rahtz. Date: June 2011
Copyright University of Oxford