- oXygen-user - www.oxygenxml.com

[ANN] Webinar: AI as a Tool for Technical Content Creation (June 28, 2023)
by Alin Belu 15 Jun '23

15 Jun '23

Hello, On the *28th of June*, we invite you to join us for one of the most anticipated Oxygen XML live events - the *AI as a Tool for Technical Content Creation* webinar! In recent months, AI technology has advanced to the point where it is now applicable in a wide range of real-world situations. However, the AI-generated content is not always accurate, making it challenging to introduce this technology to end users. On the other hand, this is precisely why technical writers are an excellent fit for AI since they can serve as mediators between the AI and the end users, using it to boost their productivity while ensuring the content that they deliver is accurate. *Oxygen AI Positron Assistant* is a new plugin for the Oxygen XML tools that connects to the Open AI Chat GPT engine, introducing AI technology for supporting technical writing operations. To keep authors in control, the workflows are optimized to include preview of proposed AI changes and the possibility to refine the results. Custom AI interactions are also possible, and you can easily reuse them with support to save them as favorites. During this 1-hour live webinar, Sorin Carbunaru (senior software developer at Syncro Soft) will: * Show various use cases for the *Oxygen AI Positron Assistant*. * Explore the available actions and show how they can be invoked, refined, and the results previewed in the visual diff to analyze the document changes. * Demonstrate how you can define your own AI processing actions and mark them as favorites. * Highlight the tasks best suited for AI technology use. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2023-7.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] New release of Oxygen AI Positron Assistant brings chat, preview, new actions, and more
by Alin Belu 29 May '23

29 May '23

Hello everyone, We are excited to announce a new release for the *Oxygen AI Positron Assistant* add-on! Version 0.9.2 comes with a variety of exciting new features, including chat functionality, the ability to preview changes, AI-based quick fixes, AI-based XPath extension functions, and new AI actions for grammar corrections, content rewriting, and checking how your content responds to specific questions. The *AI Positron Chat* side-view provides a better user experience and more control when invoking AI actions, allowing you to see the response and preview its impact on the document using an action that triggers the visual XML-aware comparison. You can also further refine the responses by continuing the discussion with the *AI Positron* platform in the chat view. In a chat message, you can use editor variables that expand to the selected content or the entire document. These allow you to define flexible prompts, and the support to save favorites enables you to store and easily reuse the prompts you find useful. Along with the preview action for the AI responses, you can also use actions to insert the response into your document or copy the response to the system clipboard. Version 0.9.2 of the add-on improves the existing actions and contributes new AI actions: * *Correct Grammar* - Corrects the grammar and spelling of the selected content. * *Use Active Voice* - Converts the selected content from passive voice to active voice. * *Generate Questions* - Displays possible questions that the selected content or the entire document responds to. * *Answer Questions* - Displays AI responses to your questions found in either the selected content or the entire document. The add-on now also helps you with validation problems. If an error message provides a good description of the identified problem and eventually a hint on how to fix it, which is typically the case with Schematron errors, then you can take advantage of the *AI Positron Fix* quick-fix action that tries to find a solution to the validation problem. This action can be triggered from the contextual menu for the validation problems that are displayed in the application's Problems list. The add-on now also contributes two *XPath extension functions* that can be used from XSLT stylesheets, XQuery scripts, and from Schematron schemas to process content or to perform validation checks on existing content. Custom XML refactoring operations (based on XSLT or XQuery) can also take advantage of these AI functions, so you can apply batch processing on multiple documents. For additional information on the *Oxygen AI Positron Assistant* add-on, including the installation instructions, you can check out this article on the Oxygen XML Blog: https://blog.oxygenxml.com/topics/ai_positron.html We want to remind you that we plan to frequently release new features and improvements, so please let us know what you think of the current version and stay tuned for exciting new versions of this add-on! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] OpenAPI Documentation add-on version 2.2.0 is now available!
by Alin Belu 26 May '23

26 May '23

Hello everyone, We are excited to announce the release of *version 2.2.0* for the *OpenAPI Documentation add-on*! *Version 2.2.0* sees the implementation of useful upgrades, such as: * The addition of an option to transform the OpenAPI content into DITA output. * The "examples" element is now rendered when transforming to HTML output. * A detailed warning message is now displayed when the transformation’s target file has unsaved changes. For more information regarding the OpenAPI Documentation add-on, check out the following page from our documentation: https://www.oxygenxml.com/doc/versions/25.1/ug-editor/topics/openapi-docume… We hope you will find the newest version of our add-on useful and as always, your feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

VBA to XSLT function conversion
by Sudhakara Allam 26 May '23

26 May '23

Hi, I am trying to convert xslt with msxls vbscript generated out of MS Access application to xslt only file by converting VBScript functions to xslt native functions. Does Oxygen have this functionality? It may not have to be automated, however, beneficial if it could. Please let me know. Regards, Sudhakar

1 0

Schematron doesn't respect the full path in the test attribute.
by Danny MacMillan 18 May '23

18 May '23

Hello, Consider the following XML: <?xml version="1.0"?> <root> <relevant> <element relevant-attribute="this attribute exists only on elements under relevant"/> </relevant> <irrelevant> <element/> </irrelevant> </root> And the following Schematron: <?xml version="1.0" encoding="UTF-8"?> <schema xmlns="http://purl.oclc.org/dsdl/schematron" queryBinding="xslt3" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:map="http://www.w3.org/2005/xpath-functions/map"> <ns prefix="map" uri="http://www.w3.org/2005/xpath-functions/map"/> <let name="some-map" value="map {}"/> <pattern> <rule context="/*/relevant/element[map:contains($some-map, @relevant-attribute)]"> <assert test="true()">Impossible</assert> </rule> </pattern> </schema> When I validate the XML with the Schematron, Oxygen prints a warning that an empty sequence is not allowed as the second argument to map:contains, which I've determined is because it is testing the "element" elements under "irrelevant". I know this because if I add a second such element, the error prints twice. If I have 9, the error prints 9 times. But why is it testing that element? I deliberately used xpath that navigates via the parent because I want to include only elements under that parent, but it seems that it's looking at all elements, anywhere in the document, named 'element'. Is this expected? I can silence the warning if I explicitly check for the presence of the attribute: <?xml version="1.0" encoding="UTF-8"?> <schema xmlns="http://purl.oclc.org/dsdl/schematron" queryBinding="xslt3" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:map="http://www.w3.org/2005/xpath-functions/map"> <ns prefix="map" uri="http://www.w3.org/2005/xpath-functions/map"/> <let name="some-map" value="map {}"/> <pattern> <rule context="/*/relevant/element[@relevant-attribute and map:contains($some-map, @relevant-attribute)]"> <assert test="true()">Impossible</assert> </rule> </pattern> </schema> But not if I precede the broken rule with a rule that should equivalently prevent the broken rule from firing on those elements: <?xml version="1.0" encoding="UTF-8"?> <schema xmlns="http://purl.oclc.org/dsdl/schematron" queryBinding="xslt3" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:map="http://www.w3.org/2005/xpath-functions/map"> <ns prefix="map" uri="http://www.w3.org/2005/xpath-functions/map"/> <let name="some-map" value="map {}"/> <pattern> <rule context="/*/relevant/element[not(@relevant-attribute)]"> <assert test="true()">Impossible</assert> </rule> <rule context="/*/relevant/element[map:contains($some-map, @relevant-attribute)]"> <assert test="true()">Impossible</assert> </rule> </pattern> </schema> Thanks, -- Danny MacMillan Sent with [Proton Mail](https://proton.me/) secure email.

3 4

Schematron validation of documents using XInclude succeeds when it should fail.
by Danny MacMillan 12 May '23

12 May '23

Hello, I'm going through the Schematron book by Erik Siegel and one of his examples improperly passes validation in Oxygen XML while it correctly fails validation using SchXslt. The code for the book is here: [https://github.com/xatapult/schematron-book-code](https://github.com/xatapu… I open both examples/additional-features/subdocuments-1.sch and data/subdocuments-master.xml from that project in Oxygen and select the tab with the XML file. Then I click the dropdown on the Validation button on the toolbar and click Validate with... and then I select the subdocuments-1.sch file using the dropdown. When I proceed Oxygen says it passes. This is the same approach I have used for all other examples in the book. But I created an explicit validation scenario for this also and it behaves the same way. Note that if you want to test this you should clone the repository because the subdocuments-master.xml file incorporates other files in the repository by reference using XInclude and this is indeed what seems not to be working in Oxygen. By contrast if I run the same validation using the schxslt-cli.jar I get the following, expected result. [invalid] /home/user/task/schematron-book-code/data/subdocuments-master.xml [invalid] /home/user/task/schematron-book-code/data/subdocuments-master.xml failed-assert /Q{}document[1]/Q{}p[1] The class brightred is forbidden (file:/home/user/task/schematron-book-code/data/subdocuments-2.xml)! I am using the latest Oxygen: <oXygen/> XML Editor 25.1, build 2023042509 Thanks, -- Danny MacMillan Sent with [Proton Mail](https://proton.me/) secure email.

3 4

MSXML4 Not found on windows
by Karl Stubsjoen 03 May '23

03 May '23

Is there a guide to download and install the latest MSXML engine for Windows/Oxygen? My Oxygen is failing to transform using MSXML4, the error is: Could not create the 'MSXML2.DOMDocument.4.0' object. Make sure that MSXML version 4.0 is correctly installed on the machine. Karl.. Karl Stubsjoen (602) 845-0006

1 0

[ANN] Boost your productivity with the new Oxygen AI Positron Assistant plugin!
by Alin Belu 03 May '23

03 May '23

Hello everyone, In the recent months, AI technology reached a point where it became useful in many real life scenarios. However, the AI generated content is not 100% accurate, which makes this technology difficult to deploy directly to end users that expect to only receive correct information. On the other hand, users who understand that AI-generated content is only a starting point, a hint, or a suggestion, and that they are in control of the final form, will experience an increase in productivity because the AI generated content will speed up many of their tasks. The new *Oxygen AI Positron Assistant* plugin provides the bridge between AI and Oxygen users, helping them access AI-enabled tools to speed up content creation. The plugin contributes helper actions that can be used to *generate content*: * You can start typing a phrase and use the *Continue writing* action to get a suggestion for continuing the phrase. * You can write instructions for content that you want to be generated and use the powerful and flexible *Follow instructions* action to add the generated content in the document. A group of *translation actions* will try to preserve the XML markup structure while translating the content to *French*, *German*, *Japanese*, or *English*. To obtain *overview* information, you can use an action to *summarize* the selected content or to get *readability* suggestions. *DITA Topic Tools* actions allow you to perform DITA-aware tasks, such as: * Automatically create the *short description* for a topic, summarizing its content. * Generate *index terms* in the prolog section of a topic by analyzing the topic content and extracting relevant terms. * Turn a phrase that enumerates some options into a list with the *Itemize* action. * Flatten a list into content that enumerates the options from the list with the *Join Items* action. * *Generate a new DITA topic* from a title or a short description by expanding the content. * Replace content with a version that*improves its readability*. The Oxygen AI Positron Assistant plugin contributes its actions to the main menu, contextual menu, and in the *AI Positron Assistant* view. When invoking an action, you can monitor its progress and see the results in the *AI Positron Activity* view. To enable the AI features, you need to connect the plugin to the *Oxygen AI Positron* service platform that now uses the Open AI API to access models like Chat GPT, GPT-4, etc. The initial release of the Oxygen AI Positron Assistant plugin is currently in an experimental phase, enabling users to perform up to 250 actions per month, but we expect to provide subscription options in the near future. We anticipate releasing new features and updates often, so please share your feedback about the current version and stay tuned for exciting new versions of this plugin. For additional information on the *Oxygen AI Positron Assistant* plugin, including the installation instructions, you can check out the following article written by Radu Coravu for the Oxygen XML Blog: https://blog.oxygenxml.com/topics/ai_positron.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[Ann] New maintenance build available for oXygen 25.1 (2023042509)
by Oxygen XML Editor Support (Adrian Buza) 26 Apr '23

26 Apr '23

Dear oXygen users, We announce the release of a new maintenance build (2023042509) for oXygen 25.1 (XML Editor, XML Developer, XML Author, XML WebHelp, Publishing Engine). The build number can be verified in the Help -> About dialog box from the application (next to the version number). You can download the new installation kits from our web site: http://www.oxygenxml.com/download.html Here you can find the complete list of bug-fixes: http://www.oxygenxml.com/build_history.html#2023042509 You can follow our oXygen release/build RSS feed here: http://www.oxygenxml.com/rssBuildID.xml Please let us know if you encounter any problems with this new build. Regards, Adrian -- Adrian Buza oXygen XML Editor and Author Support

1 0

Webhelp search: jump to result when opening a found topic?
by Franz-Josef Knelangen 24 Apr '23

24 Apr '23

Hi there, if a user searches our webhelp and finds the one result, say, in a large reference topic, after clicking on that topic it shows the beginning of the file. How could I achieve that the display jumps to the highlighted search word instead? Greetings, Franz-Josef Franz-Josef Knelangen Leiter Dokumentation Main: +49 7634 5612-0 Facebook<https://www.facebook.com/akgsoftware/> | Xing<https://www.xing.com/pages/akgsoftware> | LinkedIn<https://www.linkedin.com/company/18590571> | YouTube<https://www.youtube.com/c/AKGSoftware-infrastructure> [cid:image002_01fef2d4-1f7d-4ea5-9727-748ef31e8852.png] AKG Software Consulting GmbH Uhlandstr. 12 D-79423 Heitersheim www.akgsoftware.de<https://www.akgsoftware.de/> Gesch?ftsf?hrer: Dipl.-Ing. Artur K. G?nther, Dipl.-Ing. Arno Br?ggemann, Dipl.-Ing. (FH) Bernhard Feser, Dipl.-Ing. Jens G?nther Sitz der Gesellschaft: Heitersheim, HRB 310383 (Amtsgericht Freiburg i. Br.)

2 1

Improve the schema that gets created with Tools -> Generate/Convert Schema
by Danny MacMillan 20 Apr '23

20 Apr '23

Hello, I work with a third party application that produces a large number of XML files. The third party does not make a schema for these files available to me. All I can do is use Oxygen to infer a schema by pointing it at a population of these files. I need to read and manipulate the XML files in Kotlin code. I have been using Tools -> Generate/Convert Schema to create a schema, then processing that schema with JAXB as you ordinarily would. The schemas that Oxygen produces are completely reasonable, but there are some things I'd like to change. In one case I have an element named 'de' that occurs twice. The Generate/Convert Schema tool assumes (or seems to) that these elements describe the same kind of data and it merges their definitions. In fact though, the elements represent entirely different kinds of data. There's no overlap of attributes between the 'de' elements in the first place and the 'de' elements in the second place. So Oxygen doesn't mark any of the attributes as required, when in fact, they're all required in their proper context. The schema also uses anonymous complex types for each element and I'd rather it used named types. I can and will have to edit the schema Oxygen creates to take care of a few things, but I'd like to minimize the amount of manual editing I have to do, because I'll have to repeat this process in the future as the third party software version increases and/or I have to deal with new XML files created from different environments that happen to include elements I haven't yet encountered. What affordances are there for customizing the behaviour of the generate schema tool? The dialog box doesn't have much on it. Alternately, are there other tools I could use to post-process the schema in an automated fashion to get it closer to what I want? I see there's a flatten schema feature but it didn't do much other than re-order the attributes. Thanks, -- Danny MacMillan

1 0

[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