April 2023 - oXygen-user - www.oxygenxml.com

[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