An Introduction to TEI:
by Laura Mandell, Miami Univ. of Ohio
Help Customizing Your XSL
Customizing your XSL files is an art, but if you want to be able to use your XML files for web pages right away, until you hire someone to do stylesheet management, contact oXygen for help, or
- Submit a form to me, and I will send you an XSLT
- Follow these simple instructions to create your own XSL files
1. Form
Elements in the form are marked A, B, and C, to show you where they will appear on your Web page (used when not self-evident)
(see the images of two possible page types, I. and II., below).Page Type I: in this document, info. from the tei Header is used on the page --
Page Type II: In this document, information from the <front> of the text itself is used --
1. Instructions
Either download your zipped XSL files from the TEI website, unzip them, then open the document called TEICOMMON.XSL (using Notepad or some simple text-editing program)*
or you can open the TEICOMMON.XSL document in oXygen: click File, Open (top left-hand corner), then in the file-locator box that appears, go to your XSL files in oXygen 4.1:
Find oXygen 4.1 in Program Files, then open TEI, then XSL, then HTML, then TEICOMMON.XSL
Whether in Notepad or oXygen, s croll down to where the XSL style sheet begins, and you should see the following:
Change the "baseURL" from Oxford University's URL to that of your own university. A. The institution and/or Web site is the name that you would like to have appear at the top of every page which you transform using this particular XSL. C. "HomeURL" and "homeWords" are the URL and abbreviated title for the main Web site and/or Institutional site page of which your documents are part; these words and this link will appear at the bottom, toward the left-hand side of the page (see C above in the two types of pages pictured above) . B. If that site (c) is a subsidiary site, then the "parentURL" and "parentWords" will be the words and the link appearing in the bottom left-hand corner of each document. Change the "searchURL" to a URL for your search engine; if you do not have one, rewrite the line: <xsl:param name="searchURL"/> [a slash now appears before the closing bracket and everything else has been dropped from the line.] Change "feedbackWords" to whatever you wish: "Questions," "Comments," etc.
If you don't want numbers inserted automatically for items (poems, e.g., or stories) that are part of a larger text, nor for figures, tables, and other headings, I would go to <!-- numbering --> (pictured above), and change "numberFigures," "numberTables," and "numberHeadings," from "true" after the angle bracket to "false" (no quotation marks).
Save and close the TEICOMMON.XSL
We only have three more things to do:
- change the "feedbackURL" to either your email address or a URL, if you have a form on line;
- change your copyright declaration;
- and change the picture for the logo from Oxford University to a picture of your choice. It could be a picture of your University, your library, or something distinguishing your site. I have a
at my site. Pick something that is approximately 100 pixels by 100 pixels.
Open TEIHTML-PARAM.XSL (if you downloaded your TEI files yourself, go up one level, then select HTML) (if you are using oXygen 4.1, the file will appear in your current folder):
After "logoPicture," change the href to the URL for the directory of your site containing your picture file, then change the image source ("src") to the file name for your logo picture, specifying the width and height for that picture. Change the alt tag to the name of your site. Change the "feedbackURL" to your own email address: mailto:[insert your email address here]. Now change the "copyrightStatement" to read what you would like to have it say; include as many words as you wish. Save and then transform your document using your new stylesheets. They will now look like this at the top and the bottom:
You can see my logo appearing above, instead of Oxford's; "Anna Barbauld's Prose Works" are my "homeWords."
"Women Poets" = parentWords and the URL for that site (to which these words are linked) is the parentURL.
"Anna Barbauld's Prose Works" = homeWords and the URL for that site (to which these words are linked) is the homeURL.
The date down here comes from whatever date appears in the editionStmt (under filedescrip in the teiHeader).
*Finding Guide: go into your unzipped TEIXSL-HTML folder, then into the file called COMMON; then you will see the document TEICOMMON.XSL. Notice the difference between zipped and unzipped folders:
