Release 4.4.0 is codenamed ‘Ukraine Solidarity’.1
This release introduces 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. A full list of the issues resolved in the course of this release cycle may be found under the 4.4.0 milestone.
The following changes are particularly worth highlighting in this release:
Changes to content models
- The listRef element is now a member of the element class model.ptrLike. Furthermore, constraints on the use of listRef within Documentation Elements have been added and the corresponding remarks have been updated. (#1667 and #2209).
- The graphic element is now a member of the attribute class att.typed. A corresponding example has been added to the specification (#1999).
- The constraintSpec element has been added to elements that get copied to p5subset (#2187).
- The stage element is now member of the attribute class att.written (#2197).
- The constraint that an objectIdentifier must have at least one child element was moved from the Schematron schema to the Relax NG schema.(#2260).
- In release 4.1.0, att.interpLike became a member of att.typed, in preference to its previously locally-defined type attribute (#2012). Due to a yet unfound (let alone solved) bug in the Stylesheets this caused an egregious error in the HTML output. Thus this change has been reverted until such time as the bug can be fixed: att.interpLike is no longer a member of att.typed and locally defines both type and subtype (#2270).
Improvements of prose and examples
- The descriptions of the legal values of the mode attribute in the attribute class att.combinable have been clarified (#1715).
- The description of the "URI" value of the type attribute of the idno element has been improved (#2071).
- The prose in the subsection on Grouped Texts has been updated (#2203).
- The description for the msDesc element has been improved (#2218).
- Two examples have been added to demonstrate the annotation of multiple ruby streams in the same alignment (#2110).
- A constraint has been added for the global source attribute on ODD elements (#1869).
- Several typos and unclear expressions have been corrected (#2178, #2181, #2186, #2191, #2198, #2236).
- A number of translations have been added, updated or improved (PR #2199, PR #2201).
Housekeeping
- The Bibliography now includes entries for examples in French and Taiwanese Mandarin when previously they were only available in their language-specific version of the Guidelines; in addition, the sort order of many entries has been corrected (#2106).
- tei_dictionaries.odd has been removed from Exemplars (#1572).
- The deprecated elements charName, charProp, glyphName, localName, unicodeName, and value have been removed (#2232).
- The schemaSpec element is now only permitted as a child of encodingDesc, back, body, div, div1, div2, div3, div4, div5, div6, div7, or front; its use in other places has been deprecated since release 4.1.0 (#1921).
- The phrase-level encoding of macros has been made consistent (#2192).
- Outdated references to SourceForge have been removed (#2206).
- The identifiers of ident attributes in constraintSpec elements have been made unique, and a constraint has been added to require uniqueness (#2223).
- The targets for generating PDF in the P5/Makefile have been renamed for better orientation (#2217).
- The Jenkins image has been updated to fix the out of memory error (#2239).
- Links to the W3C website have been updated to https (PR #2238).
- Editorial errors have been fixed in the remarks in the moduleRef tagdoc, and a constraint has been added to flag simultaneous use of include and except on the same moduleRef as an error (PR #2265).
- The directory listing for https://tei-c.org/Vault/P5/ has been repaired (#2167).
In addition, many improvements have been made to the XSLT 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 at https://github.com/TEIC/Stylesheets. A full list of the issues resolved in the course of this release cycle may be found under the 7.53.0 milestone.
Highlights of this release include:
- The processing in docx2tei has been aligned with the Guidelines prose, differentiating between
list/@type
and list/@rend
(#465). - The obsolete HTML output declaration has been updated to a current XHTML5 declaration (#487).
- Both idno and altIdent are now accepted as encodings for the FPI of a module (#509).
- A template to handle images has been added to tei-to-markdown.xsl (#511).
- The superfluous word Attributes in the tables of element and attribute classes, which appeared in the HTML output documentation from user ODD files, has been removed (#515).
- Phrase-level references to macros and datatypes are now links in the PDF (#526).
- The file tools/getnames.xsl now gets p5subset.xml from the Stylesheets repo, rather than from the web (#527).
- An incorrect namespace URI in the file html/html_figures.xsl has been corrected (#546).
- The names of elements and classes that appear in specification lists in the PDF version of the Guidelines are now links to the appropriate documentation (#537).
- A flag has been added to Specification pages in the HTML version of the Guidelines to indicate out-of-date translations #138).