Oxygen Publishing Engine V24.0

WebHelp Output

• Publication TOC Synchronized with Current Topic - The viewport for the publication table of contents has been improved to bring the currently selected topic into the visible area by automatically scrolling it into position, making navigation easier.
• Collapse/Expand Buttons Added to the Topic and Publication TOC - The topic TOC (the table of contents that is displayed on the right side of the topic page) and the publication TOC (contains links to all the topic pages and is displayed on the left side of the topic page) now contain collapse/expand buttons.
• Control the Placement of Titles for Tables and Figures - New transformation parameters can now be used to control whether the titles of tables or figures appear at the top or bottom of the component.
• Expand the Top Menu When Clicking or Hovering Over a Menu Item - A new transformation parameter has been added for controlling the behavior of the top menu. When activated (set to yes), clicking an item in the top menu will expand the submenu (if available). You can then click on a submenu item to open the item (topic). You can also click outside the menu or press ESC to hide the menu.
• Compliance with HTML5 Validation Rules - The WebHelp Responsive output has been updated to comply with HTML5 validation rules.
• Deprecated Feedback PHP Mechanism Replaced with the New Commenting Platform - The deprecated Feedback PHP version from WebHelp DITA and DocBook distributions is no longer supported. To install a commenting component on WebHelp pages, use the subscription-based Oxygen Feedback commenting platform.
• Smoother Menu Transitions - The transition from one menu item to another is now much smoother by having the delaying time increased for the menu to be hidden once the mouse cursor exits its boundaries.
• Exact Highlights Following a Phrase Search - When using phrase search functionality and opening a resulting link, the matching phrase is now highlighted in browser instead of the composing words separately.
• Component Update:
  • The DITA Open Toolkit version bundled with Oxygen WebHelp Responsive has been updated to version 3.6.1.

PDF Output

• Control the Security of the Publishing Processing - Added the ability to control the security context of the publishing processing through Java security policy files. The Oxygen Publishing Engine requires two security policy files (ope.policy and chemistry.policy) since it uses two processes.
• Control Copyright Metadata - Three new CSS properties have been added to provide the ability to control the copyright information in the PDF output.
• Custom Metadata Fields - You can now use the -oxy-pdf-meta-custom property to define custom metadata fields and it now supports multiple values.
• Control How the PDF Reader Presents the Document - A new set of CSS properties can now be used to control how the PDF Reader (e.g. Adobe Acrobat Reader) presents the PDF document. You can now specify the zoom level, whether or not the toolbar and menu are visible, which side panel should be visible by default, the page sequence presentation (one page or scrolled), and more.
• Generate PDF in Compliance with PDF/UA Standards - Support has been added for the pdf.accessibility DITA parameter when generating CSS-based PDF output. If this parameter is set to yes, the PDF output will be generated in compliance with the PDF/Universal Accessibility standard (also known as ISO 14289).
• Protect PDF Files with Security Permissions - You can now restrict the permissions for people using your PDF files by using some new command-line parameters. For example, you can use the -pdf-security-restrict-print parameter to restrict users from printing the PDF content or the -pdf-security-restrict-copy parameter to restrict users from copying the PDF content.
• Support Added for the 'visibility' CSS Property - The visibility CSS property is now applied during the PDF transformation (previously, the property was applied in the editor, but had no effect in the transformation). You can use visibility: hidden to hide something, such as the title for a block element.
• Change the Default Resolution for Images - The image.resolution transformation parameter can be used to change the default resolution of images. It mainly works on vector images (e.g. PDF, SVG) since raster images have their resolution defined in their metadata.
• Show Only Change Bars for Tracked Changes in PDF Output - Added the ability to only display the change bars for tracked changes in PDF output while hiding the other styling for the inserted or deleted content. This is helpful if you want to see the document in a final version while still seeing change bars where content was inserted or deleted. This can be done for both XSL-FO PDF transformations or CSS-based PDF transformations.
• Publishing Template Improvements - If the args-css parameter is set in a DITA to PDF transformation based on HTML5 and CSS, the corresponding publishing template is exported as a zip file, the value of the args-css parameter is now automatically converted to a CSS resource in the publishing template's descriptor file.
• Border Styling Improvements - More support has been added for styling borders. You can now try various combinations of CSS rules that apply to certain aspects of borders, such as the border style (solid or dotted lines) or the transparency of the border colors.
• Rotate Table Cells - For CSS-based PDF output, you now have the ability to rotate table cell content by using the transform CSS property.
• Component Update:
  • Updated the Apache FOP used by the Chemistry processor to version 2.6.

Zendesk

• Publish and Upload Articles to Zendesk - A new xhtml-zendesk transformation type is now supported and it allows you to publish DITA topics to XHTML output and upload them directly as articles to the Zendesk Help Center.

Other

• Dynamically Convert Non-DITA Resources to DITA During Publishing - Added the ability to dynamically convert various types of non-DITA resources to DITA during the publishing process. This support is enabled for a particular resource referenced in a DITA map by specifying the type of conversion using the @format attribute on the particular <topicref> element.

Component Updates

• The DITA Open Toolkit version bundled with the Oxygen Publishing Engine has been updated to version 3.6.1.
• Updated the Apache FOP used by the Oxygen Publishing Engine to version 2.6.
• Updated the Apache Commons Compress library to version 1.21.
• Updated the ICU4j library used by the Oxygen Publishing Engine to version 69.1.