- oXygen-user - www.oxygenxml.com

[ANN] Webinar: Interactive Tutorials in Oxygen (April 26, 2023)
by Alin Belu 20 Apr '23

20 Apr '23

Hello, On the *26th of April*, we invite you to join us for the latest Oxygen XML live event - the *Interactive Tutorials in Oxygen* webinar! As you surely know by now, a traditional tutorial implies a set of written instructions that the users must follow. Well, Oxygen takes the concept one step further! With our *Live Tutorials add-on*, the tutorial is embedded within the application itself. The samples for each step are opened automatically, hints are available on request, and the application detects when a mission is complete (in this case, a mission consists of the initial file content that is opened in the application and a set of steps for guidance). For 1 hour, Sorin Carbunaru (senior software developer at Syncro Soft) will explore in detail the Live Tutorials add-on, by covering the following topics from which you will benefit greatly: * The built-in DITA interactive tutorials. * How to create new tutorials and journeys. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2023-6.html To stay in touch with us and discover what other events we have planned for you, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: How to Enable Content Indexing and Search in Oxygen Feedback 3.0 (Wednesday, 19 April)
by Alin Belu 18 Apr '23

18 Apr '23

Hello, Tomorrow, on the 19th of April, we continue our live event series with the *How to Enable Content Indexing and Search in Oxygen Feedback 3.0* webinar! Thus, we remind you that you can join this event that will be focused on the latest release of *Oxygen Feedback version 3.0*. This new release brings some exciting new enhancements to our modern comment management platform, including the implementation of content indexing and search functionality. During this webinar, Alin Balasa (senior software developer at Syncro Soft) will provide a detailed overview of the various features that were added for those who want to make the most of our new and advanced search functionality, as well as information about the other new features that version 3.0 brings to the table. Our expert speaker will delve into the technical details and demonstrate how you can take advantage of these new features. Whether you are an existing Oxygen Feedback user or interested in discovering more about our modern commenting platform, this webinar is a great opportunity to learn about the latest developments and how they can benefit your business. The following topics will be addressed: * Information about the new Content Indexing feature. * Details about the automatic re-indexing functionality. * Ability to choose from various different languages for the indexing process. * Searching through the WebHelp Responsive output. * An overview of various other new features that were added in version 3.0. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2023-5.html To stay in touch with us and discover what other events we have planned for you, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

XProc and paged media: AHFormatter complains about missing XSL Stylesheet
by Frank Steimke 14 Apr '23

14 Apr '23

Dear List, with the help from this list (Thanks Tony!) i was able to build a XProc Transformation Scenario, running in Oxygen, which converts DocBook to PDF via XSL-FO and the p:xsl-formatter step. Now i'd like to do the same with CSS (paged media). Using the xslTNG Stylesheets (recent Version 2.1.2) i get an HTML Document. The Antenna House Formatter (version 7.2) reads it without anly problems and produces PDF as expected when called as a standalone app with GUI. It does not work, however, when called as a step within the XProc Pipeline. The essential Part is like this: ``` <p:xslt> <p:input port="stylesheet"> <p:document href="xsltng/docbook-xslTNG-2.1.2/xslt/print.xsl"/> </p:input> <p:input port="parameters"> <p:empty/> </p:input> </p:xslt> <p:xsl-formatter href="tdd.pdf" content-type="application/pdf"/> ``` This throws an exception: jp.co.antenna.XfoJavaCtl.XfoException: No XSL Stylesheet is specified. Two questions arise: - Which XSL Stylesheet is missing? No transformation on the input document is necessary. - How would I specify a stylesheet? The p:xsl-formatter Step from XProc 1.0 hs no input port for a stylesheet. Thanks in advance, Frank Steimke

2 1

Understanding @colsep and @rowsep
by Frank Dissinger 13 Apr '23

13 Apr '23

Hi all, Can someone shed some light on how the *@colsep* and*@rowsep* attributes are used for CALS tables? The information I found is not clear and detailed enough for me. I understand that these attributes create separator lines for colums and rows. Do I only need these attributes when I do not set *@frame="all"* to create lines for particular rows or columns only? For a normal CALS table with lines for all rows and columns (i.e. like a grid), is enough to set *@frame="all"* or do I additionally need these attributes? The code that Oxygen creates (see below) with these settings (i.e. without these attributes) ... does not have these *@colsep* and*@rowsep* attributes, only *@frame="all"*, and is rendered as desired with my CHM and PDF transformations. I have several tables with *@colsep*/*@rowsep="0" *or*="1"*. These attributes may have been added by FrameMaker when I converted unstructured content to DITA. Can I safely remove all of these attributes when I just want a CALS table with row and line separators every (like a grid)? 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

[ANN] The Oxygen XML Editor agenda for Convex Baltimore 2023!
by Alin Belu 11 Apr '23

11 Apr '23

Hello everyone, Next week, between the 17th and the 19th of April, the Oxygen XML Editor team will exhibit and present at the ConVEx conference in Baltimore – the immersive experience for content developers! There, you will get the chance to meet a part of the Oxygen team in-person (George Bina and Radu Coravu) and discuss with them ideas related to the Oxygen products and supported technologies, or see a demo tuned to match your specific use-cases. Of course, similar to the previous years, they prepared for you a great agenda comprising of both test kitchens and presentations that looks like this: Monday, April 17, 11:15 – 12:00 EDT *Oxygen XML Add-ons for Technical Writers* (Test Kitchen) - Radu Coravu Description: Oxygen XML Editor and Oxygen XML Author can be enhanced by installing add-ons. There are quite a number of free and useful add-ons for technical documentation writers and Radu Coravu will explore some of them. During this test kitchen, along with our most popular add-ons, you will be able to see the introduction of our newest plugin - the*Oxygen AI Positron Assistant* – a great tool that will enhance your editing productivity with the use of OpenAI ChatGPT engine. Tuesday, April 18, 10:45 – 11:30 EDT *Using DITA for Business Processes* (Presentation) - George Bina Description: Our company has many internal documents that describe different business processes to maintain internal knowledge and procedures. We previously used a wiki but as the number of documents increased, it was difficult to handle all this information. For this presentation, George will focus on how the DITA extensibility support makes DITA a good fit, storing semantic information that enable many automation processes and dynamic access to relevant topics. Tuesday, April 18, 15:30 – 16:15 EDT *Practical Git Workflows for Tech Docs* (Presentation) - Radu Coravu Description: During this presentation, you will be shown the practical aspects and workflows when using Git as a version control system for technical documentation using the DITA XML standard. Watch how a DITA XML documentation project can be stored on a Git repository along with common settings, present common editing and collaboration workflows based on the common Git repository for technical writers. Wednesday, April 19, 10:45 – 11:30 EDT *Use-Cases Using the Oxygen XML Tools* (Test Kitchen) - George Bina, Radu Coravu Description: Oxygen provides tools that allow creating content, reviewing it, publishing to different formats and getting feedback from your users. For this test kitchen, join George Bina and Radu Coravu to discover how you can combine the Oxygen XML tools to create solutions that integrate with your workflows. For a detailed description of the Oxygen XML Editor interactive sessions prepared for ConVEx, you can also check the Agenda featured on https://www.oxygenxml.com/events/2023/convex_baltimore.html . We can't wait to see you all in Baltimore! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: How to Enable Content Indexing and Search in Oxygen Feedback 3.0 (April 19)
by Alin Belu 11 Apr '23

11 Apr '23

Hello, As promised, our live event series continues next Wednesday, on the *19th of April*, with the *How to Enable Content Indexing and Search in Oxygen Feedback 3.0* webinar! Thus, we are excited to invite you to an event that is focused on the latest release of *Oxygen Feedback version 3.0*. This new release brings some exciting new enhancements to our modern comment management platform, including the implementation of content indexing and search functionality. During this webinar, Alin Balasa (senior software developer at Syncro Soft) will provide a detailed overview of the various features that were added for those who want to make the most of our new and advanced search functionality, as well as information about the other new features that version 3.0 brings to the table. Our expert speaker will delve into the technical details and demonstrate how you can take advantage of these new features. Whether you are an existing Oxygen Feedback user or interested in discovering more about our modern commenting platform, this webinar is a great opportunity to learn about the latest developments and how they can benefit your business. The following topics will be addressed: * Information about the new Content Indexing feature. * Details about the automatic re-indexing functionality. * Ability to choose from various different languages for the indexing process. * Searching through the WebHelp Responsive output. * An overview of various other new features that were added in version 3.0. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2023-5.html To stay in touch with us and discover what other events we have planned for you, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Bug in collapse/expand capability with large files
by Roger L Costello 07 Apr '23

07 Apr '23

[cid:image001.png@01D96875.6B70D7C0]

2 1

Generate PDF from DocBook using Calabash and XProc in Oxygen with Antenna House
by Frank Steimke 06 Apr '23

06 Apr '23

Dear List, I need Help with an XProc Pipeline that should generate PDF From DocBook using AH Formatter in a Microsoft Windows 10 Environment. I am using a fresh Installation of Oxygen 24.1. What i have done so far / current status: - There is a XProc Pipeline which gets the DocBook File as Input, applies the DocBook 1 Stylesheets to generate FO, and applies xsl:formatter to generate PDF from XSL-FO. This Step calls the Apache FOP Processor shipped with Oxygen. It does generate a PDF, but images are not rendered (empty frames of the correct size within the PDF). - The primary result of the Pipeline is the XSL FO generated by the DocBook Stylesheets, so I am able to check the url für external-files in FO. They point to the images in my file system. I have tried many different ways to change this url, including relative paths instead of absolute paths. Nothing helped, the images are still missing. - Because of the missing images and other issues with Apache FOP (landscape Tables etc.) I have to switch to the Antenna House Formatter (v 7.2). - Oxygen Editor allows Integration of Antenna House. After doing so I can apply a Transformation Scenario to the XSL-FO generated by my XProc Pipeline. Works great, the Result is exactly what I need. PDF includes the Images with exactly the same input, on which Apache gave me empty frames. The only thing is, that i have to call this second Transformation scenario manually. It is not integrated in the Pipeline. - So the task seems to be simple: configure the xsl:formatter step in my XProc pipeline, so that Antenna House will be used instead of Apache FOP. But I did not find a way to achieve this. I do understand that - i have to configure xmlcalabah so that com.xmlcalabash.fo-processor system property gets the value com.xmlcalabash.util.FoAH. The best way would be a xmlcalabash configuration file, but how can I point from Oxygen to that config file? --- I was able to set the java System Property within the Oxygen Startup, and i can see the correct value in the Oxygen Help/About Info Box (that is, the system property com.xmlcalabash.fo-processor has the Value com.xmlcalabash.util.FoA), but the xsl-formatter Step doesn't care. It will still use Apache FOP. - I have to add the jar for the xmlcalabash1-print <https://github.com/ndw/xmlcalabash1-print> module to the claasspath. Maybe OXYGEN-INSTALL-DIR/xproc/engine? - I have to point to the directory where xmlcalabash can find the Antenna House jar files and the Licence File. How would I do that within Oxygen? Any help is greatly appreciated. Thanks in advance, Frank Steimke

2 1

IDs for new DITA topics
by Frank Dissinger 03 Apr '23

03 Apr '23

Hi all, I understand that a topic ID must be unique within the scope of the root ditamap used for publishing the content. FrameMaker, which I used previously, creates IDs of the type id172OC0C03J7 So there is an arbitrary combination of 11 digits and letters. In oXygen I have set the "DITA > ID Option" as follows: ${localName}_${id} Which creates IDs of the following type: task_rf2_vcg_ywb So there is an arbitrary combination of only 9 characters, mostly letters. But perhaps sufficient for ensuring uniqueness... However, when I use the "DITA > Insert > Insert New DITA Resource" command, oXygen does not honor the "ID Option" setting, but creates IDs which are identical to the file name. This is not what I want and surely not suitable for ensuring uniqueness. How can I get oXygen to honor the "ID Option" setting or make it otherwise generate IDs with arbitrary characters which are likely to be unique? 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>

3 4

[ANN] Webinar: DITA Project Management, Validation, and Translation in a Docs as Code Environment (April 5th)
by Alin Belu 29 Mar '23

29 Mar '23

Hello, Get ready to mark your calendars because the Oxygen XML live event series is making a comeback! Next Wednesday, on the *5th of April*, don't miss out on the chance to attend our first webinar of spring - we're talking about the *DITA Project Management, Validation, and Translation in a Docs as Code Environment* webinar! /Docs as Code/ is a philosophy according to which you should write documentation using the same tools and workflows that software developers use to write code. But it's not so much about the tools, as it is about the workflows and practices involved, such as continuous integration or version control. Next week, join Sorin Carbunaru (senior software developer at Syncro Soft) as he will look at such a setup using open-source tools and standards that include: * DITA, as the plain text format we'll use, because it fits the profile and brings additional benefits to the mix: semantics, content reuse, publishing options. * Storage and version control using Git (trunk-based development). * Project validation in continuous integration pipelines. * Translation workflows based on Fluenta: - Creating and sharing a Fluenta configuration. - Sending the DITA project to the translation service provider as XLIFF. - Generating the translated version of the DITA project once the XLIFF returns from translation. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2023-4.html To stay in touch with us and discover what other events we have planned for you, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Struggling with conkeyref/conaction=pushafter
by Frank Dissinger 29 Mar '23

29 Mar '23

Hi all, I have tested the "DITA > Push Current element" feature, but cannot get it to work. I want to inject a <dlentry> element into a shared topic which is used in two projects. The element to be injected is stored in a warehouse topic for project 1. What I want is to inject this element only when project 1 is built. When project 2 is built, the key to the warehouse topic resolves to a different file which doese not include the element. So what I hope is that the element is only injected when I build project 1 and that it is left out when I build project 2 -- without any error or warning generated in the log file or in Oxygen's editor window. However, the element does not appear in project 1 and in Oxygen it is shown as an empty <dt> struture. In a previous attempt the element was shown in the editor window, but not in output either. I can't remember what I did differently... I may not have undestood this feature correctly. Can someone enlighten me? Thank you. Regards, Frank The dita code: * * *file.dita* <dlentry conaction="mark" conkeyref="lib_ref/my_id"> <dt/> <dd> </dd> </dlentry> <dlentry conaction="pushafter"> <dt>A term. The term in lib_ref.dita should be injected after that.</dt> <dd> Explanation </dd> </dlentry> *lib_ref.dita * <dl> <dlentry id="my_id"> <dt>The term to inject after the term in file.dita</dt> <dd> Explanation </dd> </dlentry> </dl> *variables.ditamap* <keydef href="reuse/lib_ref.dita" keys="lib_ref"/> Appearance in oXygen. -- *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>

3 5

Do I need a namespace declaration in dita root elements?
by Frank Dissinger 24 Mar '23

24 Mar '23

Hi all, I am cleaning up DITA files created with FrameMaker. FrameMaker has added a lot of unnecessary attributes, for example. Among others, FM has added an *xmlns:ditaarch* attribute to every top-level dita element such as concept, task or reference. Example: <concept id="id187JBI00EHS" xml:lang="en-US" *xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/"*> Can I safely remove this attribute or is it required? 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 3

v25.1 plugins for CALS tables, LaTeX rendering
by Michael Boudreau 21 Mar '23

21 Mar '23

The notes for Oxygen 25.1 mentioned plugins to support CALS tables and LaTeX equation rendering. Where is this documented? -- Michael R. Boudreau Electronic Publishing Technology Manager The University of Chicago Press 1427 E. 60th Street Chicago, IL 60637 www.journals.uchicago.edu

2 2

Spell check exceptions per file?
by Frank Dissinger 21 Mar '23

21 Mar '23

Hi all, When spell checking a dita file, can I mark up words to be correct in the current file only, i.e. without adding them to the "learned words" for the project or globally? 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 1

Learned Words
by Frank Dissinger 20 Mar '23

20 Mar '23

Hi list, I have a list of correctly spelt words which I collected in FrameMaker. How can I add them to the list of "learned words" in oXygen? I added them to the *.tdi file, but oXygen overwrites this file when I use the spell checker and so the words are gone. 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 1

[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 element. I would like oXygen to automatically insert 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