Transforming the XML using jEdit

xml version || id: jeditwithxslt|| setting the css parameter | enabling xml and xslt in jedit | responsibility for this section | cvs information || post a comment

Release or development version: r-5

Instructions to use the EpiDoc XSLT stylesheets to render and view your own XML files. These notes apply to jEdit 4.2; older versions may exhibit minor differences in behaviour. (To enable XML and XSLT handling in jEdit, see the final section below.)

There are some bugs in jEdit performance: we have documented work-arounds to three of these serious problems below.

1. Open the XML file in jEdit. If the XSLT Processor is not already open, click on the 'XSLT Processor' tab (we recommend docking this tab at the bottom of the window but some may prefer to open a 'floating' window.)
2. Select stylesheets to apply:
   • Click on the '+' button to the right of the 'Stylesheet' box
   • Find '\epidoc-xsl\util\force-namespace-tei.xsl' on your computer
   • Click on 'Open' to select the file
   • Repeat to add '\epidoc-xsl\html\epidoc.xsl'
   • (Ensure that 'force-namespace-tei.xsl' is above 'epidoc.xsl'. If it comes below, click on one of the files, and move them into the correct order using the directional arrows to the lower right of the box.)
   • (You can remove stylesheets from the list by selecting the filename and clicking on the '-' button, which is below the '+' button. )
3. The 'Parameter' function in the jEdit XSLT processor does not appear to work as of version 4.2. For the workaround, see 'Setting the CSS parameter' below.
4. Under 'Source XML' on the right of the XSLT panel, select 'Current buffer'. (Running the file from disc can cause problems with Greek Unicode output.)
5. Under 'Result', enter the path and name for the output file
   • The first time you transform a given XML file, the output HTML will open in a new buffer and you should manually save it (see 8. below)
   • On future saves you can click the button on the right to find the path and select the file from the HTML folder on your computer
   • (It is this location you need to be aware of when 'Setting the CSS parameter' below.)
6. Make sure your EpiDoc XML file is the active buffer (at the front of the jEdit windows)
7. Click the 'xml + xsl =' button to run the process
   • You will see the raw html in jEdit
8. If a new file, manually save the output to the HTML folder on your computer
   • Name the file
9. Go to where the file is saved to open it in your web browser