Oxygen XML Forum

Posted: **Mon Jul 18, 2022 11:32 pm**

WebHelp topic pages have a "right tools" group that contains various topic-related tools (collapse, previous/next topic, print, etc.):

image.png

I would like to add my own tool to this group in a WebHelp publishing template, and I would like to use an HTML fragment so I can use macro evaluation. So, I created an XSLT file that calls <whc:include_html> with a specific @href path:

Code: Select all

<!-- evaluate our own fragment placeholder at the end -->
<xsl:variable name="my-tool-placeholder">
  <whc:include_html href="../html-fragments/my-tool.xhtml"/>
</xsl:variable>
<xsl:apply-templates select="$my-tool-placeholder" mode="copy_template"/>

but the @href path is interpreted as HTML content to insert directly:

image.png

But if I define and use my own (nonstandard) fragment parameter:

Code: Select all

<!-- evaluate our own fragment placeholder at the end -->
<xsl:variable name="my-tool-placeholder">
  <whc:include_html href="{'${webhelp.fragment.my.tool}'}"/>
</xsl:variable>
<xsl:apply-templates select="$my-tool-placeholder" mode="copy_template"/>

then it works as desired.

Is there a trick to directly specifying a fragment filename with the @href attribute of a <whc:include> element? Or is this unsupported and fragments must be specified through the fragment parameter framework? I can use the nonstandard parameter approach, but if a simpler solution exists, I should use it.

A testcase is included:

webhelp_specific_fragment_file.zip

To run,

1. Publish all deliverables in "project.xml".
2. Explore the WebHelp results in out/good/ (which uses a parameter) and out/bad/ (which uses a specified file path).

Posted: **Tue Jul 26, 2022 5:13 pm**

Hi Chris,

Actually this is possible to insert the fragment by referring it directly, you just need to give an additional parameter to the called template, like this:

Code: Select all

<!-- evaluate our own fragment placeholder at the end -->
<xsl:variable name="my-tool-placeholder">
  <whc:include_html href="html-fragments/my-tool.xhtml"/>
</xsl:variable>
<xsl:variable name="webhelp-template-base-uri">
  <xsl:value-of select="concat('file:/', replace(oxygen:getParameter('webhelp.publishing.template'), '\\', '/'), '/')"/>
</xsl:variable>
<xsl:apply-templates select="$my-tool-placeholder" mode="copy_template">
  <xsl:with-param name ="template_base_uri" select="$webhelp-template-base-uri" tunnel="yes"/>
</xsl:apply-templates>

If you take a look at com.oxygenxml.webhelp.responsive\xsl\template\commonComponentsExpander.xsl you will see that the template for whc:include_html needs the template_base_uri param (<xsl:param name="template_base_uri" tunnel="yes"/>).
The only thing to do is to get the 'webhelp.publishing.template' transformation parameter, convert it as an URI and send it to the template.
Once the base uri is resolved the href can correctly be expanded, just make sure to change the href value: it must be relative to the template folder!

Regards,
Julien

Oxygen XML Forum

Can I include specific HTML fragment files in XSLT templates?

Can I include specific HTML fragment files in XSLT templates?

Re: Can I include specific HTML fragment files in XSLT templates?