WebHelp Responsive XSLT-import and XSLT-parameter extension points
XSLT extension points can be used from either from an Oxygen Publishing Template or from a DITA Open Toolkit extension plug-in.
Extension Points from an Oxygen Publishing Template
The publishing template allows you to specify one or more XSLT extension points. These extension points will affect only the transformations that use the particular template.
<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.
<plugin id="com.oxygenxml.webhelp.responsive.extension">
<feature extension="com.oxygenxml.webhelp.responsive.xsl.dita2webhelp"
file="xsl/fixup.xsl"/>
</plugin>
XSLT-Import Extension Points
The following extension points are available:
- 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
- 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\toc\tocDita.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:
- com.oxygenxml.webhelp.xsl.dita2webhelp.param
- Use this extension point to pass parameters to the stylesheet specified using the com.oxygenxml.webhelp.xsl.dita2webhelp extension point.
- com.oxygenxml.webhelp.xsl.createMainPage.param
- Use this extension point to pass parameters to the stylesheet specified using the com.oxygenxml.webhelp.xsl.createMainPage extension point.
- com.oxygenxml.webhelp.xsl.createNavLinks.param
- Use this extension point to pass parameters to the stylesheet specified using the com.oxygenxml.webhelp.xsl.createNavLinks extension point.
- com.oxygenxml.webhelp.xsl.createSearchPage.param
- Use this extension point to pass parameters to the stylesheet specified using the com.oxygenxml.webhelp.xsl.createSearchPage extension point.
- com.oxygenxml.webhelp.xsl.createIndextermsPage.param
- Use this extension point to pass parameters to the stylesheet specified using the com.oxygenxml.webhelp.xsl.createIndexTermsPage extension point.
- com.oxygenxml.webhelp.xsl.createTocXML.param
- Use this extension point to pass parameters to the stylesheet specified using the com.oxygenxml.webhelp.xsl.createTocXML extension point.