Women Writers Project Schema Customization

The WWP’s schema is a customization of the TEI Guidelines. The TEI’s customization mechanism is expressed through what is termed an “ODD customization file,” which represents all of the choices and modifications made by an individual project to generate a custom TEI schema. (This customization process is integral to the use of the TEI; there are no TEI schemas that are not “customizations” in this sense.) From the ODD file, one can then generate a family of schemas (used to validate TEI-encoded documents) and also documentation describing the specific elements and attributes included in the custom schemas.

We make the following items available for download:

The tag documentation provides minimal information about usage of elements in cases where the WWP’s usage is more specific than that described in the TEI Guidelines (or in cases of elements created by the WWP). You may also find our full documentation of encoding practices useful.

All of these materials are published under a CC-BY-SA 4.0 license. As a reminder, if you are planning to make modifications to any of these items, you should modify the ODD file and generate schemas etc. from that; never modify a generated file directly.

A Note on TEI Conformance

The TEI makes a distinction between two different classes of customization: customizations that govern “TEI-conformant” documents which may reduce the number of elements but remain valid against the full TEI, and customizations that use “TEI extensions,” which may introduce additional elements and concepts not present in the TEI. WWP documents fall into the latter category, for reasons that are more complex than might at first appear. First, the WWP does introduce new concepts and distinctions which are not described in the TEI Guidelines. However, these new elements are in the WWP namespace, and thus (depending on how the TEI’s language on conformance is interpreted) might be fall under the provision of “us[ing] the TEI Namespace (and other namespaces where relevant) correctly” (see TEI P5 23.4.4 Use of the TEI Namespace). Secondly and more significantly, the WWP schema assigns all of its elements (not only those originating with the WWP) into the WWP namespace. This is largely for reasons of local convenience, since it eliminates the need for our encoders to navigate different namespaces during the encoding process. However, the conversion of the schema and the encoded documents to the more correct use of the TEI and WWP namespaces is informationally straightforward. The WWP thus operates from day to day with a schema that makes use of TEI extensions, but philosophically the schema is (and can be converted to be) TEI-conformant.

For more detail on TEI conformance, please see TEI P5 23.4 Conformance.