Release 3.1.0

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view

Release 3.1.0

Hugh Cayless-2
Dear TEI-Listers,

The TEI Consortium has released the TEI Guidelines version 3.1.0 (Codename: Tea Day). Our release technicians today were James Cummings and Magdalena Turska, assisted by Martin Holmes and myself. I am happy to report that the release went very smoothly. For more details, please see the release notes attached below.

As always, we encourage you all to report bugs and make feature requests via the new GitHub site at Your input is how we know what to work on, and we cannot do without it! All of the TEI Consortium’s software projects are hosted at and issues or feature requests should be reported at the various project repositories there. The Guidelines are available from all the usual places (such as the TEI website and the GitHub site A new release of the TEI Stylesheets has been made in conjunction with the 3.1.0 release at The updated oxygen-tei package is available at Debian users will note that there has not been a proper Debian release of the TEI packages in some time. We have not yet come up with a good replacement for the repository that used to be maintained by Sebastian Rahtz, but unsigned packages are available at and The release notes are also linked from the footer of the online Guidelines (

All the best,
Hugh Cayless

Release Notes:

This release (Codename: Tea Day) marks the completion of two major new features introduced in the previous release. First, Pure ODD is now completely pure: all content models in TEI ODDs may now be represented entirely in TEI, with no requirement for RELAX NG (which may still be used if desired). In the previous release, RELAX NG was still needed in macros that permitted any XML content, which are used in content models such as <egXML>. Second, this release contains the first Exemplar which implements the Processing Model specification introduced in 3.0.0 and produced as part of the work of the TEI Simple project, which was funded by the Andrew W. Mellon Foundation. TEI simplePrint is an entry-level customization, focused primarily on the needs of those encoding Western European early modern printed material such as that produced by the Text Creation Partnership. We hope that, beyond its value as a customization for working with this type of material, it will serve as a template for producing other new customizations that leverage the Processing Model.

Release 3.1.0 of the TEI Guidelines also introduces other new features and resolves a number of issues raised by the TEI community. As always, the majority of these changes and corrections are a consequence of feature requests or bugs reported by the TEI community using the GitHub tracking system. If you find something you think needs to change in the TEI Guidelines, schemas, tools, or website, please submit a feature request or bug issue at for consideration. A full list of the issues resolved in the course of this release cycle may be found under the 3.1.0 milestone.

* The source attribute is now global.
* There is a new <schemaRef> element for pointing to one's TEI ODD customization.
<note> and <witDetail> are now permitted in <rdgGrp>.
* A new datatype teidata.prefix has been introduced to allow restricting an attribute value to one that could be use as a URI scheme name.
* The ident attribute of <prefixDef> is now restricted to the new teidata.prefix datatype. This will avoid errors which would occur if a character that is not legal as a URI scheme were used as part of this attribute’s value.
* Further formal constraints on the output and predicate attributes of <model> have been added to try to help users avoid ambiguous sets of <model>s elements.
* ISO Schematron is now the only flavor of Schematron used or supported by the Guidelines.
* The following constructs are now deprecated:
     -the value 'isoschematron' of scheme of <constraintSpec> (use 'schematron' instead, as they mean the same thing now).
     -the default value (false) of defective of att.msExcerpt
     -the default value (unknown) of status of <availability>
     -the default value (unknown) of status of <correction>
     -the default value (unknown) of aloud of <said>
     -the default value (unknown) of discrete of <sound>
* The rules regarding <f>, its content, and its fVal attribute, have been cleaned up to fix a contradiction.
* The <title> element is now a member of att.datable.
* The <listBibl> element is now a member of model.frontPart.
* A new element called <anyElement> has been introduced, which permits any XML content in a content model. This removes the last remaining requirement for RELAX NG in content models, allowing us to define TEI entirely in TEI.
* A new element called <dataFacet> for restricting references to W3C datatypes in ODD has been introduced.
<supplied> is now part of model.choicePart, so it can be used within <choice>.
* A new attribute require has been added to att.textCritical. It can be used to indicate interdependance between variant readings.
* The extent attribute on the <orth> and <pron> elements no longer has a default value.
* A new Exemplar called simplePrint has been added. Developed as part of the TEI Simple project, it makes extensive use of the processing model techniques introduced in the previous release and is fully documented by the ODD included in this release.
* The TEI conference and members meeting 2016 in Vienna saw the first ‘TEI2German Translatathon’ to translate several descriptions, glosses, and remarks of the TEI specification into German. The results of this community effort have been added to this release – many thanks again to all participants and the local organizers for all the commitment and enthusiasm!

In addition, dozens of wording improvements and corrections of typographic errors have been made to the Guidelines.

Many improvements, including support for the new <anyElement> and for the minOccurs and maxOccurs attributes used by Pure ODD have been made to the XSL stylesheets (which provide processing of TEI ODD files for Roma and OxGarage as well as other TEI conversions). The Stylesheets are maintained separately from the Guidelines and are at