Creating HTML output using EpiDoc Standard XSL and Oxygen

Before you start:

• This document assumes that you have an 'epidoc' folder (as provided on the 'ss07' disc at the summer school) containing:
  • a folder 'xml' which holds the tei-epidoc.dtd and your XML files;
  • a folder 'html' which will contain your output HTML
  • a folder 'epidoc-xsl' which contains all of the Standard EpiDoc Stylesheets (as downloaded from SourceForge; this folder in turn contains: 'css', 'html', 'typographic', 'util')
• If you are using a different folder structure, you may need to change some of the values below.

Opening XML in Oxygen

• Open/create an xml file in Oxygen
• Ensure that the Doctype declaration at the top of your file reads:

  • <!DOCTYPE TEI.2 SYSTEM "tei-epidoc.dtd">

• (unless you are using a different folder structure with the EpiDoc DTD in a different folder from the XML, in which case you need to define the path to that folder as well as the DTD file name)
• Make sure that your XML file validates to the DTD by clicking on the 'validate' button ( ) on the toolbar.

Preparing your XML transformation scenario:

(You should only need to do this once in your Oxygen setup)

• Select 'Configure Transformation Scenario' button from the toolbar ( )
• Create a New scenario and give it the name 'Standard EpiDoc Stylesheets'
• XML URL: should read

  • ${currentFileURL}

• XSL URL: browse ( ) to the location of 'force-namespace-tei.xsl' (in epidoc-xsl/util folder)
• Parameters: add a new parameter:
  • Name: screencsspath
  • Value: ../epidoc-xsl/css/epidocscreen.css
  • Press OK
• Additional Stylesheets: add a new stylesheet; browse ( ) to the location of 'epidoc.xsl' (in epidoc-xsl/html folder). Press OK.
• Output: set the value of "Save as" to:

  • ../html/${cfn}.html

  • (this will automatically create an output file in the 'html' folder with the same name as your XML file but the suffix '.html')
• Press OK two more times to close the Transformation Scenarios box.

Transformation to HTML

• With your document open and at the foreground of Oxygen, press the 'Apply Transformation Scenario' button ( ).
• (If necessary, select "Standard EpiDoc Stylesheets" from the scenarios list.)
• If the transformation is successful, you will see the html version appear at the bottom of the screen. (The file will only transform if the XML validates to the DTD.)
• To see the html file in your web browser, open the ‘html’ folder. Select your new html and open it with Firefox, Explorer or whichever browser you use.