Passing parameters to existing XSLT steps
Plug-ins can define new parameters to be passed from the
Ant build into existing XSLT pipeline stages, usually to have those
parameters available as global
<xsl:param> values
within XSLT overrides.
To create new parameters, create a file insertParameters.xml which
contains one or more Ant <param> elements. It
also needs a <dummy> wrapper element around the parameters. For
example, the following parameter will be passed in to the XSLT file
with a value of ${antProperty}, but only if that
parameter is defined:
<dummy>
<!-- Any Ant code allowed in xslt task is possible. Common example: -->
<param name="paramNameinXSLT" expression="${antProperty}" if="antProperty"/>
</dummy>
Pass the value using the following extensions:
dita.conductor.html.param- Pass parameters to HTML and HTML Help XSLT
dita.conductor.xhtml.param- Pass parameters to XHTML and Eclipse Help XSLT
dita.conductor.xhtml.toc.param- Pass parameters to XHTML TOC XSLT
dita.conductor.eclipse.toc.param- Pass parameters to Eclipse Help TOC XSLT
dita.preprocess.conref.param- Pass parameters to conref XSLT
dita.preprocess.mapref.param- Pass parameters to mapref XSLT
dita.preprocess.mappull.param- Pass parameters to mappull XSLT
dita.preprocess.maplink.param- Pass parameters to maplink XSLT
dita.preprocess.topicpull.param- Pass parameters to topicpull XSLT
dita.conductor.pdf2.param- Pass parameters to PDF2 XSLT
Example
The following plug-in will pass
the parameters defined inside of insertParameter.xml as
input to the XHTML process. Generally, an additional XSLT override
will make use of the parameter to do something new with the generated
content.
<plugin id="com.example.newparam"> <feature extension="dita.conductor.xhtml.param" file="insertParameters.xml"/> </plugin>