Installation Instructions
- Install Sun's JDK-1.2 or Sun's JRE-1.2.
- Install Version 1.1.16 or 2.0.6 of IBM's XML for Java
- Unzip Lotus XSL Processor to your hard drive (Assuming
you haven't already.)
- Either have XML4J on the system class path, or copy the XML4J jar into
the LotusXSL directory. I recommend having it on the system class path. To
install XML4J and LotusXSL onto the system class path, do something like:
set CLASSPATH=c:\lotusxsl\js.jar;c:\xml4j_1_1_16\xml4j_1_1_16.jar;c:\lotusxsl\LotusXSL.jar
in your autoexec.bat.
To test, you can go into the 'testSuite\xml4j1tx' directory and
type 'test accp accp01'. You should see it process the files with no complaints. If it does, you may have to
adjust the command name or classpath setup in the batch file.
In the LotusXSL root directory there is a 'run' batch file, which
you pass command line parameters. These instructions are to use 1.1.16 of XML4J.
To use XML4J 2.0.6 you'll need to change the batch files to call
com.lotus.xsl.xml4j2dom.XML4JLiaison4dom or com.lotus.xsl.xml4j2tx.XML4JLiaison,
depending on if you want to use the new DOM classes or the
TX compatibility classes.
The command line utility is com.lotus.xsl.xml4j.ProcessXSL.
It can take the following command line switches:
-IN inputXMLURL
-XSL XSLTransformationURL
-OUT outputFileName
-PARSER fully qualified class name of parser liaison
-E (Do not expand entity refs)
-V (Version info)
-QC (Quiet Pattern Conflicts Warnings)
-Q (Quiet Mode)
-LF (Use linefeeds only on output {default is CR/LF})
-CR (Use carriage returns only on output {default is CR/LF})
-ESCAPE (Which characters to escape {default is <>&\"\'\\r\\n}
-INDENT (Control how many spaces to indent {default is 0})
-TT (Trace the templates as they are being called.)
-TS (Trace each select.)
-TTC (Trace the template children as they are being processed.)
-VALIDATE (Set whether validation occurs. Validation is off by default.)
-EDUMP (Do stackdump on error.)
-XML (Use XML formatter and add XML header.)
-TEXT (Use simple Text formatter.)
-HTML (Use HTML formatter.)
-PARAM name expression (Set a stylesheet parameter)
There are now UNIX Bourne shell script files:
-
run.sh
-
run processor (with 1.1.16 version of XML4J)
in the form of:
run -in foo.xml -xsl foo.xsl -out foo.out
-
testSuite/xml4j1tx/test.sh
-
Test LotusXSL with XML4J 1.1.16.
-
testSuite/xml4j2dom/test.sh
-
Test LotusXSL with XML4J 2.0.6 Generic DOM.
-
testSuite/xml4j2tx/test.sh
-
Test LotusXSL with XML4J 2.0.6 TX compatibility classes.
You may have to edit these in order
to have the correct path to the XML4J jars. There are, of course, corresponding
.bat files.