- oXygen-user - www.oxygenxml.com

[ANN] Oxygen XML Editor version 25.1 has been released!
by Alin Belu 17 Mar '23

17 Mar '23

Hello everyone, We are incredibly excited to announce the immediate availability of *version 25.1* of its industry-leading XML suite of products: *Oxygen XML Editor*, *Author*, *Developer*, *Web Author*, *Publishing Engine*, *WebHelp*, *PDF Chemistry*, and *Scripting*, as well as *version 3.0* of the *Oxygen Feedback* comment management platform. 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. *JSON schema designers* can look forward to more functionality to help them in Design mode, as well as upgrades to some of the JSON tools, and support for editing JSON Lines documents. *YAML developers* will be happy to see that the YAML editing support was bolstered to a level similar to Oxygen's JSON support. Many of Oxygen's *popular add-ons* were updated with new options, visual improvements, performance enhancements, and ease-of-use features. The *scripting community* now has access to some *ready-to-use GitHub project templates and GitHub actions* that allow users to automate scripts and some of the existing scripts were improved, while new ones were added. This release also provides various important *component updates*, *bug fixes*, and *security enhancements*. *Oxygen XML Web Author*, the cutting-edge web-based XML authoring tool, comes with even more improvements and updates. This release brings you updates for the *comparison* tool and *image maps*, new plugins are available for adding support for *CALS tables in custom frameworks*, rendering *LaTeX equations*, and providing *client-side evaluation of XPath* expressions. Various other enhancements were implemented as well. One of the major additions in the latest version of *Oxygen Feedback* is the *Content Indexing and Search* feature, which enables you to utilize Oxygen Feedback as an external search engine for your published Oxygen WebHelp Responsive output. =============================================================================** *What's new in Oxygen XML Editor 25.1* *Oxygen XML Editor version 25.1* is a minor release of the industry-leading bundle of tools for content authors, developers, collaborators, and publishers. This release offers both enhancements to existing functionality and some brand new features that were requested by the community. For *DITA authors*, when working with DITA-OT projects that define multiple output configurations (called contexts), it is easier to select the current context used to see how the DITA content looks like in that configuration using the *re-designed interface*. It facilitates the *context selection with improved grouping and filtering options*. Starting with DITA 1.3, it is possible to *specify filters for a branch of a DITA map* through a functionality called branch filtering. Oxygen's advanced *DITA map validation and completeness check now factors in branch filtering*. DITA 1.3 also introduced the concept of key scopes, enabling you to specify different sets of key definitions for different map branches. Oxygen's *DITA Reusable Components view* has a new filtering option to show keys with the closest relative key scope to the current editing location, and key references are validated taking the key scope into account. The *DITA Map Metrics Report* that contains useful statistics for the current DITA map was *redesigned to allow easier navigation* to its various categories. *Performance was improved when editing large DITA maps* and the Change or remove profiling attribute value refactoring action also updates DITAVAL filter files. *DITA publishers* who produce CSS-based PDF output have the possibility of *displaying line numbers or visual markers for whitespace characters in code blocks*, making code snippets easier to read in the output. The *error reporting was improved* when publishing DITA-OT Project files. For example, the transformation error messages displayed in the Results pane contain the ID of the deliverable. You can also *c**ontrol the behavior of footnotes* using a new transformation parameter that when set to yes, causes footnotes that are referenced multiple times throughout a publication to be cloned and placed at the bottom of the page for each occurrence instead of subsequent references pointing back to the original footnote. For *WebHelp publishers*, this release added new parameters for *disabling the generation of index terms* and *excluding topic IDs from context-sensitive help*, a new extension point can also be used to help you *fine-tune the XSLT transformation* that generates the mapping for context-sensitive help, and the JQuery library that comes bundled with WebHelp is accessible in the browser's global context enabling developers to use it. The innovative *JSON Schema Design mode* received further enhancements. A new action was added to *flatten the entire hierarchy of JSON schemas*, the Extract Definition type actions work on multiple selections of components, and the *functionality of search actions was extended* to enable them to be used on the root schema component. The *XSD to JSON Schema conversion tool* and the *JSON Schema Documentation Generator* were both upgraded to fix various issues and enhance performance. Also, basic *editing support was added for JSON Lines documents*, and JSON property names are now displayed after ending brackets to make the code more readable when editing JSON documents in Text mode. *YAML developers* have *access to an Outline view* that displays the list of all the components of the document in a hierarchical (tree-like) representation and can be used to navigate to a specific part, or to move or delete components. *Content completion assistance* was implemented to help you *edit YAML documents by offering proposals for inserting YAML structures* that are valid at the current editing location. Various actions (e.g. *Toggle Line Comments*, *Copy JSON Pointer*, and *Copy XPath*) were also implemented to bring the *YAML editing support to a level similar to Oxygen's JSON support*. For *XSLT and XQuery users*, a new version of the *Saxon XSLT and XQuery Transformer add-on is now available for Saxon 12 *and the Saxon 11 version of the add-on was also updated to incorporate Saxon 11.5, the latest maintenance release of the Saxon 11 engine. Also, the output of *XQuery Trace functions* (used in XML refactoring actions for debugging purposes) is presented in the Results view to make the information more readily available. Many of the most *popular add-ons received updates* and some interesting *new add-ons were implemented*. The *Git Client add-on* offers *new options, visual improvements, performance enhancements, and ease-of-use features*. Various performance, layout, and rendering improvements were implemented for both the *JSON Schema and OpenAPI Documentation Generator tools*, and the *Batch Documents Converter and Terminology Checker add-ons* also received various updates to bolster their functionality. A *new Live Tutorials add-on* is available to help you create tutorials for learning various editing functions for a certain vocabulary. This add-on also comes bundled with some *small tutorials that teach you how to do various DITA editing tasks*. Another new add-on is available to help you *manage Fluenta DITA translation projects*. Other improvements include basic editing support and syntax highlights for *Dockerfile* documents, relative references in Framework Extension Script files are automatically resolved, certain *XML refactoring operations process faster*, and as usual, this release includes various important *component updates*, *bug fixes*, and *security enhancements*. For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html ============================================================================= *What's new in Oxygen XML Scripting 25.1* *Oxygen XML Scripting version 25.1* offers updates and improvements for some of the scripts that are available to provide a variety of functions that can be scheduled or triggered using a command-line tool on Windows, Linux, or macOS. The *scripting community *now has access to some *ready-to-use GitHub project templates and GitHub actions* that allow users to automate scripts that will be triggered every time you push changes to your repository. For example, there are templates that execute *validation* and *transformation* operations, while other templates allow you to *compare directories* or *generate **XSD/XSL/WSDL Documentation*. The Validation script also received various improvements. For example, *framework validation scenarios are automatically detected for OpenAPI, AsyncAPI, and JSON-LD documents*. New scripts were added for *generating JSON Schema or OpenAPI Documentation*. For more information, see: https://www.oxygenxml.com/xml_scripting/whats_new.html ============================================================================= *What's new in Oxygen XML Web Author 25.1* *Version 25.1.0* of *Oxygen XML Web Author* is a minor release for the innovative web-based XML authoring tool. This release brings you improvements for the comparison tool and image maps, new plugins are available for adding support for CALS tables in custom frameworks, rendering LaTeX equations, and providing client-side evaluation of XPath expressions, while various other enhancements also were implemented. This latest version includes several notable improvements. One of the main areas of focus was on *enhancing stability and performance for non-Latin language input method editors (IME)*. The Web Author's file comparison tool has also been improved with new parameters and better visual highlighting of *surround-type edits*. New actions that *move selected block elements* have been introduced to help improve productivity. *Image maps* now support images referenced using keys, and several *new open-source plugins are available*, including one for adding *support for CALS tables in custom frameworks*, one for rendering *LaTeX equations*, and another for *evaluating XPath expressions* client-side. This version also includes a range of other *productivity improvements*, *component updates*, *bug fixes*, and *security enhancements*. For more information, see: https://www.oxygenxml.com/xml_web_author/whats_new.html ============================================================================= *What's new in Oxygen Feedback 3.0* *Version 3.0* of *Oxygen Feedback* offers exciting new enhancements for the modern comment management platform that provides a simple and efficient way for your community to interact with and offer feedback about your content. Some of the most significant additions for this version include the new *search functionality* that allows you to use Oxygen Feedback as an external search engine for your published Oxygen WebHelp Responsive output. The benefit of this functionality is the *efficiency of the search process*, which is performed on a pre-built index of the HTML content. Oxygen Feedback supports a vast list of languages to be used in the indexing process. The page ratings component was enhanced to provide the possibility of displaying a survey when a user gives a negative rating for a page. The *page ratings statistics page* in the administration interface now has columns for both positive and negative votes, and shows the negative survey messages, which are also sent to admins in daily email notifications. You also have the ability to choose whether to display like/dislike icons instead of text responses (e.g. Yes and No) for the page ratings component. Both Cloud and Enterprise editions also include other *productivity improvements*, *bug fixes*, and *customization options*. For more information about the *Oxygen Feedback Cloud edition*, see: https://www.oxygenxml.com/oxygen_feedback_cloud/whats_new.html For more information about the *Oxygen Feedback Enterprise edition*, see: https://www.oxygenxml.com/oxygen_feedback_enterprise/whats_new.html ============================================================================= *What's new in Oxygen Publishing Engine 25.1* *Oxygen Publishing Engine* offers the same publishing functionality from Oxygen XML Editor to be used for automation and continuous integration/delivery (CI/CD) tasks. *Version 25.1* includes the improvements and additions implemented in *Oxygen XML WebHelp* and *Oxygen PDF Chemistry*. For *Oxygen XML WebHelp publishers*, this release added a new parameter for excluding topic IDs from context-sensitive help mappings, a new parameter to disable the generation of index terms, a new extension point to help you insert custom XSLT code to modify the XSLT transformation that generates the mapping for context-sensitive help, and the JQuery library that comes bundled with WebHelp is accessible in the browser's global context enabling developers to use it. Starting with *version 25.1* of *Oxygen PDF Chemistry*, you have the ability to *embed videos in your PDF output*. It is possible to *display line numbers or markers for whitespace characters* in code blocks to make your code snippets easier to read. You can also *control the behavior of footnotes* using a new transformation parameter that when set to yes, causes footnotes that are referenced multiple times throughout a publication to be cloned and placed at the bottom of the page for each occurrence, instead of subsequent references pointing back to the original footnote. This release also includes various *bug fixes* and *security enhancements*. For more information, see: https://www.oxygenxml.com/publishing_engine/whats_new.html ============================================================================= We hope you will enjoy our latest release of the Oxygen XML suite of products! As always, thank you for your support and don't forget that feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Ditamap archive?
by Frank Dissinger 14 Mar '23

14 Mar '23

Hi all, Does oXygen provide a tool which creates a ZIP archive of a ditamap with all referenced files? Frank -- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)cgs-oris.com | *Web* www.cgs-oris.com <http://www.cgs-oris.com/> *Address* Kettelerstr. 24 | D-63512 Hainburg | Germany *Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99 *Commercial register* Offenbach, HRB no. 21495 *Managing directors* Bernd Rückert, Christoph Thommessen https://www.cgs-oris.com/Signatur.png <https://www.cgs-oris.com/signatur>

2 2

Warning from ODD processor
by Lou Burnard 10 Mar '23

10 Mar '23

Not sure whose problem this is, but the built in ODD to RELAXNC processor (part of the oXygen TEI framework) at release 25 of oxygen editor still seems to be using a component that needs updating. [xslt] Loading stylesheet /home/lou/Oxygen XML Editor 25/frameworks/tei/xml/tei/stylesheet/profiles/default/relaxng/to.xsl [echo] TRANG generate RNC from RELAXNG files WARNING: A terminally deprecated method in java.lang.System has been called WARNING: System::setSecurityManager has been called by org.apache.tools.ant.types.Permissions (file:/home/lou/Oxygen%20XML%20Editor%2025/tools/ant/lib/ant.jar) WARNING: Please consider reporting this to the maintainers of org.apache.tools.ant.types.Permissions WARNING: System::setSecurityManager will be removed in a future release [delete] Deleting: /home/lou/Public/odd4crit/out/odd4crit.rnc.rng "terminally deprecated" sounds a lot worse than it probably is...

2 1

[ANN] Two extra add-ons have been released for the Oxygen Terminology Checker
by Alin Belu 03 Mar '23

03 Mar '23

Hello everyone, We are proud to announce the release of two new extra add-ons which contribute additional rules for the *Oxygen Terminology Checker add-on*! *Important: *The free Oxygen Terminology Checker add-on must be installed in order for these two add-ons to work. First, we have the experimental*ASD Simplified Technical English Specification (ASD-STE100) Rules add-on* that contributes ASD Simplified Technical English Specification rules to the Terminology Checker. It contains technical rules based on ASD-STE100 (http://www.asd-ste100.org) but/note that these rules are not endorsed by ASD-STE100/. Up next, we bring you the *MS Writing Style Guide Vale Rules add-on* that contributes a set of rules based on the Microsoft Writing Style Guide to the Terminology Checker. It contains a Vale-compatible (https://github.com/errata-ai/vale) implementation of the MS Writing Style Guide (https://learn.microsoft.com/en-us/style-guide/welcome) as provided by the errata-ai open-source project (https://github.com/errata-ai/Microsoft) /Note that this project is neither maintained nor endorsed by Microsoft or Vale/. For more information regarding these two new extra add-ons for the Oxygen Terminology Checker, along with details on how to install them, check out the following page from our documentation: https://www.oxygenxml.com/terminology-checker-addon-extra.html We hope you will find these new add-ons useful and as always, your feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Inserting child elements automatically
by Frank Dissinger 01 Mar '23

01 Mar '23

Hi list, Whenever this is valid, I wrap text in a <p> element. I would like oXygen to automatically insert <p> as a child element when inserting <table>, <simpletable> (for the table cells of course), <info>, <stepresult>, <stepxmp>... and many more. How do I do this? Regards, Frank -- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)cgs-oris.com | *Web* www.cgs-oris.com <http://www.cgs-oris.com/> *Address* Kettelerstr. 24 | D-63512 Hainburg | Germany *Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99 *Commercial register* Offenbach, HRB no. 21495 *Managing directors* Bernd Rückert, Christoph Thommessen https://www.cgs-oris.com/Signatur.png <https://www.cgs-oris.com/signatur>

4 6

Oxygen connector for AEM Guides
by Kristen James Eberlein 28 Feb '23

28 Feb '23

Do I get this from AEM or Oxygen? Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Owner, Eberlein Consulting LLC kris(a)eberleinconsulting.com Skype: kriseberlein; voice: +1 (919) 622-1501

2 2

Validation problem
by Lou Burnard 27 Feb '23

27 Feb '23

I have a RELAXNG schema which contains embedded schematron rules and a document which begins with two xml-model PIs like this: <?xml-model href="out/odd4crit.rng type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?> <?xml-model href="out/odd4crit.rng" type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?> When I validate this document using the default CTRL-SHIFT-V option, or using a predefined validation scenario, only Schematron validation errors are reported. When I validate by selecting "Validate with" and specifying the schema URL again, errors reported by jing also appear. Is this the intended behaviour? Why? I am using <oXygen/> XML Editor 24.1, build 2022030807 on Ubuntu 20.04

2 5

[ANN] New versions for the JSON Schema Documentation Add-on and the OpenAPI Documentation Add-on!
by Alin Belu 23 Feb '23

23 Feb '23

Hello everyone, We are excited to announce the release of the newest versions for the *JSON Schema Documentation Add-on* and the *OpenAPI Documentation Add-on*! The *JSON Schema Documentation Add-on version 4.1.0* brings the following enhancements: * Significant improvements were made to the documentation generation for large JSON schemas. * Text content is now wrapped so that it can no longer exceed cell margins. * Schema definitions are now presented even if they are not referenced. * The rendering problems related to diagrams and JSON Pointers are now fixed. * Various performance improvements and bug fixes were implemented, including some broken links and encoding issues. The *OpenAPI Documentation Add-on version 2.1.0* sees the implementation of useful upgrades, such as: * When generating OpenAPI documentation, you now have the option to include hyperlinks for the diagrams displayed for each JSON schema component. The hyperlink navigates you 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. * Implemented various layout and rendering improvements. For more information regarding the *JSON Schema Documentation Add-on*, check out the following page from our documentation: https://www.oxygenxml.com/doc/versions/25.0/ug-editor/topics/json-schema-do… For more information regarding the *OpenAPI Documentation Add-on*, check out the following page from our documentation: https://www.oxygenxml.com/doc/versions/25.0/ug-editor/topics/openapi-docume… We hope you will find these new versions of our add-ons useful and as always, your feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Schematron rule
by Frank Dissinger 22 Feb '23

22 Feb '23

Hi all, I need a Schemtron rule which indicates an error when <li> elements do not have any child elements. No error schould be indicated for <li> elements with an "conkeyref" attribute and also for <li> elements which are children of any element with a "conkeyref" attribute. I have defined two separate rules... <sch:pattern id="Check_LI2"> <sch:rule context="*li[not(@conkeyref)]*"> <sch:assert test="*">List does not contain any child elements</sch:assert> </sch:rule> </sch:pattern> <sch:pattern id="Check_LI3"> <sch:rule context="*li[not(parent::*[@conkeyref])]*"> <sch:assert test="*">List does not contain any child elements</sch:assert> </sch:rule> </sch:pattern> ... but I think I need to combine them into a single rule with an OR or AND operator. <sch:pattern id="Check_LI3"> <sch:rule context="*li[not(@conkeyref)]* *OR **li[not(parent::*[@conkeyref])] *"> <sch:assert test="*">List does not contain any child elements</sch:assert> </sch:rule> </sch:pattern> However, this syntax is invalid. Can somebody help me? Regards, Frank -- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)cgs-oris.com | *Web* www.cgs-oris.com <http://www.cgs-oris.com/> *Address* Kettelerstr. 24 | D-63512 Hainburg | Germany *Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99 *Commercial register* Offenbach, HRB no. 21495 *Managing directors* Bernd Rückert, Christoph Thommessen https://www.cgs-oris.com/Signatur.png <https://www.cgs-oris.com/signatur>

2 2

Inserting current date into DITA file
by Frank Dissinger 14 Feb '23

14 Feb '23

Hi list, How can I insert the current date into a dita file? I would like to have oXygen automatically update the year of a copyright notice. I know that I can define editor variables. But how can I embed them in the dita code? If this needs to be tied to the XSL that produces the deliverable: I need this for CHM, which I generate with oXygen. (I have already found a solution for MiramoPDF. ) And I'd need to know where exactly to add the code... Thank you. Regards, Frank -- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)cgs-oris.com | *Web* www.cgs-oris.com <http://www.cgs-oris.com/> *Address* Kettelerstr. 24 | D-63512 Hainburg | Germany *Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99 *Commercial register* Offenbach, HRB no. 21495 *Managing directors* Bernd Rückert, Christoph Thommessen https://www.cgs-oris.com/Signatur.png <https://www.cgs-oris.com/signatur>

2 4