<?xml version="1.0"?>
<!DOCTYPE TEI.2 SYSTEM "http://www.oucs.ox.ac.uk/dtds/tei-oucs.dtd" [
 <!ENTITY properties SYSTEM "properties.xml">
]>
<TEI.2>
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title>maketeidtd</title>
        <author>Sebastian Rahtz</author>
      </titleStmt>
      <publicationStmt>
        <p> </p>
      </publicationStmt>
      <sourceDesc>
        <p></p>
      </sourceDesc>
    </fileDesc>
    <revisionDesc>
         <change>
            <date>$Date: 2002/04/13 $</date>
            <respStmt>
               <name>$Author: rahtz $</name>
            </respStmt>
            <item>$Revision: #3 $</item>
         </change>
    </revisionDesc>
  </teiHeader>
  <text>
<front>
<titlePage>
<docTitle>
 <titlePart type="main">maketeidtd</titlePart>
</docTitle>
<docAuthor>Sebastian Rahtz</docAuthor>
<docDate>December 2001</docDate>
</titlePage>
</front>
<body>
<div>
<head>Summary</head>
<p>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 <xptr
			     url="http://www.hcu.ox.ac.uk/TEI/pizza.html"/>.</p>

</div>

<div>
<head>Installation</head>
<p>
You need to do 3 things to use this script
<list>
<item> 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
</item>
<item>get the TEI P4 DTDs and install them somewhere.</item>

<item>copy the script <code>maketeidtd</code> 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)
</item>
</list>
The <code>maketeidtd</code> distribution (including carthage) is available for download as
a <xref url="maketeidtd.zip">zip file</xref>
</p>
</div>

<div>
<head>Usage</head>

<p>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).</p>

<p>The optional arguments are as follows:
<list type="gloss">
<label>--help</label>
<item>                show options</item>
<label>--debug      </label>
<item>          verbose result and debug files left behind</item>
<label>--verbose</label>
<item>              verbose result (default. use --noverbose to turn it off)</item>
<label>--xml</label>
<item>                  make XML DTD</item>
<label>--sgml</label>
<item>                make SGML DTD</item>
<label>--xmlpe</label>
<item>               make XML DTD with tag omissibility</item>
<label>--teidir=PATH</label>
<item>          location of TEI DTDs</item>
<label>--ext=NAME</label>
<item>             stem name of extension DTD and ENT files</item>
<label>--result=NAME</label>
<item>          name of final DTD</item>
<label>--base=NAME</label>
<item>	       base tagset</item>
<label>--tagsets=NAMES</label>
<item>	       list of tag sets to include (space-separated)</item>
<label>--driver=NAME</label>
<item>	       pre-existing driver file</item>
</list>
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
<eg>
 maketeidtd --ext=tei-equation --result=tei-with-eq.dtd --base=prose --tagsets="linking analysis figures"
</eg>
</p>
</div>
</body>
</text>
</TEI.2>

