What's New in Oxygen Publishing Engine 26.1

March 25, 2024

Oxygen Publishing Engine version 26.1 adds basic float support, automatic fixes for incorrect values for width or height properties, and new CSS properties are available for configuring the PDF output. Additionally, the Zendesk Help Center transformation scenario now automatically creates and publishes a table of contents and supports publishing to a subsection. Furthermore, several performance improvements, component updates, and bug fixes were implemented.

PDF Output

Basic Float Support

Oxygen PDF Chemistry now has basic support for floating images. This makes it possible to wrap text around an embedded image.

Incorrect Letters in Width/Height Values for Images are Automatically Fixed

For CSS-based PDF transformations, if an image has values for the width or height that contains uppercase letters (which causes the image to be missing in the output), the incorrect value is automatically fixed and a warning message is displayed so that you can also fix the problem in the source file.

Configure Scale for PDF Output

A new CSS property (-oxy-scale) can be used to specify a scale factor (on both the x and y axis) for the PDF output. If only one number is provided, it is used for both the x and y scales. A scale factor smaller than 1 shrinks the page. A scale factor greater than 1 enlarges the page.

Configure Crop Box Style

A new CSS property (-oxy-crop-box) can be used to choose the type of cropping for the page box rectangle that surrounds the area where the content is displayed. The possible values are: trim-box, bleed-box, and media-box.

Configure Crop Box Offset

A new CSS property (-oxy-crop-offset) can be used to specify an extended area outside the page box rectangle (default page size) that contains the PDF output content. Up to four values can be set (separated by spaces): top, right, bottom, and left.

Add Crop and Registration Marks

The marks CSS property property can be used to add crop and/or registration marks to the PDF document. They are printed outside the page box to facilitate the trimming and alignment of sheets of paper. The possible values are: none, crop (adds short lines outside the page box), and cross (adds cross-shaped registration marks outside the edge of the page box).

Zendesk

Zendesk Transformation Automatically Creates Table of Contents

The Zendesk Help Center transformation scenario now automatically creates and publishes a table of contents as the first article in the target section and this initial article hierarchically references all other articles. The title of the table of contents article is the title of the DITA map. A new parameter (zendesk.create.toc) can be set to false if you do not want a table of contents published. Also, new optional parameters (zendesk.toc.title.prefix and zendesk.toc.title.suffix) can be set to specify a prefix or suffix to use for the title of the table of contents article.

Component Updates

DITA-OT 4.1.2

Updated the bundled DITA Open Toolkit to version 4.1.2.

Apache POI 5.2.5

Updated the Apache POI libraries used for various conversions from MS Excel to version 5.2.5.

Apache Commons IO 2.15.0

Updated the Apache Commons IO utilities library to version 2.15.0.

Zendesk Access 0.24.1

Updated the zendesk-java-client library used for publishing DITA XML content to Zendesk to version 0.24.1.