[Ann] Oxygen XML Suite Version 22.1 Release #Oxygen


Hi everyone, 


We released Oxygen XML Author/Editor version 22.1!


Listing below some new features which may be useful for our DITA users. 


DITA Authoring: 

*Automate Keys Definitions on Inserting Topic References 

*A new action available from the DITA Maps Manager toolbar allows you to create a new DITA map document by opening the New Document Wizard that assists you with the creation process. 


Other improvements: 

*Copy/Paste From Author Mode as HTML 

When you copy content from Author mode and paste it in HTML-aware tools (like email clients, office applications, Google Docs, etc.) Oxygen tries to preserve the overall styles such as links, lists, tables, bold, italic, underline, etc. 

*The Find/Replace in Files dialog box now has a new option (Always open selected results in Text mode): 

If unselected (the default state), double-clicking the resulted matches will open the documents in whatever editing mode is specified as the default for that document type. For example, DITA documents will open by default in Author mode. 

If selected, double-clicking the resulted matches will always open the documents in Text mode (even if the particular document type is set to open in Author mode by default). 

*A new option was added in the MathML preferences page where you can specify an external MathML application for editing MathML equations. For example, the following command could be used to edit MathML equations with a Libre Office application in Windows: "C:\Program Files\LibreOffice 5\program\smath.exe" "${cf}". 



*Oxygen Emmet Plugin Improvements 

The Emmet Plugin is now installed automatically the first time you invoke the Emmet action. To help make expanding the abbreviations easier, you can now use the Ctrl+Space keyboard shortcut. Also, the Wrap with Abbreviation action now displays an in-place field where you can type the abbreviation. 

*Improved Filtering Comment Mapping for Oxygen Feedback Plugin 

The Feedback Comments Manager view can filter comments by site, version, and status. This makes it easier for you to focus on particular comments (e.g. unresolved comments, or a particular version or site). The mapping of the comments to DITA topics was improved to support DITA-specific features such as branch filtering and chunking. 


CSS-Based DITA to PDF Publishing: 

*Improved Error Reporting 

When publishing to CSS-based PDF output, errors detected by the Chemistry processor are now reported in the Results panel along with the other DITA-related errors. The additional types of errors include font issues, text bleeding, and more. 

*A new parameter called "" can be used to control whether or not tracked changes and comments are shown as change bars in the PDF output.  

*Show Change Tracking Content as Sticky Note Annotations 

A new parameter called "" is available for controlling what information about tracked changes is presented as sticky note annotations. If it is set to yes, the content of insertion or deletion changes is shown in the annotation, while only the inserted and deleted labels are shown if the parameter is set to no. 

*Two new parameters were added for CSS-based PDF transformations that control how table titles are presented. The "table.title.placement" parameter can be used to control whether the title appears at the top or bottom of the table, and the "table.title.repeat" parameter can be used to specify whether or not the table caption should be repeated when the table spans on multiple pages. 

*The rendering of an SVG (which is basically an XML) can be customized with CSS. A new parameter called "use.css.for.embedded.svg" can be used to specify whether or not custom CSS is applied to embedded SVG elements in CSS-based PDF transformations. 

*break-word is now the default value of the overflow-wrap CSS property for <codeblock> elements. This will help prevent problems with content in code blocks bleeding off the page. 

*Better Support for Hyphenated and Wrapped Words on Search and Copy/Paste 

*Improved Handling of Change Bars 


For the complete list of features, see:


We hope you will enjoy Oxygen 22.1! 

As always, any feedback on it is welcomed. 




Alin Belu
Oxygen XML Editor

Chris Papademetrious

My favorite features in the 22.1 release:

  • Assigning the same Ctrl-` (backtick) keyboard shortcut to both Show Full Tags and Hide Tags now provides an easy way to toggle tag display on and off
  • Stepping through Find in Files search results in the Author view instead of the Text view
  • @keys values can be defined automatically for new topics (which is great because we're following Eliot Kimber's best-practice of always defining keys for our topics)
  • Ctrl-click to follow cross-references
  • Copying and pasting content from Oxygen into our email program with preserved formatting
  • "(Continued)" labels for tables spanning multiple pages
  • Support for the LibreOffice Math open-source MathML equation editor

Matt Lorenzi

I look forward to trying the new Tables parameter. This could be really helpful for some of our software docs with very long tables.