Author: Oxford University Computing Services, 13 Banbury Road, Oxford OX2 6NN, United Kingdom

| ## Oxford University Computing Services
# maketeidtd
| Author: Sebastian Rahtz (revised rahtz) Date: (revised 10/12/2001)

maketeidtd
Sebastian Rahtz
December 2001

## Contents

## 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"