• 2002

    Version 1.0 - April the 15th, 2002
    Version 1.1 - May the 15th, 2002
    Version 1.1.5 - May the 20th, 2002
    Version 1.1.6 - May the 24th, 2002
    Version 1.1.7 - May the 27th, 2002
    Version 1.1.8 - June the 5th, 2002
    Version 1.1.9 - June the 15th, 2002
    Version 1.2 - June the 27th, 2002
    Version 1.2.1 - September the 27th, 2002
    Version 1.2.2 - October the 22nd, 2002
    Version 1.2.3 - November the 27th, 2002
    Version 1.2.4 - December the 17th, 2002
  • 2003

    Version 2.0 - April the 2nd, 2003
    Version 2.0.1 - May the 15th, 2003
    Version 2.0.2 - June the 9th, 2003
    Version 2.0.3 - August the 14th, 2003
    Version 2.0.4 - September the 19th, 2003
  • 2004

    Version 3.0 - January the 14th, 2004
    Version 3.1 - February the 6th, 2004
    Version 4.0 - April the 30th, 2004
    Version 4.1 - June the 10th, 2004
    Version 4.2 - July the 15th, 2004
    Version 5.0 - October the 15th, 2004
    Version 5.1 - January the 18th, 2005
  • 2005

    Version 6.0 - May the 22nd, 2005
    Version 6.1 - July the 19th, 2005
    Version 6.2 - September the 19th, 2005
  • 2006

    Version 7.0 - January the 13th, 2006
    Version 7.1 - March the 2nd, 2006
    Version 7.2 - June the 6th, 2006
    Version 8.0 - November 20th, 2006
    Version 8.1 - January 25th, 2007
    Version 8.2 - May 7th, 2007
  • 2007

    Version 9.0 - November 2nd, 2007
    Version 9.1 - December 18, 2007
    Version 9.2 - May 9, 2008
    Version 9.3 - July 2, 2008
  • 2008

    Version 10.0 - October 23, 2008
  • 2009

    Version 11.0 - October 9, 2009
  • 2010

    Version 12.0 - September 14, 2010
  • 2011

    Version 13.0 - August 29th, 2011
  • 2012

    Version 14.0 - June 27, 2012
    Version 14.1 - October 19, 2012
    Version 14.2 - February 13, 2013
  • 2013

    Version 15.0 - June 7, 2013
    Version 15.1 - October 7, 2013
    Version 15.2 - January 22, 2014
  • 2014

    Version 16.0 - May 20, 2014
    Version 16.1 - October 7, 2014
  • 2015

    Version 17.0 - May 5th, 2015
    Version 17.1 - October 20, 2015
  • 2016

    Version 18.0 - April 21, 2016
    Version 18.1 - October 18, 2016

What's New in oXygen XML Editor 17.0

Related Versions: 17.017.1

Version: 17.0

May 5th, 2015

oXygen XML Editor version 17 sets the highest standard for XML development and XML authoring. It comes with important functionality updates and focuses on design to make your work not only productive, but also enjoyable.

Retina/HiDPI icons make everything look crisp and beautiful, while the graphite color theme gives you a complete new view of oXygen. Toolbars are configurable down to action level and they put you in full control of your work environment.

oXygen XML Editor not only reports errors, it also helps you automatically correct them through the Quick Fix and AutoCorrect support. The new XML Refactoring tool extends the power of the Find/Replace action across multiple files by applying XML-aware operations through a user-friendly interface.

DITA topics have a spectacular new look and guided DITA authoring eliminates training by presenting inline hints and actions. Now you can publish DITA to an improved and faster-loading WebHelp format and experiment PDF transformations reusing the same CSS files used for authoring. You can also switch between different DITA-OT versions and easily integrate new transformation types.

Improved CSS support includes a new CSS Inspector view, LESS editing, and automatic conversion to CSS when saving. Building eye-catching XML authoring interfaces can now be achieved by taking advantage of the new CSS support.

The oXygen SDK contains many new API updates and the Web-based XML authoring SDK now provides new extension points to facilitate integration, as well as an adaptive user interface that is both mobile and desktop-friendly.

oXygen version 17 includes new frameworks for supporting JATS, ISO StratML, and XLIFF. The DITA and TEI frameworks have been updated, as well as the SVN client and many of the bundled processors, including Saxon and XML Calabash.

There are changes in:

XML Quick Fixes

Schematron Quick Fixes

Schematron allows you to enforce business rules on XML documents and to communicate issues in a language the users understand, as the error messages are written by the schema developer rather than being generated by the validation engine. Similar to how a spell checking engine shows possible correct words that should replace a misspelled word, the schema developer can provide one or more possible actions that fix the reported problem. oXygen presents these actions through the Quick Fix support, allowing users to correct an issue by selecting one of the proposed solutions.

XML Quick Fixes when Validating Against Relax NG Schemas

The Quick Fix support was updated to provide actions for correcting various errors that appear in XML documents validated against Relax NG XML or Compact schemas, such as adding missing attributes, removing invalid elements, and more.

XML Refactoring

XML Refactoring Tool

The XML Refactoring tool assists you with various refactoring tasks that cannot be resolved with a traditional Find/Replace operation. It helps you manage the structure of your XML documents and it includes a variety of operations, such as renaming, deleting, and inserting elements and attributes across a set of files. It is available in the Tools menu, the Project and DITA Maps Manager contextual menu.

Custom XML Refactoring Operations

For more complex projects, if the provided refactoring operations are not sufficient, oXygen Enterprise edition users can create their own custom refactoring operations and share them with other team members.

User Interface

Customizable Toolbars

The toolbars in oXygen can now be customized at action level and you can decide the exact set of actions that are presented by each toolbar. Some of the toolbars have also been reorganized to better group related actions.

Graphite Color Theme

If you prefer dark backgrounds, you can use the new graphite color theme or use it as a starting point for setting your preferred colors. You can select it from the Theme drop-down menu found in the Appearance preferences page.
Graphite Color Theme

Improved HiDPI and Retina Support

oXygen now has a set of new icons that are more visually appealing, crisp, and specially tuned for HiDPI and Retina displays.
Improved HiDPI and Retina Support

Visual XML Editing

AutoCorrect Misspelled Words

oXygen includes a new AutoCorrect feature to automatically correct misspelled words, as you type, in the Author visual editing mode. You can take advantage of this functionality to easily insert symbols by automatically converting a sequence of characters to a symbol. For example, (R) can be corrected to ®.
AutoCorrect Misspelled Words

HiDPI and Retina Support

You can use HiDPI/Retina icons while styling your documents in the Author mode with CSS by using simple naming conventions.

Change the Tag Display Font

A new setting allows you to customize the font used for rendering tag markers in the Author visual editing mode.

Actions to Insert Multiple Rows or Columns

Two new actions allow you to insert multiple rows or columns in DITA, Docbook, TEI, and XHTML tables.

Bold, Italic, and Underline Actions Support Multiple Selections

You can now use bold, italic, and underline actions on multiple non-contiguous selections when editing documents in Author mode and the action will be applied to each selected range.

Better Support for Editing Saxon Configuration Files

oXygen now provides better support for editing Saxon configuration files in Author mode.

DITA Support

Improved Rendering of DITA Topics

A lot of effort was put into making the DITA topics more readable while editing in Author mode. You have the freedom to choose from a multitude of editing styles.

Improved Rendering of DITA Topics

Layered Styling

The Styles drop-down list, available from the toolbar, allows you to select one main CSS to style the document and combine it with multiple alternate CSS styles that behave like layers, thus making it very easy for you to choose the desired rendering of a document while providing a huge number of view options.

Guided DITA Authoring

Taking advantage of the layered styling support, the Styles drop-down list now includes two layers that help to guide authors while editing DITA topics. The Hints layer can be selected to display inline information for many DITA elements, advising you how that element should be used or what information you should enter within that element. Another layer, named Inline actions, allows you to discover what markup can be inserted, and where, by placing inline actions to insert an element exactly where that element will appear in the document.

Support for DITA OT 2.0

The DITA OT version 1.8.5 comes bundled with oXygen. However, you can download and use the latest DITA OT version 2.0 for publishing in oXygen simply by pointing to its installation folder. Also, the oXygen WebHelp Plugin is DITA OT 2.0-ready.

DITA Map PDF WYSIWYG Transformation Scenario [Experimental]

A premiere in DITA authoring, a new transformation scenario is now available, allowing you to transform DITA maps to a PDF file that is very similar to what you see in the Author visual editing mode. You can easily change the aspect of the PDF by simply changing the selection from the Styles drop-down list, available on the toolbar. This scenario is experimental and requires the Prince XML processor (not included).
DITA Map PDF WISIWYG Transformation Scenario

Improved Image Insertion

The Insert Image Reference action in DITA documents presents a dialog box that allows you to select an image to insert and to configure various properties for the image.

Find Unreferenced Resources in DITA Projects

Sometimes topics and images become unreferenced in your DITA maps. The Find Unreferenced Resources action, available in the contextual menu of the DITA Maps Manager view, allows you to find these orphaned resources.
Find Unreferenced Resources in DITA Projects

Automatic Validation Reports Missing Topics and Images

While editing DITA topics, references to missing topics or images are reported as errors and highlighted in the editor.

Check for Duplicate Topic IDs in a DITA Map

An option has been added for the Validate and check for completeness action from the DITA Maps Manager view that allows you to find duplicate topic IDs in a DITA map.

Auto-Detect Transformation Types and Parameters for Newly Installed DITA OT Plugins

oXygen now detects new transformation types from installed DITA OT plugins and presents descriptions for them in the DITA Transformation Type dialog box. The contributed parameters from the DITA OT plugins are also included in the Parameters tab in the Edit DITA Scenario dialog box.

Improved DITA Map Metrics Reporting

The DITA Map Metrics report was updated to handle key references and it also presents a summary of all external links.

Publish DITA to Web Slides

oXygen provides a new DITA transformation type called Web Slides for creating web presentations. It can be selected when creating a new DITA OT transformation scenario for your DITA Map. You need to make sure you set the attribute @chunk with the value to-content on your DITA Map root element before giving it a try.

This transformation is based on Reveal JS, which allows you to transform DITA maps into web presentation slides using the Reveal JS framework.


Optimization for Loading WebHelp Pages

Index terms are now only loaded when needed in WebHelp pages to help speed up the loading process for the initial page.

WebHelp Output Embeddable in an iframe Element

You can now embed WebHelp output into an HTML iframe element, if for example, you want to make it part of a more complex site layout.

WebHelp Context-Sensitive Help System

The WebHelp transformation generates an XML file with mappings from help IDs to documentation content pages. This file can be used by an application to implement a context-sensitive help system. See the documentation for more information.

WebHelp Feedback System Supports LDAP Authentication

If you are using a domain (such as OpenLDAP or Active Directory) to manage users in your organization, an option has been added that allows you to select which users can access the WebHelp system and who will have administrator privileges.

Search Engine Optimization for WebHelp Output

You can set up a DITA WebHelp transformation scenario to produce a sitemap.xml file that is used by search engines to aid in web crawling and indexing mechanisms.

WebHelp System Supports Right-to-Left (RTL) Languages

The WebHelp system now supports right-to-left language for DITA Map transformation scenarios. Languages that are supported include Arabic, Hebrew, and Urdu.

Indexing Japanese Content in WebHelp Pages

Japanese content in WebHelp pages may be indexed with a morphological Japanese indexer, for the purpose of improving the search results. See the documentation regarding the installation of the Japanese indexer.


CSS Inspector View

oXygen now includes a CSS Inspector view that displays information about the styles applied to the currently selected element in the Author mode. You can use this view to examine the structure of the CSS rules that match the element, and use a link that is displayed for each rule to open the associated CSS source for editing.

Support for Editing LESS Stylesheets

oXygen now provides support for editing LESS stylesheets. LESS extends the functionality of the CSS language by adding features that allow mechanisms such as variables, nesting, mixins, operators, and functions. It is also possible to compile the LESS stylesheets to CSS when saving.

Along with CSS, you can use LESS stylesheets directly to style documents in Author mode. They can be referenced from the Document Type Association or using the xml-stylesheet processing instruction in the XML document.

Support for Selecting/Combining Multiple CSS Styles in Author Mode

The Styles drop-down list, available on the oXygen Author toolbar, now allows you to select one main CSS to style the document and combine it with multiple alternate CSS styles that behave like layers. This makes it easy to change the look of the document and add multiple styles to it. This behavior can be enabled in the Document Type configuration and by default is only active for DITA documents.
Support for Selecting/Combining Multiple CSS Styles in Author

CSS Properties

oXygen now provides better support for the following CSS properties:
  • letter-spacing CSS Property

    The standalone versions of oXygen now support the letter-spacing CSS property.

  • ::before(n) and ::after(n) Pseudo Elements

    Multiple ::before(n) and ::after(n) pseudo-elements can be used to insert content before or after the content of an element (or other pseudo-element).

  • min-height CSS Property

    You can use this property to impose a minimum height to the element box. The min-height property only supports absolute values.

  • position CSS Property

    The supported values include fixed, absolute, and relative for the elements displayed as blocks, and relative for the elements displayed as inlines.

  • Font Fallback Mechanism of the font-family CSS Property

    You can specify a list of fonts to be used for rendering the content of an element. The first font from the list that can render that specific character will be used.

CSS @media Rule Properties

You can specify different styles depending on the operating system,oXygen distribution, and the size of the visible area in Author mode. For instance, you can use:

@media oxygen AND (min-width:25cm) AND (platform:standalone) AND(os:windows){...}

to apply specific CSS rules to the oXygen standalone distribution running on Windows when the editor area width is at least 25 cm.

Form Control for Displaying HTML Content

The new oxy_htmlContent built-in form control can be used to render HTML content, such as descriptions for various sections of a document.

Define Custom Actions in CSS

You can define actions for button and button group form controls directly in the CSS, rather than defining them in the Document Type Association configuration (framework).

oxy_url Expands Editor Variables

Editor variables can now be passed as parameters for the oxy_url function. For instance, you can use:


to render an image stored in the images subdirectory of the framework.

XQuery / XPath

Formatting and Indenting XQuery Documents

XQuery files (version 1.0, 3.0 and XQuery Update 1.0) can be properly pretty printed, producing neater and consistent formatted content.
Formatting and Indenting XQuery Documents

Formatting and Indenting Embedded XPath Expressions

When formatting XSLT, XSD, and Schematron documents, the values of the attributes that accept XPath expressions are properly pretty printed.


A detailed list of all changes to the Java API can be found here.

Updated WebApp SDK

The Web-based XML authoring SDK, which uses HTML5 and JavaScript on the client side, was updated to provide an adaptive user interface that is both desktop-friendly and mobile-friendly. Custom actions are made available in a toolbar and there are many API extension points that facilitate repository integration. Find more about the oXygen XML Web Author and try it online at http://www.oxygenxml.com/xml_web_author.html.

fileFilter Property for the URLChooser Form Control

The fileFilter property allows you to set file filters to a URLChooser form control. This allow you to control which file types are available in a file chooser dialog box.

Intercept List of Actions Provided by a Callout

Added the ro.sync.ecss.extensions.api.callouts.AuthorCalloutsController.addCalloutActionsProvider(CalloutActionsProvider) API method, which allows developers to intercept a list of actions presented when double-clicking a callout in the Author editing mode and to modify it.

Tree Component for Consistent Look and Feel

Added a custom JTree extension API ro.sync.exml.workspace.api.standalone.ui.Tree, which allows you to create trees in your custom views that look identical to the ones used in other places inside oXygen.

Customize Author Menu [Eclipse]

The new ActionBarContributorCustomizer.customizeAuthorPageExtensionMenu() extension point API allows you to customize the Author extension menu from an Eclipse plugin.

Customize Text/Author Contextual Menus [Eclipse]

The ActionBarContributorCustomizer.customizeTextPopUpMenu() extension point API can now be used for customizing the contextual menu in Text mode, while the ActionBarContributorCustomizer.customizeAuthorPopUpMenu() method can be used for customizing the contextual menu in Author mode.

Customize the Toolbars in the DITA Maps Manager [Eclipse]

The extension point API methods ActionBarContributorCustomizer.customizeDITAMapsManagerMainToolbar() and ActionBarContributorCustomizer.customizeDITAMapsManagerExtendedToolbar() can be used by an Eclipse plugin to customize the main and extended toolbars in the DITA Maps Manager.

Add Custom Browse Actions to Input Dialog Boxes [Eclipse]

The InputURLChooserCustomizer API now allows you to customize or add browse actions to also input dialog boxes (such as the Browse for local file action in the DITA Maps Manager) for the oXygen Eclipse Plugin.

API for Customizing the Author Toolbar [Eclipse]

The ActionBarContributorCustomizer.customizeAuthorPageExtensionToolbar() extension point API can be used to filter the Author extension toolbar from an Eclipse plugin.

API for Providing Editor Adapters [Eclipse]

The EditorAdapterContributor extension point API allows you to provide custom Eclipse editor adapters.

Plugin Extension to Specify Location of Custom Refactoring Operations

The new com.oxygenxml.editor.XMLRefactoringContributor plugin extension allows you to specify one or more directories from which to load custom XML Refactoring operation resources.

Styles Filter Extension Point [Eclipse]

The stylesFilterContributor extension point allows you to set a StylesFilter API implementation from an Eclipse Plugin.

ExtensionsBundle Extension Point [Eclipse]

The extensionsBundleContributor extension point allows you to register an implementation of the ExtensionsBundle API class from an Eclipse Plugin.

Provide Text for a DITA Link [Eclipse]

The LinkTextResolverCustomizer extension point API for the Eclipse plugin can be implemented to provide custom text representations for DITA links.

Expand/Collapse Foldable Elements in Author Mode

The WSAuthorEditorPageBase.getAuthorFoldManager() API allows you to create actions to expand or collapse folded elements in Author mode.

Customize Drop-Down Buttons on a Toolbar [Eclipse]

You can cast oXygen Eclipse actions to com.oxygenxml.editor.editors.IDropDownMenuAction in order to customize drop-down buttons on a toolbar from an Eclipse plugin.

Easier Way to Provide Documentation for Elements

Provide additional annotations for elements in your XML vocabulary without the need to write Java extensions with the help of a custom configuration file.

Filter Errors Presented to the End-User

The API ro.sync.document.DocumentPositionedInfo.getErrorKey() method allows developers to filter errors that are presented to the end users based on the error key.

Choose the Custom CSS to be Included in the Styles Drop-down List

The ro.sync.exml.workspace.api.PluginWorkspace.addAuthorCSSAlternativesCustomizer() API allows you to propose a custom list of CSS to be included in the Styles drop-down list.

Support for Composite Toolbars

The ro.sync.exml.ComponentsValidator.validateToolbarComposite() method allows or filters composite toolbars, such as a drop-down list.

API to Find Tracked Attribute Changes

The ro.sync.ecss.extensions.api.AuthorChangeTrackingController.getAttributeChangeHighlights() API allows you to obtain tracked attribute changes.

Obtain a Reader Object of a URL

The ro.sync.exml.workspace.api.util.UtilAccess.createReader(URL, String) API returns a Reader object over a given URL. The content of the Reader is analyzed in order to find the correct encoding. If no encoding can be detected, then the default one (given as the second parameter of the method) is used instead.

Operation to Run JavaScript Received as a Parameter

An operation was added (JSOperation) that allows you to call the Java API from custom JavaScript content.

Support for Retina/HiDPI Icons

oXygen automatically uses @2x icons for Retina displays (Mac with Retina or Windows with HiDPI 200%). This applies to all icons referenced from the framework files or paths to the icons provided through the ro.sync.ecss.extensions.dita.DITANodeRendererCustomizer API . There is no need to change the code for this support, just drop in the high DPI icons.

Allow Third-Party to Control Drop in DITA Maps Manager

The ro.sync.exml.workspace.api.editor.page.ditamap.WSDITAMapEditorPage.addDropHandler(DITAMapTreeDropHandler) API has been added that allows a third-party application to control drop operations in the DITA Maps Manager tree.


Updated SVN Client

The SVN Client tool includes a variety of improvements and bug fixes. The Create Patch operation was completely reworked and the Merge wizard now includes a pre-merge validation check. Also, various other operations received numerous improvements and their list of options were updated.

Online Help Option

A feature has been added to open the help system documentation online. This gives you access to the latest updates to the help documentation and allows you to send feedback through the WebHelp feedback system. If the Use online help option is enabled, pressing F1 while hovering over any part of the interface or selecting Help from the Help menu results in oXygen attempting to open the online help documentation. Otherwise, the local help documentation is opened in offline mode.
Online Help Option

Controlled Values

You can use a configuration file to provide values for elements and attributes for a specific document type. The possible values can be either set in the configuration file or they can be the result of invoking an XSLT script that will produce those values dynamically, possibly by accessing external resources or web services.

Dynamic Content Conversion

oXygen provides special support for a convert protocol that can be used to chain predefined processors to import content from various sources dynamically. See the documentation for more details.

Ready for MarkLogic 8

oXygen has been updated to work with MarkLogic 8.

Automatic Escaping of Characters Outside Encoding Range

When saving a document edited in the Author mode, all characters that cannot be represented using the document encoding will be automatically converted to hexadecimal character entities.

Option to Lock Local Resources

A new option has been added in Preferences to Lock local resources. When this option is enabled and you open a file from the local file system or a shared network drive, oXygen locks the file for the current user and the file cannot be modified by other users while the lock exists.

Support for JATS Documents

A default JATS framework is included in oXygen that allows you to create new JATS documents from templates, and includes support for validation, content completion, copy/paste actions from external content, and converting documents to JATS.

Support for ISO StratML Documents

A default StratML framework is included in oXygen that allows you to create new ISO StratML documents from templates, validate and edit such documents as well as publish them as HTML or convert from StratML to ISO StratML. The visual authoring interface for ISO StratML includes support for hints and inline actions that can be enabled by selecting the corresponding style layers from the Styles drop-down.

Support for XLIFF 1.2 and 2.0 Documents

The XML Localization Interchange File Format (XLIFF) is a standard for passing data between tools during a localization process. The XLIFF support includes new document templates, validation, content completion, and CSS support and is available for XLIFF 1.2 and 2.0 document types.

Ignore Whitespaces in the "Find/Replace in Files" Operation

The Ignore extra whitespaces available in the Find/Replace in Files dialog box enables the search process to deal with multiple consecutive whitespaces as being a single space character. For instance, searching for a phrase like "better product" in documents containing the "better [newline] product", will find a match.
Ignore Whitespaces in Find/Replace in Files Operation

Compare Files Tool Includes Support for XML Fragment Comparison

You can use the Compare Files tool to compare XML fragments, without selecting files, by copying and pasting the fragments into both sides of the tool. Various XML diff algorithms are supported for XML fragments, and comparison and merging actions are available from the toolbar or contextual menu.

Define Shortcut Keys for Code Templates

When a code template is created or edited, a shortcut key can be defined for quickly inserting it into a document.

Deprecated Support for Documentum CMS

Support for Documentum CMS has been deprecated and the integration will not be actively maintained.

Component Updates

Apache HTTP Client 4.3.5

The Apache HTTP Client libraries have been updated to version 4.3.5.

Calabash 1.1.0

The bundled Calabash XProc engine has been updated to version 1.1.0.

eXist DB 2.2

Support for the eXist XML database has been updated to version 2.2.

JSch 0.1.51

The Java Secure Channel (JSch) library used by SFTP connections was updated to version 0.1.51.

Eclipse 4.5

Support for Eclipse has been updated to include version 4.5.


The Saxon engine has been updated to version

TEI Schema 2.8.0

Support for TEI schema was updated to version 2.8.0.

TEI XSL 7.34.0

Support for TEI XSL was updated to version 7.34.0.

Version: 17.1

October 20, 2015

oXygen XML Editor version 17.1 includes updates and improvements to make your XML authoring and developing experience even more productive and effective. The performance of many of the integral components has been optimized and numerous features were enhanced and fine-tuned to make oXygen XML Editor even more powerful, dynamic, and easy to use. It also features a spectacular new visual design that makes everything look crisp and beautiful.

Various DITA-related operations and dialog boxes have been reorganized and improved to maximize efficiency and convenience. You can also now enable experimental editing and publishing support for DITA 1.3, including new file templates, scoped keys, and branch filtering.

oXygen XML Editor extends support for resolving errors and managing the structure of your documents through powerful actions. Support for XML Quick Fixes was expanded and their performance improved, while XML Refactoring actions were enhanced to make them more accessible and powerful.

The oXygen WebHelp system was also improved to enhance your published output. Google Search, Google Analytics, and some popular social media widgets can now be integrated into your WebHelp system and search features are now available in offline mode.

Improved CSS support includes optimized performance and the ability to use several properties that were previously not supported. Support for some level 4 pseudo-classes was also added, as well as support for allowing negative values in certain properties.

The oXygen SDK contains many new API updates and the Web-based component provides new extension points to facilitate various integrations. The WebApp has received numerous enhancements to allow you to customize many of its features, as well as an easy-to-use interface that makes it easy to configure your instance of the component.

There are changes in:

User Interface

New Color Themes and User-defined Themes

New Light and Ultramarine color themes have been added in addition to the existing Classic and Graphite ones. Light is now the default theme for Windows and you can select the desired theme from the Theme drop-down menu found in the Appearance preferences page. You can also use the themes as a starting point for setting your own preferred colors and define your own color themes that you can share with your colleagues.
New Color Themes

Breadcrumb Navigation in Text Mode

A breadcrumb navigation bar is now available at the top of the Text editing mode that presents the hierarchy of elements (from the document root to the currently selected element). It can be used as a helpful tool to navigate to specific ancestor elements and also to understand your location in the document structure.
Breadcrumb in Text Mode

DITA 1.3 Support

While some DITA 1.3 functionality was available in oXygen for more than one year, version 17.1 is a major milestone because we added support for the core DITA 1.3 features (such as key scopes and branch filtering, as well as many others). Thus, oXygen now has the most comprehensive DITA 1.3 support of any tool on the market.

Create and Edit DITA 1.3 Documents

You can create, edit, and validate DITA 1.3 maps and topics.

Scoped Keys Support

You can establish key scopes and insert references to keys inside or outside key scopes. oXygen will also takes key scopes into account when it validates and checks for completeness, resolves key and content key references, and publishes.

Branch Filtering Support

The DITA 1.3 branch filtering mechanism makes it possible to reuse the content of topics multiple times within the same map, each time using different filters.

DITA Support

Improved User Experience for Reusing Content

While there are multiple ways of reusing content in DITA, oXygen provides now a unified interface that allows you to specify what you want to reuse.

Unified Action for Managing Topic References

Multiple actions were combined into a single operation to make them more efficient. The dialog box for inserting topic references in DITA maps was revamped and reorganized to include various tabs so that you can configure numerous aspects of the references in one place.

Improvements to the DITA Map to PDF WYSIWYG Experimental Transformation Scenario

The experimental DITA Map to PDF WYSIWIG transformation scenario allows you to transform DITA maps to a PDF file that is very similar to what you see in the Author visual editing mode. Now the colored highlights set during the review process are presented in the PDF output.

Publish DITA to Microsoft Office Word Format

If you choose to use the bundled DITA Open Toolkit 2.x distribution, you will be able to publish your DITA content to Microsoft Word OOXML format using this new experimental transformation. The support is based on a plugin contributed by Jarno Elovirta.

Indicator to Show All the DITA Map References to the Current Topic

When an opened DITA topic is referenced more than once in the map that is currently opened in the DITA Maps Manager view, an indicator will appear in the top right-hand corner of the Author mode editor that shows the number of times the topic is referenced in the map. It includes navigation arrows that allow you to jump to the next or previous reference. This is especially important for DITA 1.3 where the point in the map may change the editing context for a topic, for example if different key scopes are used.

Automatically Contribute New File Templates from a DITA OT plugin

If you integrate a new DITA-OT plugin in the main DITA Open Toolkit distribution used by oXygen and your plugin contains a folder named template_folders, all file resources found in the sub-folders will be automatically contributed as new file templates.

Experimental Lightweight DITA Support

If you choose to use the bundled DITA OT 2.x as the main DITA Open Toolkit installation, you will be able to create and edit Lightweight DITA topics and maps.

XML Quick Fixes

Support for Schematron Quick Fixes in Other Documents

Support has been added for the Schematron Quick Fixes to be executed on documents other than the current one. You can apply quick fixes for example on content referenced using XInclude or external entities.

Support for User Entries in Schematron Quick Fixes

The Schematron Quick Fixes now support the <sqf:user-entry> element. It allows you to ask the user to specify values that will be used when the quick fix is applied.

Improved Performance for Schematron Quick Fixes

The performance for Schematron Quick Fixes has been improved so that the operations are generated and executed faster. The XML validation against Schematron also now performs faster when quick fixes are defined.

Quick Fixes Presented in a Tooltip Window

Proposals for quick fixes to solve validation errors or warnings are now displayed in a tooltip popup window. When hovering over an error or warning, if a quick fix is available for that particular problem, the proposals are presented in a tooltip, along with more details about the error, and you can easily select an available quick fix from this tooltip window. In Author mode, an in-place quick fix drop-down menu is also displayed when hovering over an error or warning. The drop-down menu presents a list of available quick fixes to select from.
Quick Fixes Presented in a Tooltip Window

XML Refactoring

Define Refactoring Actions Using XSLT

If the predefined XML refactoring operations are not sufficient to help you accomplish a particular task, you can create a custom operation that is specific to your needs. You can now use XSLT stylesheets as an alternative to XQuery Update scripts to define custom operations.

XML Refactoring Actions Available in the Contextual Menu

The XML Refactoring actions were added in the contextual menu to make them more accessible. Furthermore, they are invoked according to the current context within the editor, making them easier to use. For instance, if you invoke the Rename Element action, the name of the element is pre-configured in the dialog box that appears.
XML Refactoring

New Parameter Types to Identify Attributes and Elements

Two additional parameter types were added that allow you to match elements and attributes more easily by using the power of XPath expressions.


Google Search and Social Media Widgets Can Be Integrated into WebHelp Output

You can now integrate a Google Custom Search Engine into your WebHelp output. You can also integrate Google Analytics and some popular social media widgets into your WebHelp output.

Offline Search

You no longer need to be online to access oXygen WebHelp search features. You can now perform searches in your WebHelp system even when you are in offline mode.

Logical Searches

The oXygen WebHelp system now supports logical searches that use the following operators: OR, AND, and NOT. When there are two adjacent search terms without an operator, OR is used as the default search operator.


Along with performance improvements the oXygen CSS rendering engine supports new properties such as outline and text-indent, new pseudo-classes such as focus-within and has as well as negative margins and indents.

Optimized CSS Performance

The performance of CSS stylesheets in oXygen has been optimized. For example, you can now move multiple selections in a large table instantaneously. The performance has also been improved for DITA CSS stylesheets that use pseudo-classes (such as :hover or :focus), and when opening very large documents or opening maps in the editor (particularly maps that have topic contents expanded in-place).

Improvements to the oxy_xpath Function

When computing the styles for an element inside a reference (XInclude or DITA conref), the CSS oxy_xpath function will have access to the actual content inside the references.

Support for the :focus-within CSS Level 4 Pseudo-Class

Added support for the :focus-within CSS level 4 pseudo-class selector that allows you to style ancestors of elements that contain the current focus.

Support for the :has CSS Level 4 Pseudo-Class

Added support for the :has CSS level 4 pseudo-class selector that takes a relative selector as an argument and then evaluates its existence. It can match an element by taking its child elements into account.

Support for the text-indent CSS Property

Added support for the text-indent CSS property that can be used to create hanging indents. oXygen also supports negative values when using this property.

Support for the 'outline' CSS Property

Added support for the 'outline' CSS property that allows you to create outlines around visual objects (such as buttons, active form fields, image maps, etc.) to make them stand out.

Support for Negative Margins and Indents

Added support in CSS that now allows negative margins and indents for block and inline boxes.


Support for XPath/XSLT 3.0 in Schematron Schemas

Schematron schemas now provide support for XSLT 3.0. You can define the version directly in the Schematron document using the queryBinding attribute or by using an option in the Schematron preferences page.

Support for XML Schema 1.1 Validation from within NVDL Scripts

You can now validate an XML document with an NVDL schema that contains an XML Schema 1.1 validation step. To enable XML Schema 1.1 validation in NVDL, you need to pass some validation options to the validation engine..

oXygen WebApp Component

New Administration Page

A new Administration Page has been added to provide a GUI that allows you to configure the oXygen WebApp Component. It allows you to easily configure your license server connection, add/configure plugins, and add frameworks.

GitHub Integration Plugin

The oXygen SDK includes a plugin that allows you to use the oXygen WebApp Component to edit files stored in a public or private GitHub repository.
WebApp Component

Browsing Widget for WebDAV Servers

The oXygen WebApp Component now includes a browsing widget for WebDAV servers that can be used for inserting images.

Support for Editing MathML Equations

The oXygen WebApp Component now supports editing and rendering MathML equations. You can click on the equation to open an editing dialog box and you can also edit the XML source of the equation.

Support for Rendering SVG Images in the WebApp

The oXygen WebApp Component now supports rendering embedded or referenced SVG images in XML content.

WebApp Component API

Dynamically Enable/Disable Actions on the Toolbar

The refreshActionsStatus(ids) method has been added that allows you to dynamically enable or disable action on the toolbar in the oXygen WebApp Component.


A detailed list of all changes to the Java API can be found here.

Add a Drag and Drop Listener to Author Mode

The WSAuthorEditorPageBase.addDNDListener(...) API method allow you to add a drag and drop listener in Author mode from a plugin.

Advanced Custom Rule Matcher

The DocumentTypeAdvancedCustomRuleMatcher API class can be used as a specific document type association rule. The API has to access the content of an entire document to determine if the document type association can be used for the current XML document.

API to Customize Callouts

The CalloutsRenderingInformationProvider.handlesAlsoDefaultHighlights() method allows you to customize the way sidebar callouts look for insertions, deletions, and comments.

AuthorStylesheet Plugin Extension Type

The AuthorStylesheet plugin extension type allows you to contribute stylesheets (CSS or LESS) as extra layers for rendering elements in Author mode.

Change the Tag Display Mode

The WSAuthorEditorPageBase.getTagsDisplayMode() and WSAuthorEditorPageBase.setTagsDisplayMode(int) APIs were added that allow you to get or change the display mode for tags in Author mode.

Customize Actions in the Review Panel

The AuthorReviewController.getAuthorReviewViewController() API was added that allows you to customize the actions or rendering of the Review panel in Author mode.

Customize Highlights in Author Mode

The Highlight.setAdditionalData(String key, Object additionalData) and Highlight.getAdditionalData(String key) API methods allow you to add or get custom data for a specific key. That key can be Highlight#HOVER_ACTIONS_PROVIDER_ADDITIONAL_DATA, in which case the value must be ro.sync.ecss.extensions.api.highlights.HighlightActionsProvider (a new class that can be used to display a widget when hovering over a highlight, from which the provided actions can be performed).

Escape/Unescape Attribute Values

The new API methods XMLUtilAccess.escapeAttributeValue() and XMLUtilAccess.unescapeAttributeValue() allows you to escape content so that it can be used as an attribute value or unescape it back to its original form.

Execute XQuery Update Scripts on Content in Author Mode

Added the XMLUtilAccess.createXQueryUpdateTransformer(Source,URL[]) and AuthorSource APIs that allow you to execute an XQuery Update script over content in Author mode.

JavaScript-based Workspace Access Plugin Extension

A new Javascript implementation of the WorkspaceAccessPluginExtension type of plugin was added. This plugin provides support for customizing menus, toolbars, and views, as well as for making modifications to opened documents and adding listeners for various events.

Open a Specific Preferences Page

The new ro.sync.exml.workspace.api.PluginWorkspace.showPreferencesPages(String[], String, boolean) API method allows you to open the Preferences dialog box with a specific preferences page selected and displayed.

Present Warning Messages

The new WorkspaceUtilities.showWarningMessage() API method allows you to present a warning message to the user.

Refresh References for a DITA Map

The new WSDITAMapEditorPage.refreshReferences() API method allows you to refresh the references for a DITA Map that is opened in the DITA Maps Manager view.

Retrieve Clipboard Content Copied in Author Mode

The AuthorAccess.getAuthorObjectFromClipboard() API method allows you to retrieve content from the clipboard that was copied from Author mode.

Specify Initial State for Custom Contributed View

When a workspace access plugin contributes a custom view, it can also specify the initial state of the view (hidden, docked, autohide, or floating).

Treat Expanded or Referenced Content as Transparent when Running XPath Expressions

A new API method AuthorDocumentController.evaluateXPath() has specific parameters that can specify if the entities and xi:include elements are replaced with the actual content that is referenced when the XPath is executed.

Validate Editor Content

The new WSEditor.checkValid() API method validates the editor content and reports whether or not it is valid.


Improved Security

We took proactive steps to improve the overall oXygen security. We limited the execution of all the oXygen customizations that are not deployed in a framework or plugin directory.


Support the Latest Operating Systems

oXygen has been tested and supports the latest operating systems, including Windows 10 and OS X El Capitan (10.11).

Updated XSLT 3.0 Content Completion

The RNG schema that is used for content completion when editing XSLT 3.0 documents was updated to include the latest changes.

Support for SharePoint Online for Office 365 Sites that use ADFS Authentication

You can access documents stored on SharePoint Online for Office 365 sites that use either Cloud identity (ADFS) or Federated identity (on-premise) for their authentication system.

Enhanced Support for XLIFF 2.0 Documents

The support for XLIFF 2.0 documents has been enhanced with the ability to validate them using schema modules.

Support for Executing XQuery Update Scripts Directly Over Content in Author Mode

A new default Author mode operation (XQueryUpdateOperation) has been added that allows you to execute an XQuery Update script directly over content in Author mode.

Configuring Content Completion Proposals

oXygen includes support for configuring the possible attribute or element values for the proposals in the Content Completion Assistant. Support has also been added that allows you to configure the proposals based on the context of the element for which the content completion was invoked.

Convert Hexadecimal Sequence to its Corresponding Unicode Character

A new action was added that allows you to convert any valid hexadecimal sequence into its corresponding Unicode character.

XPath Expressions in Formatting Preferences Accept Attribute Conditions

In the XML Formatting Preferences page, you can add a list of elements for which oXygen will handle whitespaces found in XML content when performing Format and Indent operations. The list of elements can be specified by name or simplified XPath expressions, and the XPath expressions can now accept attribute conditions.

Enhanced Validation Support for XSL-FO

The focheck framework developed by Antenna House is now bundled with oXygen. It offers better and more detailed validation of XSL FO 1.1 documents and it also validates the extension FOs and properties that Antenna House Formatter provides for improved formatted output.

Component Updates

oXygen updates many of its third party components: Calabash 1.1.5, DITA OT 2.1.2, EpubCheck 4.0, LESS 1.7.5, Saxon, TEI Schema 2.8.0, TEI XSL 7.39.

Calabash 1.1.5

The bundled Calabash XProc engine has been updated to version 1.1.5.

DITA OT 2.1.2

oXygen is now bundled with both DITA Open Toolkit 1.8.5 and with DITA Open Toolkit 2.1.2.

EpubCheck 4.0

Support for EpubCheck was updated to version 4.0.

LESS 1.7.5

The LESS CSS processor was updated to version 1.7.5.


The Saxon library was updated to version

TEI Schema 2.8.0

Updated TEI Schema to version 2.8.0.

TEI XSL 7.39

Updated TEI XSL stylesheets version to 7.39.