• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!



Page history last edited by PBworks 16 years, 10 months ago

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; this should only be necessary the first time you run this scenario.)
  • 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.

Comments (0)

You don't have permission to comment on this page.