Revising a DTD with the help of TEI's PizzaChef

Version 1.0 (20 May 2003)

The Menota DTD is revised by using the PizzaChef according to the procedure outlined below:

(1) Any changes to the DTD shall be written into the files norron.extensions.ent and norron.extensions.dtd. Minor changes - like changes to the entity table - are only made to 'norron.extensions.ent', while more complex changes - like modifications to element properties - are made by modifying the 'norron.extensions.ent' file and then the 'norron.extensions.dtd' file.

We can use the <keywords> element to illustrate this. First, a change is made to 'norron.extensions.ent':

<!-- keywords is to be modified -->
<!ENTITY % keywords 'IGNORE'>

After this modification has been made, the new element declaration for <keywords> has to be written into 'norron.extensions.dtd':

<!-- #PCDATA was added, and by that changed it into mixed context -->
<!-- Content model modified April 24, 2001, ESO -->
<!ELEMENT keywords %om.RO; (#PCDATA | term | list)* >
<!ATTLIST keywords

%a.global;
scheme IDREF #IMPLIED>

(2) After the two extension files have been saved, it is time to activate the PizzaChef program.

(3) Under "Step 1:choose your base": choose 'Mixed base' in the left column, and then check the 'prose' and 'verse' boxes.

(4) Under "Step 2: choose your toppings": check the 'Linking', 'figures', 'Analysis', 'textcrit' and 'names.dates' boxes.

(5) Under "Step 3: choose your entity set": nothing has to be entered (since a complete set of entities has been defined in 'norron.extensions.dtd').

(6) Under "Step 4: Review selected items": no selections are made.

(7) Under "Step 5: Supply your modification files": you have to supply the two files 'norron.extensions.ent' and 'norron.extensions.dtd' to the PizzaChef.

(8) Under "Step 6: Bake that pizza": you simply click on "GENERATE FULL DTD".

(9) The complete DTD will now be displayed in your browser. At this point, it is often a good idea to search the document for the keyword "Error" to see if any errors have been reported in the file.

(10) Choose "Save As" from the file menu, and save the output under the name "norron.dtd" on the preferred server. Remember to archive the previous version before deleting it.

Preliminary version created 6 February 2002. Version 1.0 published 20 May 2003.