Using Transmorpher requires several freely available software:
Software | Brand | version | Jar | |
Java VM | Sun JDK | 1.3 | ||
SAX | Oasis | 2.0 | sax2.jar | |
XML parser | Apache Xerces | 1.3 | xerces.jar | |
XSLT processor | Apache Xalan | 2.1 | xalan.jar | |
Regular expressions | gnu.regexp | 1.1.3 | gnu-regexp.jar | |
Servlet server | None available yet |
The version associated with each Transmorpher version are documented at http://transmorpher.inrialpes.fr.
After downloadng Transmorpher, we advise yout to get all these software and to put their .jar file in your classpath.
An archive containing a set of consistent version of the required software working with the current version of Transmorpher can also be downloaded from these sites.
To install Transmorpher :
The distribution tree contains:
For running Transmorpher on a shell toplevel (Linux, dos...):
$ java fr.fluxmedia.transmorpher.Application.transmorph process.xml
$ java fr.fluxmedia.transmorpher.Application.transmorph -compile process.xml
$ java fr.fluxmedia.transmorpher.Application.transmorph -optimize process.xml > newprocess.xml
$ cd samples $ java fr.fluxmedia.transmorpher.Application.transmorph biblio/process.xml $
For compiling a Java file generated by transmorpher you need the transmo.jar and xalan.jar files (for JAXP). If your file is a Servlet, you will need the javax.servlet packages too.
For running the compiled files, you will need the same packages as for running Transmorpher.
In order to apply the test suite, you will need junit and ant. Just go to the script directory and apply:
$ ant test
In order to re-compile transmorpher you will need a Java compiler and ant. Just go to the script directory and apply:
$ ant compileor, if you want to use this compiled code in a regular way:
$ ant jar
Have a look at the build.xml file for more options or type:
$ ant usage
Send bug reports to transmorpher-dev@fluxmedia.fr.
Please, take care of providing the Transmorpher release number, the brand and version of each component above, the content of your CLASSPATH variable and whatever you think relevant to the problem.
A bug report form should show up here prompty
$ mkdir transmo-0-9-6 $ cd transmo-0-9-6 $ setenv TMDIR `pwd` $ wget -nd -q http://transmorpher.inrialpes.fr/distrib/releases/transmo-0-9-6.zip $ unzip transmo-0-9-6.zip $ cd lib $ wget -nd -q http://transmorpher.inrialpes.fr/distrib/releases/transmo-extra.zip $ unzip transmo-extra.zip $ cd .. $ setenv CLASSPATH ${TMDIR}/lib/sax2.jar:${TMDIR}/lib/xerces.jar:${TMDIR}/lib/xalan.jar:${TMDIR}/lib/gnu-regexp.jar:${TMDIR}/lib/transmo.jar:$CLASSPATH $ java -classpath ./resources:${CLASSPATH} fr.fluxmedia.transmorpher.Application.transmorph -v $ cd samples $ java -classpath ../resources:${CLASSPATH} fr.fluxmedia.transmorpher.Application.transmorph biblio/process.xml $ |
The resulting files have been generated in the biblio directory and they can be read by an HTML browser. They coresponds to the example in this manual.
Next chapter: DTD