Appendice: Installation guide

Quick install on Linux

Requirements

Using Transmorpher requires several freely available software:
SoftwareBrandversionJar
Java VMSun JDK1.3
SAXOasis2.0sax2.jar
XML parserApache Xerces1.3xerces.jar
XSLT processorApache Xalan2.1xalan.jar
Regular expressionsgnu.regexp1.1.3gnu-regexp.jar
Servlet serverNone 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.

How to get Transmorpher

Downloading

The last development release is available from:
http://transmorpher.inrialpes.fr

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.

Installing

To install Transmorpher :

Distribution

The distribution tree contains:

README.TXT
A file similar to the present appendice
FILES.TXT
the list of all the files in the archive
LICENSE.TXT
the terms under which the software is licensed to you.
lib/
contains transmo.jar
dtd/
contains the Transmorpher DTDs
samples/
two example applications
refman/
reference manual in HTML
api/
javadoc API documentation in HTML
src/
Java sources of Transmorpher
classes/
empty directory for compiling the sources
resources/
.property files that sets default values for Transmorpher variables

Running Transmorpher

For running Transmorpher on a shell toplevel (Linux, dos...):

For instance, the bibliography example can be run with:
$ cd samples
$ java fr.fluxmedia.transmorpher.Application.transmorph biblio/process.xml

Applying the test suite (not available yet)

In order to apply the test suite, you will need junit and ant. Just go to the script directory and apply:

$ ant test

Compiling Transmorpher (not available yet)

In order to re-compile transmorpher you will need a Java compiler and ant. Just go to the script directory and apply:

$ ant compile
or, if you want to use this compiled code in a regular way:
$ ant jar

Have alook at the build.xml file for more option ot type:

$ ant usage

Bug reports

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 CLASPATH variable and whatever you think relevant to the problem.

A bug report form should come here prompty

Quick install on linux

$ 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-0-9-6.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


http://transmorpher.inrialpes.fr/refman/install.html

Feel free to comment to transmorpher-dev@fluxmedia.fr, Last modified: Wed Dec 12 15:49:37 CET 2001
$Id: install.html,v 1.8 2001/12/12 08:44:36 jerome Exp $