XSLT extension points can be used from either from an Oxygen Publishing Template
or from a DITA-OT extension plug-in.
Extension Points from an Oxygen Publishing Template
The publishing template allows you to specify an XSLT extension point. The extension point
will only affect the transformations that use the particular template.
Important: While the publishing templates only support referencing one extension point at a time,
you can use xslt:include or xslt:import to aggregate
multiple modules.
For a specific example of how to use an extension in a publishing
template, see: How to Use XSLT Extension Points from a Publishing Template.
Example:<publishing-template>
...
<webhelp>
...
<xslt>
<extension
id="com.oxygenxml.webhelp.xsl.createMainPage"
file="xsl/customMainPage.xsl"/>
</xslt>
Extension Points from a DITA-OT Extension Plug-in
The DITA-OT plug-in installer adds an XSLT import statement in the default WebHelp XSLT so
that the XSLT stylesheet referenced by the extension point becomes part of the normal build.
You can use these extension points to override XSLT processing steps.
Example:<plugin id="com.oxygenxml.webhelp.responsive.extension">
<feature extension="com.oxygenxml.webhelp.xsl.dita2webhelp"
file="xsl/fixup.xsl"/>
</plugin>
XSLT-Import Extension Points
The following extension points are supported:
- com.oxygenxml.webhelp.xsl.dita2webhelp
- Extension point to override the XSLT stylesheet
(dita2webhelp.xsl) that produces an HTML file for each DITA
topic. The location of this file is DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\dita2webhelp\dita2webhelp.xsl
- com.oxygenxml.webhelp.xsl.createMainPage
- Extension point to override the XSLT stylesheet
(createMainPage.xsl) that produces the WebHelp Responsive main
HTML page (index.html). The location of this file is
DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\mainFiles\createMainPage.xsl
- com.oxygenxml.webhelp.xsl.createNavLinks
- Extension point to override the XSLT stylesheets that are used to generate
navigation links in the WebHelp Responsive pages. These stylesheets can be found in
the navLinks folder: DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\navLinks\
- com.oxygenxml.webhelp.xsl.createSearchPage
- Extension point to override the XSLT stylesheet
(createSearchPage.xsl) that produces the WebHelp Responsive
search HTML page (search.html). The location of this file is
DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\mainFiles\createSearchPage.xsl
- com.oxygenxml.webhelp.xsl.createIndexTermsPage
- Extension point to override the XSLT stylesheet
(createIndextermsPage.xsl) that produces the WebHelp Responsive
index terms HTML page (indexterms.html). The location of this
file is DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\mainFiles\createIndextermsPage.xsl
- com.oxygenxml.webhelp.xsl.createTocXML
- Extension point to override the XSLT stylesheet (tocDita.xsl)
that produces the toc.xml file. This file contains information
extracted from the DITA map and
it is mainly used to construct the WebHelp Table of Contents and navigational links.
The path to this stylesheet is: DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\navLinks\tocDita.xsl.
- com.oxygenxml.webhelp.xsl.contextHelpMap
- Extension point to override the XSLT stylesheet
(contextHelpMapDita.xsl) that generates the context sensitive
help mapping. The path to this stylesheet is: DITA-OT-DIR\plugins\com.oxygenxml.webhelp.responsive\xsl\contextHelp\contextHelpMapDita.xsl.
XSLT-Parameter Extension Points
If your customization stylesheet declares one or more XSLT parameters and you want to
control their values from the transformation scenario, you can use one of the following XSLT
parameter extension points: