Oxygen XML Developer V25.1

JSON Schema

• New Action to Flatten Schema in JSON Schema Editor - In some cases, it is more useful to have a single file with all the schema definitions instead of working with multiple files separately. For this specific case, Oxygen now provides you with the new Flatten Schema action (available in the Editor contextual menu) that can be used to flatten an entire hierarchy of JSON Schemas, by recursively adding the components of all referenced schemas into the main one, and by updating all the $ref keys accordingly.
• Extract Definition Action Improved - The existing refactoring actions that extract definitions (Extract definition in current file or Extract definition in another file) now work on multiple definitions so that you can just select all the definitions you want to extract into the definition group and only have to invoke the corresponding action once.
• Search Functionality Extended in the JSON Schema Design Mode - The functionality of search actions (Search References, Search References in, and Search Occurrences in File) in the JSON Schema Design mode has been extended so that they now can be used on the Schema type component (the root of the schema diagram) to search for references/occurrences of the schema name.
• Performance Improvements When Renaming Components - Performance improvements have been implemented for the Rename Component action so that the operation is processed faster, especially when there are a lot of changes in large documents.
• XSD to JSON Schema Conversion Improved - The conversion of XSD to JSON Schema has been improved to correctly generate the keywords when JSON Schema version 2019-09 or 2020-12 is selected. This ensures that the generated JSON schema is accurate and compatible with the selected JSON schema version.
• JSON Schema Documentation Generator Improvements - The following improvements are now included when generating JSON Schema documentation:
  • The time it takes to generate the documentation has been reduced significantly, especially for large schemas.
  • Text content will now wrap on multiple lines to avoid exceeding the cell margins.
  • Schema definitions are now presented even if they are not referenced.
  • Some rendering problems have been fixed regarding the linking of the diagrams with the components from the documentation.
  • Various performance and bug fixes have been implemented, including some broken links and encoding issues.

JSON

• Support for JSON Lines Documents - Oxygen now offers basic text editing support for JSON Lines documents (a convenient format for storing structured data that may be processed one record at a time). Validation and content completion features are available if a JSON Schema is associated through a validation scenario.
• Property Names Now Displayed After Ending Brackets in Text Mode - When editing JSON documents in the Text editing mode, property names are now displayed after the ending bracket to make the JSON code more readable. This default behavior can be disabled by deselecting the new Show property name after ending bracket option in the JSON section of the Editor->Edit Modes->Text preferences page.
• Format and Indent JSON and JSON-LD in HTML Scripts - The format and indent action in HTML documents will now also format the JSON and JSON-LD content from the HTML script element.

YAML

• New YAML Outline View - The Outline view is now available for YAML documents. It displays the list of all the components of the current YAML document in a hierarchical (tree-like) representation. It is synchronized with the main editor so you can use it to navigate to specific parts of the document and move or delete components.
• Content Completion Now Available in YAML - The content completion mechanism is now available when working with YAML documents. The content completion in YAML is generated automatically from the associated JSON schema. You can also control the inserted content with a new set of options (located in the Options->Preferences->Editor->Content Completion->YAML preferences page). You can specify whether or not required content, optional content, and additional content should be generated.
• Generate Default Content in YAML Content Completion - A new option (Property value) has been added in the Options->Preferences->Editor->Content Completion->YAML preferences page. It allows you to choose how Oxygen will generate a property value when you use the content completion assistant. You can choose between the default, random, or empty values.
• Toggle Line Comments Action - The Toggle Line Comments action is now available for YAML documents. The action can be triggered from the contextual menu (or by using the Ctrl + ForwardSlash keyboard shortcut) and it comments or uncomments the current selection (or the current line if no content is selected) in the YAML document.
• Copy JSON Pointer and Copy XPath Actions - The Copy JSON Pointer and Copy XPath actions are now available for YAML documents. The actions copy the JSON Pointer or XPath expression from the cursor position to the system clipboard.

XML Refactoring

• All XML Refactoring Operations Now Available in the Find Action Dialog Box - XML Refactoring actions in special categories (including the DITA-specific ones) are now available to be selected and executed directly from the Find Action dialog box.
• Move/Rename Resource Actions Now Available for Folders in the Project View - You can now use the Move resource and Rename resource actions on both files and folders within the Project view's contextual menu (under the Refactoring submenu). Previously, these actions were only available for files.

Add-ons

• JSON Schema Documentation Generator Improvements - Various improvements have been added to the JSON Schema Documentation Generator add-on:
  • The time it takes to generate the documentation has been reduced significantly, especially for large schemas.
  • Text content will now wrap on multiple lines to avoid exceeding the cell margins.
  • Schema definitions are now presented even if they are not referenced.
  • Some rendering problems have been fixed regarding the linking of the diagrams with the components from the documentation.
  • Various performance and bug fixes have been implemented, including some broken links and encoding issues.
• OpenAPI Documentation Generator Improvements - The following improvements have been added to the OpenAPI Documentation Generator add-on:
  • 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 Apple macOS distributions.
  • Links from the Source code section are now functional.
  • Various layout and rendering improvements have been implemented.
• Git Client Improvements - Some improvements have been made to the Git Client add-on:
  • A new options page has been added for SSH connections to control SSH agent usage.
  • The Oxygen project change detection mechanism has been 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 have been implemented.
• Saxon XSLT and XQuery Transformer Add-on is Now Available for Saxon Version 12 - A new Saxon XSLT and XQuery transformer add-on is now available for Saxon version 12. The add-on integrates the latest major release of Saxon (version 12.0 of the engine).
• Updated Saxon XSLT and XQuery Transformer Add-on for Saxon 11 - A new version for the Saxon XSLT and XQuery transformer 11 add-on is now available. The new version integrates Saxon 11.5, the latest maintenance release of the Saxon 11 engine.
• Live Tutorials Add-on - The new Live Tutorials add-on allows you to create live tutorials for people who want to learn various editing functions for a certain vocabulary using the application. The add-on comes bundled with small tutorials for learning how to perform various DITA-related editing tasks in Oxygen. For example, there are tutorials that contain various missions for learning some basic DITA editing tasks, learning how to work with tables, learning how to edit and insert images, and more.
• Fluenta DITA Translation Add-on - Fluenta is a tool designed to simplify the translation of DITA projects. The new Fluenta DITA Translation add-on allows you to manage a Fluenta translation workflow directly from within Oxygen. The Fluenta DITA Translation add-on provides access to the following features:
  • 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 - Various improvements have been made to the Batch Documents Converter add-on:
  • The processing of table captions has been improved when converting Microsoft 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 has been 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 - Two new extra plugins have been added to the Terminology Checker add-on:
  • 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.

Other

• Impose a Content Type for an Element when Configuring Content Completion - When configuring the content completion proposals at framework level using the 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 - Basic editing support and syntax highlights are now provided for working with Dockerfile documents.
• Relative Paths in Framework Extension Script Files are Automatically Resolved - When using a Framework Extension Script file to customize a framework, relative paths listed in the script file are now automatically resolved relative to the location of the script file.
• XQuery Trace Functions Now Presented in Results View - The output of the XQuery 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.
• Performance Improvements for XML Refactoring Operations - When processing XML refactoring actions that use the document function to load additional resources, the access to schemas that are referenced in the loaded documents is now cached to speed up the refactoring process.