- oXygen-user - www.oxygenxml.com

Setting OL start value in webhelp
by Scott Prentice 17 Mar '25

17 Mar '25

Is there some cool Oxygen-specific way to set the start value for an ordered list in webhelp? I can assign some value in the outputclass of the <ol> in DITA, like .. <ol outputclass="start(3)"> Then, I can use a CSS selector to apply styling based on that value. Unfortunately, I'm not seeing a way to just set the "start" attribute on the <ol> in the HTML. There are gymnastics that can be done with various "counter" properties and function, but I really don't want to do that. I just want to be able to set a value in the DITA, and have that passed to the HTML (will tackle PDF as a separate effort). (Yes, I can probably use JavaScript, but is that really necessary?) Before I bash my head too much more on this, I thought that maybe there's some special Oxygen function or CSS property that will do this .. maybe? Any thoughts are appreciated. Scott

1 0

[ANN] Oxygen Content Fusion 8.0 is now available!
by Alin Belu 11 Mar '25

11 Mar '25

Hello everyone, We are proud to announce the release of *Oxygen Content Fusion 8.0*, the web-based collaboration platform for content creation! Version *8.0* turns *Oxygen Content Fusion* into a powerful AI-driven tool designed to boost writer productivity by integrating with the *Oxygen AI Positron Assistant*. This version also consolidates the Oxygen Content Fusion position as a /Content Management System/ for DITA content stored in a Git repository by adding the ability to access all Git branches. *Oxygen AI Positron Assistant* is available for users with the Content Fusion /Author/ role and offers a suite of AI-powered features to enhance content creation and editing. Once the plugin is installed, the /AI Positron Assistant/ side-pane becomes accessible in the /Personal Workspace/, providing a range of powerful AI-driven actions and features. Some of the key features include: * The AI Positron Assistant makes changes to the files inside a workspace based on your instructions. These changes can be inspected using a side-by-side, before-and-after visual comparison view. To ensure that you are always in control, any changes may be rolled back. * AI-powered content generation actions can be used to expand a DITA topic by refining its content, adding markup, and generating documentation based on referenced images using Vision support, to generate content based on uploaded images, produce alternate text for images in DITA, or to generate MathML formulas based on your description. * Content improvement actions are available to proofread documents, validate documents and suggest fixes for identified issues, add semantic inline DITA markup to plain text content, modify content based on suggestions found in the comments (which are then resolved), or split large DITA topics into multiple smaller topics while also referencing the new topics in the DITA map. * Retrieval-Augmented Generation (RAG) support allows the AI Positron to find similar content from the personal workspace when generating new content. * Integrators or other advanced users can create and configure custom actions, similar to the built-in actions, allowing the ability to provide the prompt for the AI engine, control engine parameters, available function callback tools, and so on. The newest version of Oxygen Content Fusion also introduces important updates to the Content Fusion Project functionality. A project mirrors a Git repository and via a /Personal Workspace/ enables users to make changes across multiple files. Once the users are happy with the results, these changes can be committed directly to the repository to be shared with the rest of the team. Now, when working with projects, authors can *access all Git branches* and get a /Personal Workspace/ dedicated to each branch, making it possible to commit changes on a particular branch (version) without affecting the user's changes made in their other workspaces. Branches can also be merged using a built-in visual comparison tool that simplifies the process. Review tasks can now be created from branches other than the default one, and a new filter was added in the task list page to show review tasks specific to the current branch, making it easier to locate and manage relevant tasks. Additionally, administrators now have the possibility of configuring authentication settings to enable support for OpenID Connect (OIDC) single sign-on for compatibility with solutions such as Microsoft Entra ID and Okta. For email and password-based signups, admins can now restrict sign-ups to specific email addresses or patterns. Additional security hardening controls were also implemented to keep your data safe. More information about the newest release of Oxygen Content Fusion can be found here: https://www.oxygenxml.com/content_fusion/whats_new.html The new features can also be tested freely on the public demo deployment: https://fusion.oxygenxml.com/projects We hope you will enjoy our latest release! 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

[ANN] DITA-OT Day 2025 Copenhagen recordings are now available!
by Alin Belu 07 Mar '25

07 Mar '25

Hi everyone, Last month, Syncro Soft/Oxygen XML hosted in Copenhagen the DITA-OT Day 2025 conference, the full day conference dedicated to the DITA Open Toolkit project. We want to properly express our gratitude to everyone who contributed to making the 9th edition of the DITA-OT Day conference a success! From the DITA-OT main developers to our attendees, to the dedicated presenters and generous supporters, such as Comtech, Antenna House, Bluestream, and Miramo, we extend our sincerest thanks for your participation and support. We're grateful for your continued involvement in shaping the future of the DITA Open Toolkit project. As we look forward to future editions with anticipation, we invite you to watch the insightful discussions and presentations by accessing the library of recordings and slides from this year's DITA-OT Day through the following link: https://www.oxygenxml.com/events/2025/dita-ot_day.html All the best, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: Solving Common Git and DITA Challenges (March 12)
by Alin Belu 05 Mar '25

05 Mar '25

Hello, Mark your calendar for *March 12th* and join us for a free, live 1-hour webinar where Cristian Talau (product manager at Syncro Soft) will reveal practical solutions to overcome common Git and DITA challenges with Oxygen Content Fusion! Whether you're dealing with challenges in collaboration with subject matter experts, publishing hurdles, or translation complexities, the *Solving Common Git and DITA Challenges* live session will provide practical solutions to streamline your workflow. During this event, the following topics will be covered: * /Review from Subject Matter Experts (SME) using Content Fusion/ – How to simplify collaboration and feedback collection. * /Publishing workflows/ – Learn to optimize your publishing process. * /Link management/ – Discover how to maintain and troubleshoot DITA linking efficiently. * /Translations/ – Leverage built-in tools to easily manage multilingual content. * /Handling Merge Conflicts/ – Gain insights into preventing and resolving merge conflicts when working with DITA content in a collaborative Git environment. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2025-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

[ANN] Webinar: Querying and Transforming JSON Documents (February 12)
by Alin Belu 06 Feb '25

06 Feb '25

Hello, Are you ready to unlock the full potential of JSON documents with Oxygen? If the answer is yes, we invite you to our live event, *Querying and Transforming JSON Documents*, taking place next Wednesday, on *February 12th*. In this session, you’ll discover how to efficiently transform JSON into XML, HTML, or other formats using the powerful XSLT and XQuery tools built into Oxygen. Learn advanced techniques for querying JSON data using XPath expressions and XQuery, as well as seeing how you can integrate these capabilities seamlessly into your workflow. Our returning expert, Octavian Nadolu (product manager at Syncro Soft), will share practical insights and advanced techniques by guiding you through these following topics: * /JSON Transformation with XSLT:/ Seamlessly convert JSON documents into various formats. * /JSON Querying with XQuery:/ Extract and manipulate JSON data with precision. * /Batch Processing:/ Perform transformations and queries on multiple documents directly from your project. * /XPath for JSON:/ Leverage XPath expressions for intuitive and efficient JSON querying. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2025-3.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] Oxygen AI Positron Assistant 4.1 is now available!
by Alin Belu 31 Jan '25

31 Jan '25

Hello, We are proud to announce the release of *Oxygen AI Positron Assistant 4.1*, a powerful tool that helps you increase your productivity by providing support for using AI-generated content within Oxygen tools - Oxygen XML Editor/Author/Developer, Oxygen JSON Editor, Oxygen XML Web Author, and Oxygen Content Fusion. *Version 4.1* enhances the existing AI features and introduces a wide range of new functionalities, including improved validation tools, dynamic AI workflows, and enhanced collaboration capabilities, making the assistant even more capable and user-friendly. With this newest version, you can preview the changes that the *Create Topics* and *Split Topic* actions will make before saving them to disk, ensuring greater confidence and control over modifications. The *Intelligent Agents* category now includes a new *Fix Validation Problems* action. This action validates the current document and suggests fixes for all identified issues, streamlining both the validation process and the resolution of validation problems, ensuring high-quality content. The new *Formula/Equation* action leverages AI to generate MathML formulas based on your descriptions. This feature simplifies the creation of complex mathematical representations and enhances technical documentation workflows. Furthermore, the *Annotate Code* action is now available and adds comments to XSLT, Schematron, or XSD code, explaining its purpose and functionality. This is particularly useful for developers aiming to improve code readability and maintainability. Version 4.1 also introduces the *Export Chat* action, allowing you to export chat sessions as JSON documents. These can be shared with others or re-imported using the *Import Chat* action, making it easier to troubleshoot custom AI actions issues, or to resume conversations at a later time. When an AI action processes content but does not result in any changes, you are now informed, eliminating the need for unnecessary previews or visual inspection. This improvement saves time and ensures a smoother workflow. A new XPath function has been introduced, enabling you to seamlessly invoke an AI Positron action from any XPath context (such as XSLT, XQuery, Schematron, etc.) by providing the action ID, contextual text, and the content to be processed. The plugin now includes several new *AI callback functions*, which are specialized mechanisms enabling the AI to dynamically invoke external processing and use the results in generating its response. These new functions can be used to invoke another AI action, to find all the available AI actions, and to validate a document, thus empowering you to create complex, dynamic workflows as part of a custom AI action. Most of the features were also implemented for Oxygen XML Web Author and Oxygen Content Fusion, including the *Fix Validation Problems* action, the *Formula/Equation* action, the notification when content is not changed, and the AI callback function to validate a document. In addition to the support to attach a remote file, a new *Attach from computer* option allows users to incorporate files from their local machine into prompts. Attachments are useful in various use cases. For example, the user can attach a screenshot and ask the AI to update a documentation topic based on that image. For more information, see https://www.oxygenxml.com/ai_positron_assistant.html 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

[ANN] Webinar: AI-Powered Development, Part 2: Enhancing Development Workflows with AI Positron (February 5)
by Alin Belu 30 Jan '25

30 Jan '25

Hello, Next Wednesday, *February 5th*, we’re excited to continue our *AI-Powered Development* series with *Part 2: Enhancing Development Workflows with AI Positron*! Join Octavian Nadolu (product manager at Syncro Soft) for another insightful webinar as he explores the advanced AI features designed to revolutionize your XML development and content management workflows. Don't miss this opportunity to gain valuable insights into: * /AI-Enhanced Development Tools:/ Explore integrated AI capabilities for XSLT, XQuery, Schematron, XSD, and JSON Schema to boost efficiency. * /Custom AI Actions:/ Learn how to design and implement AI-driven actions tailored to your specific development needs. * /AI in Schematron:/ Discover how to leverage AI for advanced content validation and automated correction. * /AI with XSLT:/ Master the use of AI to streamline the management and processing of complex content. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2025-2.html If you’re interested in joining this event, we also invite you to explore our other upcoming live session: *February 12* - Querying and Transforming JSON Documents - https://oxygenxml.com/evs2025-3.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Old (?) validation problem reappearing
by Espen Ore 22 Jan '25

22 Jan '25

Greetings, I now get an error message when I try to validate - whether by setting the schema from the drop down menu or from the dov´cument header: Description Saxon-EE cannot validate with schema type text/rnc Severity Error Engine name Saxon-EE 12.5 I have seen that this also was a problem with some earlier versions of Oxygen, but I cannot come around the problem with the solutions given then. I am using the newest version as far as I can discover: <oXygen/> XML Editor 27.0, build 2024121306 Can anyopne help here? Best regards Espen Ore -- Espen S. Ore Holmestrand, Norge/Ithaka Hellas (+47) 913 907 48/(+30) 695 5550615

2 3

Re: [oXygen-user] [OXYGEN-24088] Wrapping into <note> produces invalid DITA code
by Oxygen XML Editor Support (Radu Coravu) 21 Jan '25

21 Jan '25

Hi Frank, By default with a stock Oxygen installation and default DITA XML editing, wrapping a inside a <note> does not automatically add an extra paragraph like note > p > p. That's because when inserting a <note> by default no paragraph is inserted inside it. Is it possible you made changes to the content completion configuration file so that a note has a required paragraph child element? Regards, Radu Radu Coravu Oxygen XML Editor On 1/20/25 19:02, Frank Dissinger wrote: > > Hi all, > > When I insert a <note> element, is added automatically as a child, > which is the desired behaviour for me. > > However, wrapping a into <note>, produces the structure > <note>, which is invalid because two elements are nested. > > How can I prevent that another is added as a child of <note> just > for the wrapping operation (and not for inserting)? > > Freundliche Grüße | Best regards > > *Frank Dissinger* > > Documentation Manager > > .......................................... > > *CGS ORIS GmbH* > > *Email *frank.dissinger(a)cgs-oris.com > <mailto:frank.dissinger@cgs-oris.com>| *Web* www.cgs-oris.com > <http://www.cgs-oris.com/> > > *Address*Kettelerstrasse 24 | 63512 Hainburg | Germany > > *Phone*+49 6182 9626-0 | *Fax* +49 6182 9626-99 > > *Commercial register*Offenbach, HRB no. 21495 > > *Managing directors*Bernd Rückert, Christoph Thommessen > > > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 3

Wrapping into <note> produces invalid DITA code
by Frank Dissinger 20 Jan '25

20 Jan '25

Hi all, When I insert a <note> element, is added automatically as a child, which is the desired behaviour for me. However, wrapping a into <note>, produces the structure <note>, which is invalid because two elements are nested. How can I prevent that another is added as a child of <note> just for the wrapping operation (and not for inserting)? Freundliche Grüße | Best regards Frank Dissinger Documentation Manager .......................................... CGS ORIS GmbH Email <mailto:frank.dissinger@cgs-oris.com> frank.dissinger(a)cgs-oris.com | Web <http://www.cgs-oris.com/> www.cgs-oris.com Address Kettelerstrasse 24 | 63512 Hainburg | Germany Phone +49 6182 9626-0 | Fax +49 6182 9626-99 Commercial register Offenbach, HRB no. 21495 Managing directors Bernd Rückert, Christoph Thommessen

1 0