An Introduction to TEI:
Laura Mandell, Miami Univ. of Ohio
(audio file describing the instructions below)
Parts of a Document:
The XML encoded document is made up of two important parts:
(a) the prolog contains the rules -- the statement about which DTDs are used and modifications of or additions to them;
(b) the TEI document, itself made up of two parts, the TEI header and the text:
(c) The TEI Header describes the document in a way that librarians, print connoisseurs, and other bibliophiles wish to have it described.
(d) The Text can be further subdivided into front and back matter (a book's title page and its index, e.g.), heads and bodies. Unlike an HTML document, an XML document can have numerous heads, bodies, and divisions, so that, for instance, you could encode a whole book of short stories or anthology of poetry in one document.
Notice that, in contrast to HTML, here heads can be inside bodies (?! metaphorical collpase!).
This code would generate a table of contents for items in each division, and so would be perfect for anthologies, for instance.
Code for a group of documents not connected conceptually in any way.
Invoking the DTD in the prolog of a Document:
When you open a document in oXygen using "New from Template" and selecting TEI P4, here is the set of instructions for invoking DTDs that spring up automatically. The second line (first line in blue) invokes a set of rules that are housed on the TEI web site, the DTD file "tei2.dtd":
Let's first change the prolog, the "rules" portion of your document, depending upon your needs:
(a) The TEI Prose Entity should only be invoked if you are dealing with prose of some sort. If you are dealing with verse, delete the line outlined in red above and substitute for it:
<!ENTITY % TEI.verse 'INCLUDE' >
If you are dealing with drama, delete the line outlined in red above and substitute for it:
<!ENTITY % TEI.drama 'INCLUDE' >
-- for more on this issue, see 8, 9, and 10 of the TEI P4 manual
<!-- The following entities have been added by Laura Mandell on 17 July 2004 -->
<!-- The files 'urls.ent' and 'figures.ent' contain entity declarations -->
<!-- for all external entities needed by this document -->
<!NOTATION jpeg PUBLIC
'ISO DIS 10918//NOTATION JPEG Graphics Format//EN' >
<!NOTATION gif PUBLIC
'-//TEI//NOTATION
Compuserve Graphics Interchange Format//EN' >
<!NOTATION tiff PUBLIC
'-//TEI//NOTATION Aldus Tagged Image File Format//EN'>
<!NOTATION png PUBLIC
'-//TEI//NOTATION IETF RFC2083 Portable Network Graphics//EN'>
<!NOTATION HTML SYSTEM "text/html">
<!ENTITY % myFigures SYSTEM "figures.ent"> %myFigures;
<!ENTITY % urls SYSTEM "urls.ent"> %urls;
<!ATTLIST figure url CDATA #IMPLIED >
<!ATTLIST xref url CDATA #IMPLIED >(after these additions, there must appear a " ]>" without the quotation marks, as occurs after insert b in the picture above)
Where you see my name "Laura Mandell" and the date above, you can insert your own name and the date you are working on your document. Adding the date is a good idea as you may decide to modify your document prologs in the future, and you will want to know at a glance when looking at any document whether it is using your most updated set of instructions.
Adding this to the rules -- insert it in the place marked "b" in red above, before the "]>"-- will allow you to use gifs, tiffs, pngs, and jpegs, simultaneously requiring you to create a document that lists your images (NINES -- or really any publisher and/or library housing this document may require such lists so that these images can be properly maintained). It will also allow you to use external urls, again, simultaneously requiring you to keep a list of those urls in a separate document -- again, for the sake of future maintenance.s); and it will allow you to make links to other documents (generating "a href" in the HTML version).
-- for more information on images, see section 22.3 of the TEI P4 manual
-- for more information on external links, see 14.2.4 Representations of HTML links in TEI (under 14.2 Extended Pointers)Your document will now look something like this:
If you are ready, we will go on to the "TEI Header."
