Oxygen XML Author Professional V26.1

Released: Mar 25, 2024

V26.1 中的更新

特性

DITA Authoring

  • Insert Content/Key References from Content Completion Assistant - When editing DITA topics, you now have access to several actions listed as proposals in the content completion window that make it easier to insert content references and key references. The conref action opens a pop-up window that allows you to choose reusable content from a list of all the reusable components (elements with IDs in topics that are referenced as resource-only in the context DITA map). The keyref action opens a pop-up window that allows you to choose a key from a list of all the keys that are gathered from the context DITA map.
  • Preserve Topic Type When Converting Sections to New Topics - When using the Convert sections to new topics XML refactoring operation, users will now benefit from the topic type being preserved for the new topic files created from the inner sections. This applies specifically to DITA topics of the type topic, concept, or reference. Previously, the generic topic type was used, but now users can ensure consistency in the topic types throughout the conversion process.
  • Option to Control Conversions of Non-DITA Resources When Inserting Topic References - A new option (Dynamic conversion of specific non-DITA resources) is now available in the DITA Maps preferences page that controls whether or not non-DITA resources are automatically converted to DITA when inserting topic references in the DITA Maps Manager. The option is enabled by default, which means non-DITA resources (such as Microsoft Word, Microsoft Excel, Markdown, OpenAPI, and HTML) are dynamically converted when chosen in the Insert Topic Reference dialog box. You can disable the option if you do not want such resources to be converted to DITA.

DITA Publishing

  • Automatic Fix of Width/Height Values for Images - When performing CSS-based PDF transformations, it is important to ensure that the values for the width or height of an image do not contain uppercase letters for units of measurement (this can cause the image to be missing in the output). If the system detects that an image has width or height values that contain units of measurement written in uppercase letters, it now automatically corrects them to ensure that the image is properly displayed in the output. Additionally, a warning message is displayed to alert you about the issue so that you can also fix the problem in the source file.
  • Zendesk Transformation Automatically Creates Table of Contents - The Zendesk Help Center transformation scenario now automatically creates and publishes a table of contents as the first article in the target section. This initial article serves as a hierarchical reference to all other articles. The title of the table of contents article is the title of the DITA map. To disable the publication of a table of contents, you can set a new parameter called zendesk.create.toc to false. Additionally, there are two new optional parameters, zendesk.toc.title.prefix and zendesk.toc.title.suffix, which allow you to specify a prefix or suffix to be added to the title of the table of contents article.
  • Publish to Zendesk Subsection - The Zendesk Help Center transformation scenario now supports publishing to a subsection. The Section parameter can contain a path of section names separated by '///'.
  • Real-Time Publishing Steps Presented for DITA Transformations - When running DITA transformations, the real-time progress is now constantly updated in the status bar to present the current publishing step being processed.
  • Support for Prepress Print Layout With New Cropping Properties - For CSS-based PDF transformations, support has been implemented for prepress processing with the addition of the new cropping properties (-oxy-scale, -oxy-crop-box, and -oxy-crop-offset). It is also possible to add the crop and/or registration marks to the PDF document by using the marks property.

Author Mode

  • Spell Checker Improvements - When using the spell checker for DITA, DocBook, or TEI documents opened in Author mode, the borders of consecutive inline elements are now considered transparent. This means that if there is no space between two consecutive inline elements and the text inside them would form a misspelled word when placed consecutively (without a space) in the output, a spell check error will be reported.
  • Smart Paste Markdown Content - Markdown content that is pasted within DITA, DocBook, TEI, or XHTML documents in the Author visual editing mode is now converted to the target vocabulary, similar to pasting web page content or Microsoft Word content.
  • Split Action in Content Completion Automatically Inserts Required Child Element - When using the Split action within the content completion feature in Author mode, if the initial element has a required first child element, it will now be automatically added as an empty child element inside the newly created element.

Text Mode

  • Batch Execute Quick Fix Proposals - A new Apply all default quick fix proposals action has been added in the Text editing mode's contextual menu that can be used to batch execute all detected default quick fix proposals for all reported validation errors.
  • Toggle Comments Action Supports Multiple Languages - The Toggle Comments action that is used to enclose the currently selected fragment in a comment is now context dependent, making it possible to comment multiple types of languages within a document.
  • Automatically Generate Unique Values for ID-Type Attributes - When an ID-type attribute is inserted using the Content Completion Assistant, a unique value is now automatically generated for it, eliminating the need for an extra step of adding an unique value for the attribute.

File Comparison

  • Merge Documents with Change Tracking Highlights Tool Improved - Improvements have been made to the Merge Documents with Change Tracking Highlights tool to provide better handling of particular cases where documents with extensive structural changes are compared. This should help eliminate false validation errors when comparing pairs with lots of structural changes.
  • API for Merge Documents or Directories with Change Tracking Highlights - The newly added AuthorDiffChangeTrackingMergerFactory.AuthorDiffChangeTrackingMergerFactory() API can now be used for merging a pair of compared XML documents or directories and the resulting merged document will contain highlighted tracked changes. The class provides 2 methods: createChangeTrackingMergePerformer() for merging documents, and createDirectoryChangeTrackingMergePerformer() for merging directories.

Markdown

  • Syntax Highlights for Languages Embedded in Markdown - For Markdown documents that contain code from various languages, those blocks are now rendered with proper syntax highlights to make it easier to distinguish the non-Markdown syntax. The languages that are rendered with syntax highlights in Markdown documents include JavaScript, JSON, YAML, XML, Java, Python, and CSS.
  • DITA Preview Presents Colors and Filters for Profiling Attributes - For Markdown documents that contain profiling attributes within curly braces (e.g. ## Header 2 {audience=expert}), the DITA preview pane now presents the profiling attributes, colors, and filtered elements similar to how they are presented in Author mode, provided that the profiling is set to be shown in the Profiling/Conditional Text drop-down menu in the DITA Maps Manager.

Add-ons

  • JSON Schema Validator - A new JSON Schema Validator add-on is now available to provide support for validating JSON documents against JSON schema version 2020-12. The validation engine is based on the json-sKema library. Once the add-on is installed, you can choose the JSON Schema Validator (json-sKema) engine when creating a validation scenario.
  • Batch Documents Converter Improvements - Several enhancements have been made to the Batch Documents Converter add-on, including the addition of an XSD to JSON Schema conversion that results in a version 2020-12 JSON Schema.

Scripting

  • 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.
    • Performance Improved for Validation and Check for Completeness Script - The DITA Validate and Check for Completeness script received important performance enhancements. By eliminating a lot of duplication within the processing, the time it takes for the script to finish when using DITAVAL filters has been reduced significantly.

Miscellaneous

  • Experimental Dark Color Theme in Eclipse - Added a new experimental system property (-Dcom.oxygenxml.eclipse.dark.color.theme=true) which can be set in the eclipse.ini configuration file to enforce a dark color theme when opening XML documents in Oxygen's Eclipse plugin. The regular color theme in Eclipse must also be set to Dark (in the Preferences->General->Appearance page) to consistently apply the Dark theme in the entire workbench.
  • Create and Validate SVG 1.2 Tiny Documents - SVG 1.2 Tiny schema grammar files have been added and a new file template to create new SVG 1.2 Tiny documents is now available in the new file wizard. These updates make it possible to easily create, edit, and validate SVG Tiny 1.2 documents.
  • DocBook 5.2 - Schemas and new file templates have been added to support creating, validating, and editing DocBook 5.2 documents.

Component Updates

  • Updated the Eclipse plugin to support version 2024-03 (4.31).
  • The XSpec Helper View add-on was updated to include XSpec version 2.3.2.
  • The TEI XML vocabulary schemas have been updated to version 4.7.0 and the XSLT stylesheets have been updated to version 7.56.0.
  • The version of OpenJDK that is bundled with the installation kits for providing the Java Runtime Environment has been updated to version 17.0.10 from Eclipse Adoptium.
  • Updated the JSON-Java (org.json) package to version 20240205.
  • Updated the Apache Lucene libraries used for indexing content for the Open/Find Resource functionality to version 9.7.0.
  • Updated the Apache POI libraries used for various conversions from Microsoft Excel to version 5.2.5.
  • Updated the Apache Commons IO utilities library to version 2.15.0.
  • Updated the zendesk-java-client library used for publishing DITA XML content to Zendesk to version 0.24.1.
  • Updated the logback-classic library to version 1.4.14.
  • Updated the logback-core library to version 1.4.14.

Deprecated/Removed Components

  • EAD, KML, StratML Frameworks Moved to Oxygen XML GitHub Organization - The frameworks for editing EAD, KML, and StratML documents are now available as separate projects in the Oxygen XML GitHub organization.
  • Deprecated Support for Tree Editor - The support for the Tree Editor (Tools->Tree Editor) has been officially deprecated and will be removed in a future major release.
  • Deprecated Support for WSDL - The support for editing WSDL files and for the WSDL SOAP Analyser has been officially deprecated and will be removed in a future major release.
  • Deprecated Support for FTP/SFTP - The support for using FTP and SFTP connections has been officially deprecated and will be removed in a future major release.
  • Deprecated Support for Databases - The support for connecting to Oracle, Microsoft SQL Server, Postgres, MySQL, IBM DB2, and Marklogic databases has been officially deprecated and will be removed in a future major release.
  • Deprecated Support for Xalan and XSLTProc - The support for using the Xalan and XSLTProc XSLT processors has been officially deprecated and will be removed in a future major release.
  • Support Removed for XSV and SQC Custom Validation Engines - The support for using the XSV (XML Schema Validator) and SQC (Schema Quality Checker from IBM) custom validation engines has been removed.

API

  • Create an Editor Component for a Certain Content Type - The StandalonePluginWorkspace.createEditorComponentProvider API now allows you to create an editing component that can be used in custom side views by passing an extra content type parameter. This means you can create editing components to edit HTML5 or JSON content.
  • Create a Text Area with Syntax Highlights - The new OxygenUIComponentsFactory.createTextArea(String contentType, boolean highlightCurrentLine) API method allows you to create a text area with syntax highlights for a certain content type and it also controls whether or not the current line should be highlighted.
  • Access Batch Operations Listener for 3rd-Party Plugins - The newly added PluginWorkspace.getBatchOperationsListenersAccess() API method can be used by third-party plugins to notify other plugins when a batch operation that modifies multiple resources is in progress.
  • Reload Content of a Document - The WSEditor.reload() API method now allows for the content of an opened document to be reloaded from the original URL location (whether it is a local or remote location).
  • Reload Content of a Document if Change is Detected on Local Disk - The new WSEditor.reloadIfChangeOnDiskDetected() API method can be used to reload the content of an opened document from the local disk if the content on disk has changed in the meantime.
  • Merge Documents or Directories with Change Tracking Highlights - The newly added AuthorDiffChangeTrackingMergerFactory.AuthorDiffChangeTrackingMergerFactory() API can be used for merging a pair of compared XML documents or directories and the resulting merged document will contain highlighted tracked changes. The class provides 2 methods: createChangeTrackingMergePerformer() for merging documents, and createDirectoryChangeTrackingMergePerformer() for merging directories.