2 Usage

2.1 Installing xtpxlib components

To install an xtpxlib component, first go to its documentation home page to find details about where it is on GitHub and the Git URI you need for cloning it:

Then do one of the following:

• Clone its GitHub repository to some appropriate location on disk. The master branch will always contain the latest stable version.

• Or download the latest release zip from its git website (releases page) and unpack it somewhere.

That's all folks…

2.2 Running xtpxlib components

xtpxlib consists of XSLT (2.0 and 3.0) stylesheets and XProc (1.0 and 3.0) pipelines. To run these you'll need:

• XSLT:

  To run XSLT stylesheets, the Saxon processor is preferred. In most cases the (open source) HE (Home Edition) version will be sufficient.

  As an alternative, run the software from within the oXygen XML IDE.

• XProc 3.0:

  To run the XProc 3.0 pipelines, use the MorganaXProc-III processor. For some of the more advanced pipelines (mainly the ones in xtpxlib-xdoc) you need the EE version, for which a license is required.

• XProc 1.0:

  WARNING: XProc 1.0 support is considered deprecated and will be removed in the near future!

  To run the XProc 1.0 pipelines, use the XML Calabash Xproc 1.0 processor. The xtpxlib library uses several of its non-standard extensions, another XProc processor is therefore not (directly) usable.

  As an alternative, run the software from within the oXygen XML IDE.