00:00:03The Oxygen XML team is very proud to
announce the release of the latest and
00:00:09greatest major version of the Oxygen XML suite
of products. Here are some highlights of the
00:00:14most interesting and important new features
implemented in Oxygen XML Editor 25.
00:00:21As usual, lots of features were added
for DITA authoring and publishing.
00:00:26For example, local DITA maps
that are modified in the DITA
00:00:30Maps Manager are now automatically
saved whenever a modification is made.
00:00:35However, this default behavior can be disabled
by going to the DITA Maps preferences page
00:00:42and deselecting the "Automatically save local
DITA maps after each modification" option.
00:00:51Various features were implemented to enable some
non-DITA file types to be converted and treated
00:00:57as DITA-compatible resources when referencing,
validating, or publishing content. For example,
00:01:03you can insert references to certain non-DITA
resources, such as Word, Excel, HTML, Markdown,
00:01:09OpenAPI, and more ... and they are converted to
DITA in the background and the reference insertion
00:01:15dialog box allows you to select targets
the same as with a normal DITA reference.
00:01:23Another example is if you have a
DITA-compatible document referenced
00:01:27in your DITA map, you can run a DITA Map
completeness check and the non-DITA file is
00:01:32converted to DITA in the background and
validated the same as a DITA topic.
00:01:41Similarly, if you have an OpenAPI document
(for example) referenced in the DITA map,
00:01:47and then you run a transformation scenario for
the map ... the OpenAPI document is converted to
00:01:53DITA in the background ... and in the output,
it is published as a converted DITA topic.
00:02:03A new Generate Metrics Report action was added
to the DITA Maps Manager's toolbar to quickly
00:02:08generate a report that contains useful
statistics for the current DITA map.
00:02:15Special support was added for DITA Questions and
Answers. A new "Insert Intent Question" action
00:02:22can be used to insert a DITA intent question
inside the prolog. It's a question that could
00:02:27be asked by a user and its answer is found in the
current topic. You also now have the possibility
00:02:33of using the new file wizard to create a
new "Questions and Answers" DITA topic type
00:02:37that is used during the publishing process for
creating Google Structured Content metadata.
00:02:46When working with DITA OT project files in Author
mode, each deliverable now has a play button
00:02:52that can be used to publish each deliverable
individually. There's also a play button at
00:02:57the top of the DITA OT project file to publish
all deliverables specified in the file.
00:03:04Some general editing improvements
were also implemented.
00:03:09By default, Oxygen displays referenced
content, but there is an option in the
00:03:14Author preferences page named "Display
referenced content" that can be disabled
00:03:18to make it possible for references (such
as xi:includes) to be expanded on demand.
00:03:25With the option disabled, after re-opening the
document, the referenced content is collapsed
00:03:31and you can expand each reference on
demand, according to your needs.
00:03:39JSON developers will be happy to
know that support was implemented
00:03:42for the new JSON schema version 2020-12.
For example, when creating a new JSON schema
00:03:49document using the file wizard, you now have
the option to select the 2020 schema version.
00:04:01That version is set in the new document and its
specification is used for validation and editing.
00:04:08The new components for version 2020 were added
00:04:11in the Palette view so that you can
drag and drop them into the editor,
00:04:20and the content completion proposals and
00:04:23their documentation are based
upon the new specification.
00:04:32The JSON Schema Documentation tool also
now supports the version 2020 schema.
00:04:38After using the tool to generate documentation
for a 2020 schema file, the resulting HTML
00:04:44file presents various details, links, and
options based on the new specification.
00:04:51New search and refactoring actions
were added in the JSON schema Design
00:04:55mode to improve the handling of
JSON definition type components.
00:05:00For example, the Search References action
can be used to search all references of the
00:05:05selected definition in a scope determined by
the referenced schemas. Another example is the
00:05:13"Rename component in" action. It allows
you to rename the selected component ...
00:05:21specify a scope for the operation ... and you can
preview the files being affected and these files
00:05:28are identified by searching the references of
the selected component in the scope provided.
00:05:38Our developers implemented various features
and tools for the OpenAPI standard.
00:05:43Full support was added for OpenAPI 3.1
documents, including automatic validation,
00:05:49content completion, and editing in Text or Author
mode. New document templates are available in the
00:05:55new file wizard for various versions of OpenAPI
documents in either JSON or YAML format ...
00:06:02the OpenAPI version is automatically
detected and used for validation ...
00:06:09and content completion proposals are presented
00:06:12along with their documentation specs
according to the OpenAPI version.
00:06:20The OpenAPI Documentation Generator tool now
boasts a new design in the generated output. It is
00:06:27now easier to navigate through various information
about the generated documentation, such as details
00:06:33about the servers, paths, and components
that are defined in the OpenAPI document.
00:06:39Also, a visual diagram is presented for components
to make the structure easier to understand.
00:06:45The update to Saxon 11.4 is the most significant
improvement for XSLT and XQuery users.
00:06:54The built-in Saxon processor used for XSLT
and XQuery transformations and debugging has
00:07:00been updated to version 11.4. Among other things,
this means that more extension functions are now
00:07:06supported and included in the list of proposals
in the content completion assistant.
00:07:13The most popular add-ons continued to
receive important and requested updates.
00:07:19Validation features were added in the Git Client.
When these features are enabled and you try
00:07:25to commit changes, those files are automatically
validated, and the validation errors are presented
00:07:31in the usual results pane so that you can easily
navigate to the location of the error. Likewise,
00:07:37if you try to push changes to the repository, all
documents referenced in the main files folder are
00:07:43automatically validated and again, any detected
errors are presented in the results pane.
00:07:57One of the big improvements for the
Batch Documents Converter add-on is
00:08:01the addition of an OpenAPI to
DITA conversion possibility.
00:08:06You can convert JSON or YAML files that
conform to the OpenAPI specification to DITA.
00:08:13There even an option that can be selected to
instruct the converter to split the documents
00:08:19into separate DITA topics that are then
referenced in a newly created DITA map.
00:08:24One example of an improvement in the
Terminology Checker add-on is the
00:08:28ability to apply custom Vale
rules with a sentence scope.
00:08:33With the rule defined in a YAML file that's
saved in a particular folder, the Terminology
00:08:38Checker displays warnings for detected Vale
rule problems along with the other rules.
00:08:43For XML scripting ... it is now possible to
validate files or directories from a command
00:08:50line interface so that you can check that your
documents are valid from an integration server and
00:08:54you can generate reports in several formats such
as text, XML, JSON, or an HTML visual format.
00:09:04These were just a handful of the
new features added in Oxygen XML
00:09:08Editor 25. For a complete list
of all the additions, updates,
00:09:12and implementations, go to our
What's New page on our website.