This is a demonstration of advance file processing using Transbuild. The interesting part of this example is the chemistry section.
The basic model of Transbuild is one file in the source tree will correspond to one file generated in the target tree (other than files which are explicitly ignored). This example shows how to break this one-to-one model - proceed with caution! It shows how to use extensions to XSLT to perform one-to-many and many-to-one transformations.
To perform a one-to-many mapping, the Saxon output extension element will be used to generate multiple files from a single XSLT transformation. In this example, a single file containing the periodic table of elements is transformed into a master list index of elements HTML file and one HTML file is created for each element.
To perform a many-to-one mapping, the standard XPath document function is used to load data from other source files into a transformation.
The Saxon output extension element and the XPath document function are not unique to Transbuild. However, for them to work properly in the Transbuild environment, special Transbuild XPath functions must be used. These functions are used to identify the files and directories appropriately in the source tree and target tree. See the reference section of the manual for details.