An Introduction to TEI:
by Laura Mandell, Miami Univ. of Ohio
TABLE OF CONTENTS FOR THIS INTRODUCTION
-- instructions for use with oXygen:
Getting Started with oXygen
Setting Up XSL / Customizing XSL-- instructions for use with or without oXygen:
Invoking the DTD in the Prolog of a TEI document
(suggested DTD additions explained)Coding the Text Itself
Coding Frontmatter
Insert Figures (Images)
Insert Footnotes and Links to Other Sites
Stanzas and ParagraphsGetting Started with oXygen
When you create a new document in oXygen, click on "File," then select "New From Template":
You should then select the document defined by TEI P4:
Now you will have a blank document that you can start filling with content:
(a) gives all the rules according to which your document will be adjudged valid, and oXygen will perform validations for you, if you click on the little check mark at the top (c);
(b) is the document itself;
(d) is the transform button that will allow you to make your XML-encoded document into a Web page using the proper XSL transformers.
Next step: setting up your XSL
It is crucial to be able to use transformers for web display of your documents.
Save your document before beginning this step so that your transformation scenario will have a name (by default, it will take the name of the document for which you originally set it up).
You will only have to set up your transformers ONCE; after that, every document will be transformed from XML/TEI into HTML simply by hitting the transform key. But let's do the set up -- click on the wrench icon:
In the "Configure Transformation Scenario" box, click on "New" and the "Edit Scenario" box will appear:
(a)While the "XSLT" tab is selected (which it is when the "Edit Scenario" pop-up first opens, by default), browse to your Oxygen 4.1 Folder -- usually in your Program Files (Windows users). Open oXygen 4.1, then TEI, then XSL, then HTML, then TEIHTML.XSL
(b) Next click on the "Output" tab:
Make certain to carefully select the file in which you wish your html pages to appear so that you know where to find them when you are finished transforming.
Click "OK," and "OK" after making certain to select (click on) the name of the "transformation scenario" you have just created (it will be the name of the document you are currently working on, by default). You only have to select that transformation scenario for all other documents you create.
Here (attached, or click) is more detailed information about customizing XSL files, just to get you up and running.
If you have oXygen up and running and your transformation scenario up, you are ready to go on to the next step, more detailed coding of a document.
