What's New in Oxygen XML Webhelp 25.1

March 16, 2023

Related version: 25.0    

Oxygen XML WebHelp version 25.1 is a minor release for the modern XML publishing system that is used to produce stylish WebHelp output from DITA or DocBook source content.

This release added a new parameter for excluding topic IDs from context-sensitive help, a new parameter to disable the generation of index terms, a new extension point to help you fine-tune the XSLT transformation that generates the mapping for context-sensitive help, and the JQuery library that comes bundled with WebHelp is now accessible in the browser's global context enabling developers to use it. This release also includes various bug fixes and security enhancements.

Core

Exclude Topic IDs from Context-Sensitive Help

Oxygen WebHelp's context-sensitive help relies on a mapping between an ID and the path of the HTML output page. The value of this ID is computed from the resourceid element or from the topicid element (as a fallback if the resourceid is missing). A new parameter (webhelp.csh.disable.topicID.fallback) allows you to change this behavior and instruct the WebHelp transformation to only use the value found in the resourceid element.

Fine-Tune Context-Sensitive Help Mapping

The new extension point com.oxygenxml.webhelp.xsl.contextHelpMap allows you to add custom XSLT code to modify the XSLT transformation that generates the mapping between an ID and the path of an HTML output page used for context sensitive help.

Disable Index Terms

The webhelp.show.indexterms.link parameter can be used to disable the generation of index terms. If set to false, index terms are not generated and the index terms page is not available in the output.

JQuery Library Available in Global Context

The JQuery library that comes bundled with WebHelp is now accessible in the browser's global context so that developers have access to use it.