maketeidtd

1. Summary

This is a Perl script which runs Michael Sperberg-McQueen's TEI `carthage' DTD compiler, providing the same functionality as the Web-based pizzachef at http://www.hcu.ox.ac.uk/TEI/pizza.html.

2. Installation

You need to do 3 things to use this script

• build `carthago' from the carthage directory at the same level as this. (a simple "make" should do it, assuming you have bison and flex installed). Install it in a directory on your PATH
• get the TEI P4 DTDs and install them somewhere.
• copy the script maketeidtd to a directory on your PATH, and edit it to set the directory where the TEI DTDs are (the variable $TEIDTD, right at the top)

The maketeidtd distribution (including carthage) is available for download as a zip file

3. Usage

There are no mandatory arguments. Left to itself, the script will build a subset of the TEI based on the prose base, and the figures + linking + analysis tagsets (a bit like TEI Lite, but not exactly).

The optional arguments are as follows:

--help

show options

--debug

verbose result and debug files left behind

--verbose

verbose result (default. use --noverbose to turn it off)

--xml

make XML DTD

--sgml

make SGML DTD

--xmlpe

make XML DTD with tag omissibility

--teidir=PATH

location of TEI DTDs

--ext=NAME

stem name of extension DTD and ENT files

--result=NAME

name of final DTD

--base=NAME

base tagset

--tagsets=NAMES

list of tag sets to include (space-separated)

--driver=NAME

pre-existing driver file

In the `examples' directory are some sample extension files. To build a DTD for example, from the extension files called "tei-equation", the incantation might be

 maketeidtd --ext=tei-equation --result=tei-with-eq.dtd --base=prose --tagsets="linking analysis figures"