What's New in Oxygen XML Author 25.1
Related version: 25.0
Oxygen XML Author version 25.1 is a minor release of the industry-leading bundle of tools for content authors, collaborators, and publishers. This release offers both enhancements to existing functionality as well as some brand new features that were requested by the community.
Some of the highlights of this release include various productivity improvements for DITA authors and new possibilities for DITA publishers who produce either CSS-based PDF or WebHelp output. Many of our popular add-ons were updated with new options, visual improvements, performance enhancements, and ease-of-use features. A new Live Tutorials add-on is available to help you create tutorials for learning various editing functions and another new add-on is available to help you manage Fluenta DITA translation projects. This release also provides various important component updates, bug fixes, and security enhancements.
There are changes in:
DITA Authoring
Support for Branch Filtering in Validate and Check for Completeness Operations
<ditavalref>
elements) during the operation.DITA Maps Manager's Context Drop-down Menu Reorganized
Option to Hide Irrelevant Contexts in DITA Maps Manager
New Action to Choose Context from Main Files
DITA Map Metrics Report Improved
Better Filtering Options for the DITA Reusable Components View
Validate a Topic in the Current Key Scope Context
APIs to Resolve Key Reference From XSLT Stylesheets or Schematron Schemas
Performance Improvements for Large DITA Maps
XML Refactoring Action to Change/Remove Profiling Attribute Values Now Updates DITAVAL Files
Option to Index Only Files Marked as Resource-Only in the Context DITA Map
DITA Publishing
Embed Videos in Your PDF Output (EXPERIMENTAL)
Display Line Numbers in Codeblocks
@outputclass
attribute on the
<codeblock>
elements to the show-line-numbers
value. For more details, see How to Add Line Numbering in Code Blocks.Display Whitespace Characters in Code Blocks
@outputclass
attribute on the <codeblock>
elements
to the show-whitespace value. For more details, see How to Display Whitespaces in Code Blocks.DITA-OT Project File Transformation Error Reporting Improved
Control the Behavior of Footnotes
args.css.param.clone-referenced-footnotes
) is available to control the
behavior of footnotes. When set to yes, footnotes that are referenced
multiple times throughout a publication are cloned and placed at the bottom of the page
for each occurrence. Otherwise, only the first footnote reference is placed at the bottom
of the page and subsequent references point back to the original footnote.Author Visual Editing
Improved Content Completion for Element Values
Set the Default Schema Using the Framework Extension Script
Add-ons
JSON Schema Documentation Generator Improvements
- The time it takes to generate the documentation has been reduced significantly, especially for large schemas.
- Text content will wrap on multiple lines to avoid exceeding the cell margins.
- Schema definitions are now presented even if they are not referenced.
- Some rendering problems were fixed regarding the linking of the diagrams with the components from the documentation.
- Various performance and bug fixes were implemented, including some broken links and encoding issues.
OpenAPI Documentation Generator Improvements
- You now have the option to include hyperlinks for the diagrams displayed for each JSON schema component. The hyperlink navigates to the definition of that component.
- The OpenAPI Documentation action is now properly aligned in the Generate Documentation menu on macOS distributions.
- Links from the Source code section are now functional.
- Various layout and rendering improvements were implemented.
Git Client Improvements
- A new options page was added for SSH connections to control SSH agent usage.
- The Oxygen project change detection mechanism was improved. It is now faster and the Git Staging view no longer needs to be displayed.
- The presentation of the labels associated with a commit in the Git History view has been improved to avoid truncating names when it is not necessary.
- The commit dot in the Git History graph associated with the head of the current branch is now painted differently to make it easier to be seen.
- Various bug fixes and performance improvements were implemented.
For a complete list of updates added in the Git Client, see https://github.com/oxygenxml/oxygen-git-plugin/releases.
Saxon XSLT and XQuery Transformer Add-on is Now Available for Saxon Version 12
Updated Saxon XSLT and XQuery Transformer Add-on for Saxon 11
Live Tutorials Add-on
Fluenta DITA Translation Add-on
- A Fluenta menu is added to the contextual menu in the DITA Maps Manager and it includes a Create project action that opens a dialog box where you can create and configure a Fluenta project.
- Once you are ready to send a project to translators, you can use the Generate XLIFF action (available in the Fluenta menu) to open a dialog box where you can select the languages and other options and then generate an XLIFF file for each selected language. You could then send the XLIFF file(s) to a translation service provider.
- Once you receive the XLIFF back from the translator, you can use the Import XLIFF action (available in the Fluenta menu) to generate a translated version of your project.
- You can edit previously created Fluenta projects by using the Edit project action (available in the Fluenta menu).
Batch Documents Converter Improvements
- The processing of table captions was improved when converting Word to XHTML or DITA. The table is now obtained with a caption child in HTML or with a title in DITA.
- The width of table columns is now preserved when converting Word to XHTML or DITA.
- The processing of figure captions was improved when converting Word to XHTML or
DITA. For XHTML, a
<figure>
element is obtained with a<figcaption>
child element. For DITA, a<fig>
element is obtained with a<title>
child element.
Terminology Checker Improvements
- The ASD Simplified Technical English Specification (ASD-STE100) Rules plugin contributes ASD Simplified Technical English Specification rules to the Terminology Checker.
- The MS Writing Style Guide Vale Rules plugin contributes a set of Vale-compatible rules based on the Microsoft Writing Style Guide to the Terminology Checker.
Scripting
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.Ready-to-use GitHub Project Templates Available to Help You Explore Oxygen Scripting
- Validate - https://github.com/oxygenxml/oxygen-script-validation-template
- Transform - https://github.com/oxygenxml/oxygen-script-transformation-template
- Compare Directories - https://github.com/oxygenxml/oxygen-script-comparison-template
- XSD/XSL/WSDL Documentation - https://github.com/oxygenxml/oxygen-script-documentation-template
Validation Script Improvements
New Script for Generating JSON Schema Documentation
jsonSchemaDocGen.sh
) is available to generate
documentation from a JSON schema file using the command line. For more details, see Scripting Oxygen: JSON Schema Documentation.New Script for Generating OpenAPI Documentation
openApiDocGen.sh
) is available to generate
documentation from an OpenAPI file using the command line. For more details, see Scripting Oxygen: OpenAPI Documentation.Other
Impose a Content Type for an Element when Configuring Content Completion
cc_config.xml
configuration file, you can now force an element to have
a content type imposed. This is done by using the new contentType
attribute on the elementProposals
and its possible values are:
elementOnly, mixed, and
empty.Basic Editing Support and Syntax Highlights Added for Dockerfile Documents
Relative Paths in Framework Extension Script Files are Automatically Resolved
XQuery Trace Functions Now Presented in Results View
trace()
functions that are used in
XML refactoring actions for debugging purposes is now presented in the
Results view at the bottom of the application.