Root Match Templates in ePublisher Designer
The root match template has a number of responsibilities in ePublisher Designer. They are listed here:
• Recording Files and Dependencies
• Loading Node Sets
• Progress recording for the extension object that lives in the wwprogress namespace
• Up-to-Date checking on the projects output files
• Writing output
Recording Files and Dependencies
All root match templates in ePublisher Designer XSL files begin and end with the <wwfiles:Files>
</wwfiles:Files>
elements. Within each root match template, usually near the bottom are one or more <wwfiles:Files>
elements which include one or more <wwfiles:Depends />
elements. The attributes in these elements provide information about the file such as the path, and type. Upon completion of a stage, the ePublisher Designer engine will write the location of the processed information in the files.info file for use by other stages attempting to complete their pipeline. Each stage may draw information from files.info and deposit information for use by another stage.
Loading Node Sets
Another responsibility of the ePublisher Designer XSL root match template is to load the node sets needed for the transformation. This is usually done by accessing one or more <wwfiles:Files />
elements from files.info, and using the path attribute on each <wwfiles:Files />
element together with the document()
or wwexsldoc:LoadXMLWithoutResolver
extension object, to load the node set for the transform. In most cases, the <wwfiles:Files />
elements are selected using an XSL parameter from the format.wwfmt file, or Stage in the current Pipeline.
wwprogress
The wwprogress
extension object sends messages to the ePublisher Designer progress indicator. If a root match template is being applied over several documents in several groups, then the number of documents or groups to be processed is recorded using the Start method in the wwprogress
namespace.
Notice that an operation registered with the wwprogress
extension object has concluded is initiated by using the End method.
Up-to-Date
The ePublisher Designer’s XSL file’s root match template also ensures whether files to be processed are up to date. This is accomplished by passing attributes accepted by the wwfilesext:UpToDate
extension method.
Writing Output
If a file is determined to be not up to date, then a XSL template is called, with the result then passed along with information regarding what type of output file is to be written, to the wwexsldoc:Document()
method for processing. If the output is to contain XML or HTML elements, then it is necessary to use the msxsl:node-set()
method to make the contents of the variable behave as a new XML fragment.
Last modified date: 08/16/2017