• 2025

    26.1
    Version 26.1 - March 25, 2024
  • 2024

    26.0
    Version 26.0 - October 11, 2023
  • 25.1
    Version 25.1 - March 16, 2023
  • 2023

    25.0
    Version 25.0 - October 13, 2022
  • 24.1
    Version 24.1 - March 7, 2022
  • 2022

    24.0
    Version 24.1 - March 7, 2022
    Version 24.0 - October 18, 2021
  • 23.1
    Version 23.1 - March 4, 2021
  • 2021

    23.0
    Version 23.1 - March 4, 2021
    Version 23.0 - November 19, 2020
  • 22.1
    Version 22.1 - May 19, 2020

What's New in Oxygen Publishing Engine 25.1

March 16, 2023

Related version: 25.0    

Oxygen Publishing Engine version 25.1 encompasses the improvements and additions implemented in Oxygen XML WebHelp and Oxygen PDF Chemistry. This latest release offers a variety of new customization possibilities, transformation parameters, component updates, and bug fixes for both WebHelp and PDF publishers.

There are changes in:

WebHelp Output

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.

PDF Output

Display Line Numbers in Code Blocks

It is now possible to display line numbers in code blocks by setting the @outputclass attribute on the <codeblock> elements to the show-line-numbers value. For more details, see How to Add Line Numbering in Code Blocks.

Display Whitespace Characters in Code Blocks

For CSS-based PDF transformations, it is now possible to display a visual representation of whitespace characters in code blocks. You can do this by setting the @outputclass attribute on the <codeblock> elements to the show-whitespace value. For more details, see How to Display Whitespaces in Code Blocks.

Control the Behavior of Footnotes

A new transformation parameter (args.css.param.clone-referenced-footnotes) is available to control the behavior of footnotes. When set to yes, footnotes that are referenced multiple times throughout a publication are cloned and placed at the bottom of the page for each occurrence. Otherwise, only the first footnote reference is placed at the bottom of the page and subsequent references point back to the original footnote.

Component Updates

Apache FOP 2.8

Updated the Apache FOP library to version 2.8.

DITA OT 3.7.4

The bundled DITA Open Toolkit version was updated to version 3.7.4.

Eclipse Adoptium Temurin 17

The OpenJDK JRE that is bundled with the Oxygen Chemistry processor (OpenJDK Temurin 17.0.5) is created using jlink from the Eclipse Adoptium Temurin distribution.

Java 17

The installation kit now comes bundled with Java 17. The All Platforms kit works with both Java 1.8 and Java 17. However, support for Java 1.8 is deprecated and we plan to remove it in a future version.