Skip to content

tooling

Jump to bottom
Christian Lück edited this page Feb 23, 2026 · 1 revision

title: Tooling

Tooling

The project uses a fully reproducible Tooling environment for installing a current version of Saxon HE and other tools required for running X-technology specific tasks. The Tooling is based on Apache Maven, but only requires a installed Java JDK.

After cloning the project, running the following command, you will get a current Saxon HE (home edition), wrapper scripts and a configuration files for this Saxon edition.

./mvnw package

After a successful build there is:

  1. a current Saxon HE and dependencies in target/lib/*
  2. wrapper scripts for running XSLT in target/bin/*
  3. saxon.he.xml and saxon.he.html.xml: Saxon configuration files for the Home Edition, derived from saxon.xml

Using all the packages is now as simple as running

target/bin/xslt.sh -config:saxon.he.xml -xsl:STYLESHEET -:s:SOURCE PARAMETER=VALUE

For example:

target/bin/xslt.sh -config:saxon.he.html.xml -xsl:xsl/html/prose.xsl -s:test/samples/Trawr-Gesang2.xml use-libhtml=true {http://scdh.wwu.de/transform/source#}mode=6

The commandline parameters are just passed through to the Saxon processor. Run target/bin/xslt.sh -? for help or have a look at the Saxon documentation.

The wrapper scripts have debugging turned on by default. Use Saxons -o:... option or the shell's 1> and 2> redirection to fork output from stdout and stderr.

Alternatively, you can go the hard way and not let Maven help you and use -lib to point to every package you want to use:

java -jar path-to-saxon.jar -lib:xsl/common/libentry2.xsl -lib:xsl/common/libapp2.xsl -lib:xsl/html/libapp2.xsl -lib:... -xsl:... -s:...

Clone this wiki locally