Menota schemes (DTD and RELAX)

Version: 2.0 beta (21 June 2005)

 

Back to list of contents

 

Deviations from TEI P4

In version 1 of the Menota handbook, a number of changes were made to the TEI Guidelines version P4. These changes were implemented in two extension files, 'menota.extention.ent' and 'menota.extension.dtd', both written in the DTD syntax for SGML. The Document Type Definition (DTD) was thereafter generated using TEI Pizza Chef. For details on this procedure, see the page Document Type Definition in v. 1.1 of the handbook. Those who wish to encode texts according to TEI P4 should refer to this version of the handbook.

 

Deviations from TEI P5

In version 2 of the Menota handbook, additions and changes have been made with reference to TEI Guidelines P5. However, due to changes in the structure of P5, the extensions have been written in XML in a schema called ODD (One Document Does it all). A new tool ROMA has been used to generate TEI schemas. ROMA allows users to choose between several outputs: a DTD, a RELAX NG schema (which, in spite of its name, can be a stricter scheme than a DTD), or a W3C Schema.

The ODD file is thus the starting point, and has therefore been listed as the first item below. The next item is a list of additional entities.

On the basis of the ODD file and the entity list, a Document Type Definition (DTD) and a RELAX NG schema has been generated with the help of ROMA.

Please note that as of TEI P5, a Menotic XML file should refer to two external files, one DTD (or a schema) and one list of entities. The beginning of the file would thus look like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE TEI SYSTEM "http://gandalf.aksis.uib.no/menota/guidelines-2/schemes/menota.dtd"
[
<!ENTITY % Menota_entities SYSTEM
'http://gandalf.aksis.uib.no/menota/guidelines-2/schemes/menota-entities.txt' >
%Menota_entities;]
>
<TEI>
....
</TEI>

See the chapter on Menota header for downloadable samples of valid Menotic XML files.

 

Current versions of Menota schemes

This is a list of all current Menota schemes. Earlier versions of these files have been moved down to the archive below and given a version number. Remember that many browsers will try to open XML files in a new window; in order to download these files, try using right-click (Windows) or alt-click (Mac).

 

(1) One Document Does it all (ODD)

The ODD file is an XML file which specifies all changes to the TEI Guidelines P5.

Menota ODD (21 June 2005) - XML file

 

(2) Entity list

The entity list specifies recommended entities. This is not an obligatory part of a schema, but is an important part of Menota encoding since a large number of charaters has to be encoded by entities. The Menota handbook recommends that all characters outside Basic Latin should be encoded with entities (although XML files may use full Unicode encoding). For characters in the Private Use Area of the Unicode Standard, it is essential that they are encoded with entities. The entity list is an ordinary text file.

Menota Entities (7 June 2005) - text file

 

(3) Document Type Definition (DTD)

The DTD is one of several schemes that are allowed in TEI P5. The DTD here is basically the same as the DTD published for version 1 of the handbook, but it has been generated with ROMA rather than TEI Pizza Chef.

Menota DTD (21 June 2005) - text file

Some browsers will attach the extension .xml to this file when downloaded. Just change the extension back to .dtd

 

(4) RELAX NG schema

The RELAX NG schema is another schema that is allowed in TEI P5. The version given here has been generated on the basis of the same ODD file and entity file as the DTD above. Using a RELAX NG schema, data values can be validated to a higher extent than what is possible with a DTD. This applies both to attribute and content values. For example, the attributes 'notBefore' and 'notAfter' in the element <origDate> have to contain a valid date value if the RELAX NG schema is used. The RELAX NG schema also supports name spaces, which is useful if one wants to mix schemes.

Menota RELAX NG (21 June 2005) - XML file

 

Archive of older versions of Menota schemes

(1) One Document Does it all (ODD)

Menota ODD #1 (20 December 2004) - XML file
Menota ODD #2 (7 June 2005) - XML file

 

(2) Entity list

Menota Entities #1 (19 November 2004) - text file

 

(3) Document Type Definition (DTD)

Menota DTD #1 (16 December 2004) - text file
Menota DTD #2 (7 June 2005) - text file

 

(4) RELAX NG schema

Menota RELAX NG #1 (17 December 2004) - XML file

 

Appendices

(1) Changes in TEI P5

This is a list of changes in TEI P5 which have implications for the Menota handbook.

Changes in TEI P5

 

(2) Encoding examples

This is a collection of all encoding examples contained in the Menota handbook.

Examples from the Menota handbook

 

Written by Tone Merete Bruvik. Last changed 2004.12.20 by TMB (First draft). Revised by OEH 2005.06.21.