NEW VERSION 24.1 IS NOW AVAILABLE
Oxygen XML Editor version 24.1 is an incremental release for the industry's most advanced bundle of tools used by technical writers, developers, collaborators, and publishers everywhere. The focus of this release was to expand upon the new features and improvements that were added in version 24.0.
This release includes productivity improvements for DITA authors and publishers. The innovative JSON Schema Design mode that was recently introduced in version 24.0 received a lot of further enhancements. Some of the existing JSON tools were also improved. Add-ons were a major focus of this release, with many of the most popular ones receiving lots of updates (including the Git Client, Batch Documents Converter, OpenAPI Documentation Generator, OpenAPI Tester, and more). An interesting new Smart Autocomplete add-on is also available that helps writers create content by providing text completions. XSLT and XQuery transformations and debugging features were enhanced with an update to the Saxon engine, and this release includes various other component updates, bug fixes, and security enhancements.
There are changes in:
Move and Rename Non-DITA Resources
Non-DITA resources that are referenced in a DITA map can be renamed directly in the DITA Maps Manager by using the Move or Rename contextual menu actions. You also have the option to update all the references of the resources during the move/rename operation.
Performance Improved When Opening DITA Maps with Content Expanded
Performance was improved when opening a DITA map with all of the referenced topic content expanded and editable. It now takes less time to open the map, even when it contains a large number of referenced topics.
DITA Open Toolkit Updates and Improvements
The DITA Open Toolkit version that is bundled with Oxygen has been updated to version 3.7.0. Lots of small extra bug fixes are also part of the updated publishing engine.
Absolute Positioning Now Supported
For CSS-based PDF transformations, the processor now supports absolute positions for inline elements. For example, you can now define custom CSS rules to display an image in a certain absolute position within the document or paragraph.
Replace Media with Links
For CSS-based PDF transformations, you can display media objects with an external link instead of graphic by using the new (show.media.as.link) transformation parameter.
Sort Glossary Alphabetically and Grouped by First Letter
It is now possible to have the glossary entries sorted alphabetically and grouped by the first letter of the word. This can be done for CSS-based PDF transformations by setting the new sort.and.group.glossentries transformation parameter to yes. By default, they are inserted based upon the document order.
JSON Schema Design mode Drag and Drop Support
Now you can design your JSON Schema in the Design mode by using drag-and-drop support. You can move or reorder components just by dragging and dropping into the correct location. Oxygen will display a connector to help you visualize the drop location and will highlight the connector with red when the component is not allowed in that particular location.
New Palette View Makes Schema Building Very Easy in JSON Schema Design Mode
The newly implemented Palette view is designed to offer quick access to JSON Schema components and to improve the usability of the JSON Schema diagram builder. The Palette can be used to easily drag and drop various components into the JSON Schema diagram built in the Design mode.
New Actions to Mark Properties as Required or Optional
New contextual menu actions were added in the JSON schema Design mode to make it very easy to mark a property as being either required or optional in the parent object. By default, the defined properties are not required in the JSON schema. However, you can set a list of required properties in the required keyword value.
Convert Between Object Schema and Boolean Schema
New contextual menu actions are available in the JSON schema Design mode that give you the possibility to convert the object schema for a property or definition into a boolean schema with the value of true or false, and vice versa.
Extract Definition
A new Extract Definition action was added within the Refactoring sub-menu in the contextual menu of JSON schema Design mode. The action allows you to extract a definition into the global definitions and reference it. It can be used to extract the definition of a property as a global definition, or extract a local definition globally.
Go to Definition
A new Go to Definition contextual menu action was added in the JSON schema Design mode that enables you to quickly navigate to the referenced schema component.
Content Completion Now Supported for In-place Editing
The content completion assistant is now available for in-place editing within the JSON schema Design mode. For example, when editing properties, you can use Ctrl+Space to invoke the content completion window and the proposals are offered based on the defined JSON schema, according to the version used.
Mark Properties to be Required in JSON Schema Generator Tool
When using the JSON Schema Generator tool, an option (Make all properties required) is now available to specify that all properties be required in the generated schema.
Control the Conversion of Empty Elements in the XML to JSON Converter
A new option (Covert empty elements to structures of type) was added in the XML to JSON converter dialog box that allows you to choose the data type that empty elements will be converted to during the conversion. The possible values are object, string, or array.
Diagrams Generated for References Schemas in JSON Schema Documentation
If you choose to display diagrams in the generated documentation when using the JSON Schema Documentation tool, diagrams are now also shown for components from files that are referenced in the schema document.
Added Hyperlinks for Diagrams in JSON Schema Documentation
When using the JSON Schema Documentation tool, you can choose to include hyperlinks for the diagrams displayed in the generated documentation. Each hyperlink will navigate to the particular component.
OpenAPI Tester Tool
A new OpenAPI Tester tool is available to help you to easily inspect OpenAPI request responses and to ensure they work as expected. It can be used for OpenAPI 3.0 in JSON or YAML format. The tool is available in the Tools->JSON Tools menu. It requires an add-on to be installed but you have the option to automatically install it the first time you select the tool.
OpenAPI Documentation Generator
A new OpenAPI Documentation generator tool is available to help you to easily generate full documentation for OpenAPI components in HTML format, including comprehensive annotations and cross references. The documentation is presented in a visual diagram style with various sections, hyperlinks, and filtering options. The tool is available in the Tools->Generate Documentation menu. It requires an add-on to be installed but you have the option to automatically install it the first time you select the tool.
XSLT Transformation and Debugging
The Saxon built-in XSLT processor used for XSLT transformations and debugging has been updated to version 10.6. The Saxon 10 release is currently considered as the most stable and reliable release.
XQuery Transformation and Debugging
Updated the Saxon XQuery processor used for XQuery transformations and debugging to version 10.6.
New Option Added in the Compile XSLT for Saxon Tool
A new option was added in the Compile XSLT Stylesheet for Saxon dialog box that allows you to set the default namespace for unprefixed element names. It can be used to control the -ns (uri|##any|##html5) Saxon parameter that defines the handling of unprefixed element names that appear as name tests in path expressions and match patterns in the style sheet.
Saxon XSLT and XQuery Transformer Add-on for Saxon version 11.2
A new Saxon transformer add-on is available that adds support for the Saxon transformer version 11.2. This allows you to validate and transform XSLT and XQuery documents with the Saxon 11.2 engine.
Updated Saxon 10 XSLT and XQuery Transformer Add-on to Version 10.7
The Saxon 10 transformer add-on was updated to version 10.7. This allows you to validate and transform XSLT and XQuery documents with the Saxon 10.7 engine.
Added Support for Underlining Content
The Markdown editor now supports the ++abc++ syntax that is used for underlining content.
Removed Apache Log4j Dependency
Removed the dependency on Apache Log4j to help prevent security vulnerabilities. The SLF4j API and Logback libraries are now used instead.
There are available a variety of add-ons for Oxygen that extend the functionality of the application. Many of the existing add-ons were updated and improved, while a new Smart Autocomplete experimental add-on is available that helps writers create content by providing text completions.
Smart Autocomplete Add-on (Experimental) Introduced
A new Smart Autocomplete experimental add-on is available that helps writers create content by providing text completions. Once the add-on is installed, a side-view becomes available where you can access its features. You can choose between a Built-in or OpenAI engine for generating the proposals for text completion. The Built-in engine analyzes all XML, HTML, or Markdown files in a project and then offers completion proposals when editing text content within the project. The OpenAI engine offers the ability to use language models provided by the OpenAI company. This engine not only offers text completion proposals, but it also contributes various configurable actions that can be used to transform the selected text in the editor, and it allows you to create your own language models by using a process called fine tuning. Some examples of the actions that are available to transform the selected text include grammar corrections, paraphrasing, translating content into other languages, adding markup, creating ordered lists, and many more.
Add-on Documentation Structure Improved
All of the add-ons from the official Oxygen repository are now divided into categories in the user guide (Add-ons Chapter) to make it easier to find the types of add-ons that you want to read about.
Quick Install Button Added
There is a new easier installation method for all of the add-ons. The user guide topics now have a new Install button in a Quick Installation section that can simply be dragged and dropped into the main editor in Oxygen to initiate the installation process.
Git Client Improvements
Various improvements were made to the Git Client add-on:
Batch Documents Converter Improvements
Various improvements were made to the Batch Documents Converter add-on:
OpenAPI Tester Add-on Improvements
The OpenAPI Tester add-on was updated to version 1.1 and its improvements include:
DITA Prolog Updater Add-on Improvements
Various improvements were made to the DITA Prolog Updater add-on:
XSpec Helper View Add-on Now Bundles XSpec 2.2.4
The XSpec Helper View add-on was updated to include XSpec version 2.2.4.
New Setting To Control Initial View Mode for Tracked Changes in the Author Visual Editing Mode
A new Initial display mode setting was added in the Preferences->Editor / Edit Modes / Author / Review preferences page to control the initial display mode for tracked changes in the Author visual editing mode.
New Option to Return the Results of a Search as a PDF
A new Include the contents of these binary files option was added in the Preferences->Open/Find Resource preferences page and it returns the results of a search in the Open/Find Resource dialog box/view as a PDF, if the PDF contains the searched text.
DITA Open Toolkit Version 3.7.0
Updated the DITA Open Toolkit version that is bundled with Oxygen to version 3.7.0.
macOS 12 (Monterey)
Oxygen has been fully tested on macOS 12 (Monterey), which is now officially supported.
OpenJDK 17.0.2
Some of the installation kits bundle OpenJDK as the Java Runtime Environment and this was updated to version 17.0.2.
Jackson 2.12.6
Updated the third-party Jackson libraries to version 2.12.6 to fix a security vulnerability.
Xerces 2.12.2
Updated the Xerces library to version 2.12.2.
XSpec 2.2.4
Updated the built-in XSpec framework to version 2.2.4.
Official Support for eXist-db Version 6.0.1
Oxygen has been tested and officially supports eXist-db version 6.0.1.
Calabash XProc 1.3.2-100
Updated the Calabash engine to version 1.3.2-100. The bundled Calabash XProc engine is now integrated with the Saxon 10 library.
Eclipse 4.22
Updated the Eclipse plugin to support version 4.2.
The all platforms distribution of Oxygen is bundled with a scripts sub-folder that contains scripts for automating and running various utilities from a command line interface. To run any of these scripts, you need to purchase a scripting license.
The main focus for this release was various additions and improvements for the Batch Converter script.
Use Custom Settings File for Batch Converter Script
When using the Batch Converter script, you can use a new argument (-cs converterSettingsFile) to specify a file that contains settings for the conversion. It can be an .xpr file that contains project options or an XML file that contains global options.
Batch Converter Script Now Has Option for DocBook to DITA Conversions
You can now convert HTML documents exported from DocBook into DITA using the Batch Converter script.
Batch Converter Script Now Has Option for Confluence to DITA Conversions
You can now convert HTML documents exported from Atlassian Confluence into DITA using the Batch Converter script.
Batch Converter Script - Other Improvements
Other improvements made to the Batch Converter script include:
© Copyright 2000-2023 COGITO SOFTWARE CO.,LTD. All rights reserved
