Transforming the XML using jEdit
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.
- 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.)
- 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. )
- 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.
- 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.)
- 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.)
- Make sure your EpiDoc XML file is the active buffer (at the front of the jEdit windows)
- Click the 'xml + xsl =' button to run the process
- You will see the raw html in jEdit
- If a new file, manually save the output to the HTML folder on your computer
- Name the file
- Go to where the file is saved to open it in your web browser
Setting the CSS Parameter
At the moment the parameter function in jEdit does not seem to work correctly (as of version 4.2). The EpiDoc
stylesheets require one parameter to be set, which needs to be edited by hand in your local copy of the
stylesheets; this is the standalonecss parameter (which tells the output HTML where to find the CSS which
displays it correctly in the browser).
- Open epidoc-xsl\html\epidoc.xsl inside jEdit.
- Look for: <xsl:param name="standalonecss">
- Change the path to where 'epidocscreen.css' is kept on your computer. (If using a relative path [e.g.
"..\css\"] remember this relationship is between your output file and the CSS; this problem is avoided by
making the path absolute.)
Enabling XML and XSLT in jEdit
- Install the following plugins (either through 'Plugins Manager' or, if there are problems here, from http://plugins.jedit.org/):
- ErrorList (from 'Support')
- SideKick (from 'Support')
- XercesPlugin (from 'HTML and XML')
- XML (from 'HTML and XML')
- XmlIndenter (from 'HTML and XML')
- XSLT (from 'HTML and XML')
- If installing manually, unpack all zip files to '\program files\jEdit\jars' folder (or location of jEdit
on your system if not Windows).
- Set up XML functions on docked windows
- Go to 'Utilities' menu and select 'Global Settings'
- Under 'jEdit' select 'Docking'
- For XML Insert, we recommend changing 'Docking position' to 'left' (using dropdown menu)
- For both Error List and XSLT Processor we recommend change 'Docking Position' to 'Bottom'
- Click 'OK' to exit the window
- To activate any of these docked options, click on the button at the left or bottom of the window. Clicking
again hides the dock temporarily. You may need to resize the docks for convenience.
- Change default font:
- Go to 'Utilities' menu and select 'Global Settings'
- Under 'jEdit' select 'Text Area'
- Click on the box to the right of 'Text font:'
- Change the font to a Greek Unicode compliant font, e.g. Arial Unicode MS, Palatino Linotype,
Lucida Grande, New Athena Unicode, Cardo, etc.
- Click 'OK' to exit the window
Responsibility for this section
author
Zaneta Au
author
Gabriel Bodard
CVS Information
Revision number: $Revision: 1.2 $
Revision name (if any): $Name: r-5 $
Revision date: $Date: 2007/06/06 17:24:11 $
Revision committed by: $Author: gabrielbodard
$