- oXygen-user - www.oxygenxml.com

Re: [oXygen-user] [OXYGEN-9425] Association Rules in frameworks
by Oxygen XML Editor Support (Radu Coravu) 18 Oct '23

18 Oct '23

Hi Scott, The "DITATopicCustomRuleMatcher" java class is where the magic happens :) It's quite hard to identify a DITA topic or map, it could use the base public IDs or it could refer to specialization DTDs, it could have various root element names, but the "DITATopicCustomRuleMatcher" Java class looks at various default attributes specified in the DTD like the "ditaarch:DITAArchVersion" attribute to decide if an opened XML document is actually a DITA topic or map. https://www.oxygenxml.com/InstData/Editor/SDK/javadoc/ro/sync/ecss/extensio… So with this extra rule added at the end of all other rules, our base "DITA" and "DITA Map" frameworks will be applied on any kind of specialized DITA XML topic or map, without the end user having to create a special DITA framework extension to match their type of documents. But once people start to create DITA framework extensions (like you do) for special DTD public ID, this extra rule placed at the end would no longer be necessary to you because you know that your topics and maps refer to specific DTDs. So I think it's correct that you are only using some very specific association rules in your DITA framework customization which no longer include our "DITATopicCustomRuleMatcher" class. About this behavior: > but I think I'm seeing that after I remove all but the necessary rules > from a particular framework, after some time, additional rules are > added. When I close and save the framework, sometime later I go back > and there are rules that match on Root Local Name .. concept, task, > reference, etc. .. I'd swear I didn't add those. Do I have gremlins, > or is this a feature? This would be a bug, but we would need some way to consistently reproduce it. Regards, Radu Radu Coravu Oxygen XML Editor On 10/18/23 01:54, Scott Prentice wrote: > I've got two different DITA models that are similar, and each may be > edited at the same time in Oxygen. Their DTDs are different and use > different Public IDs. I'm developing a framework for each which > applies slightly different schematron validation and CSS styling. It's > my understanding that I should be able to target each model using the > Association Rules, and in general this seems to work fine. > > Since I'm trying to be very specific about which documents are to use > each framework, I thought I'd keep the Association Rules to a minimum, > basically just the specific Public IDs. It's my understanding that if > a document matches any one of these rules, the framework will be > applied .. so no need to include extra match rules .. right? > > One association rule that I see on many DITA frameworks is a Java > Class rule of .. > > ro.sync.ecss.extensions.dita.topic.DITATopicCustomRuleMatcher > > Can someone tell me what this does and is it needed in all cases? > > Also .. and I may be mistaken .. but I think I'm seeing that after I > remove all but the necessary rules from a particular framework, after > some time, additional rules are added. When I close and save the > framework, sometime later I go back and there are rules that match on > Root Local Name .. concept, task, reference, etc. .. I'd swear I > didn't add those. Do I have gremlins, or is this a feature? > > Thanks! > > ...scott > > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 1

Association Rules in frameworks
by Scott Prentice 17 Oct '23

17 Oct '23

I've got two different DITA models that are similar, and each may be edited at the same time in Oxygen. Their DTDs are different and use different Public IDs. I'm developing a framework for each which applies slightly different schematron validation and CSS styling. It's my understanding that I should be able to target each model using the Association Rules, and in general this seems to work fine. Since I'm trying to be very specific about which documents are to use each framework, I thought I'd keep the Association Rules to a minimum, basically just the specific Public IDs. It's my understanding that if a document matches any one of these rules, the framework will be applied .. so no need to include extra match rules .. right? One association rule that I see on many DITA frameworks is a Java Class rule of .. ro.sync.ecss.extensions.dita.topic.DITATopicCustomRuleMatcher Can someone tell me what this does and is it needed in all cases? Also .. and I may be mistaken .. but I think I'm seeing that after I remove all but the necessary rules from a particular framework, after some time, additional rules are added. When I close and save the framework, sometime later I go back and there are rules that match on Root Local Name .. concept, task, reference, etc. .. I'd swear I didn't add those. Do I have gremlins, or is this a feature? Thanks! ...scott

1 0

[ANN] Webinar: Oxygen AI Positron - Transforming Technical Content Creation through AI-Powered Writing (October 25)
by Alin Belu 16 Oct '23

16 Oct '23

Hello, The introduction of OpenAI's ChatGPT has unlocked a world of possibilities for revolutionizing technical content creation. In our upcoming webinar, taking place on the *25th of October*, Alex Jitianu (Software Architect at Syncro Soft) will explore how AI can be a game-changer in content creation and introduce you to the great functionalities of the *Oxygen AI Positron Assistant* add-on, your trusted writing companion. In this 1-hour live session, a range of exciting topics will be covered, including: * *Various scenarios and workflows* made possible by the Oxygen AI Positron Assistant, showcasing how AI can enhance your content creation processes. * Exploring the *wide range of available actions* and showcasing how these actions can be invoked, refined, and previewed using the visual diff feature to easily understand the document changes. * How to *define and share your AI processing*, granting you greater customization and flexibility in your writing projects. * How to*improve AI understanding and accuracy* by providing examples in the editing area, ensuring consistent and correct responses from the AI. * The availability of *Oxygen AI Positron Assistant in the Web Author platform*, bringing AI assistance directly to your web-based content creation. Don't miss this opportunity to explore the future of content creation with AI! This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2023-11.html We would also like to invite you to join us for our next upcoming webinars: * November 1, 2023 - What is new in Oxygen XML Web Author 26 ( https://oxygenxml.com/evs2023-12.html ) * November 8, 2023 - Introducing Oxygen JSON Editor - The Ultimate Solution for JSON Editing ( https://oxygenxml.com/evs2023-13.html ) * November 15, 2023 - Discover the New Search Enhancements of Oxygen Feedback 4.0 ( https://oxygenxml.com/evs2023-14.html ) * November 22, 2023 - Exploring Oxygen's YAML Support ( https://oxygenxml.com/evs2023-15.html ) * November 29, 2023 - Discover the Power of Diff with Change Tracking ( https://oxygenxml.com/evs2023-16.html ) Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Version 26 of the Oxygen XML Suite of Products is Now Available!
by Alin Belu 11 Oct '23

11 Oct '23

Hello everyone, We are incredibly proud to announce the immediate availability of *version 26* of our industry-leading XML suite of products: *Oxygen XML Editor*, *Author*, *Developer*, *Web Author*, *Publishing Engine*, *WebHelp*, *PDF Chemistry*, and *Scripting*, as well as the launch of its newest product, *Oxygen JSON Editor,* an affordable subscription-based application designed specifically for editing JSON and JSON Schema documents. This release introduces the exciting new *Oxygen AI Positron Assistant*, an add-on that provides a powerful tool to help writers *increase their productivity* by performing repetitive tasks, reviewing grammar, generating structure and text, or proposing changes to improve readability. It always *keeps the writer in control*, offering a visual diff comparison to help quickly understand what changed and the ability to continue the chat with the AI to refine the proposals. There is new functionality available for *DITA users*, *XSLT/XQuery developers*, as well as for *JSON/YAML developers*. It is now possible to generate *comparison results as documents containing change tracking highlights* to allow the changes to be rendered visually in the resulting documents, making it easy to review, accept, or reject them. This feature is also available via scripts to enable automation. Some of our popular*add-ons* were updated such as *Git Client*, *Batch Documents Converter*, and *OpenAPI Documentation Generator*. As always, this release also provides various important component updates, such as *DITA-OT* and *Saxon*, bug fixes, and security enhancements. *Oxygen XML Web Author version 26* provides a preview of *Oxygen **AI Positron Assistant* on the Web Author demo server, allowing users to experiment with a variety of AI-powered actions meant to improve their overall productivity. It will be available for Web Author on-premise installations very soon. Web Author also received component updates and improvements related to *file comparisons*, *DITA editing*, and *security*. ============================================================================= *What's New in Oxygen XML Editor 26* One of the most anticipated and innovative additions in Oxygen 26 is the *Oxygen AI Positron Assistant*, an add-on that provides a powerful tool to help writers use AI-generated content to *enhance their overall productivity* while keeping them in *full control of the changes* made to the documents, allowing them to see exactly what is modified using the powerful visual XML-aware diff comparison tool provided by Oxygen. Users benefit from a set of fine-tuned predefined actions that enable them to: * *Generate content* such as DITA topics, document fragments, short descriptions, and index terms. **Improve existing content* in terms of grammar, readability, and the use of active voice. * *Get various insights* to understand how readable the content is and how it responds to questions. * *Translate**to various languages* while preserving the XML structure. * *Write better marketing messages* with support for generating press releases, marketing posts, or applying marketing frameworks. Users can define their own *custom AI actions* or *favorite prompts* and easily share them with other project members. Oxygen AI Positron Assistant offers *intelligent support to help resolve document validation problems* with an innovative variant of a quick-fix called *AI-fix* that asks the AI engine to find a solution for a validation problem and applies its suggestion. For complex and repetitive tasks that the AI may not be able to accurately complete without assistance, it is possible to *record a set of instructions* for the AI to follow and the final result can be saved as a custom AI action or as a favorite prompt. Furthermore, the AI functionality is made available via two *XPath AI functions* that enable the use of AI from any language that uses XPath expressions such as XSLT, XQuery, and Schematron. For example, it is possible to create XSLT-based XML refactoring actions that can batch process multiple documents, applying AI functionality on them, or to define Schematron Quick-Fixes that utilize the AI functions. *DITA authors* can take advantage of a simplified process of extracting and organizing parts of a document into separate topics with the ability to *extract a selection of content into a new DITA topic*, better *i18n support*, and the use of the existing DITAVAL filter files to automatically apply colors and styles to render the content in the editor. *JSON developers* can more easily navigate through large documents since the JSON diagram editor now has its own *dedicated outline view*. When *changing a property in the JSON diagram editor*, all the references to that property are now automatically updated, saving the user time and effort by eliminating the need to manually update the schema and preventing any inconsistencies or errors. Additionally, if no JSON schema is associated with a JSON document, Oxygen can now *learn the document structure* by parsing the document internally and using that as an inferred schema to provide content completion and validation. *YAML developers* now have full support for creating, editing, and validating YAML documents. They have access to new actions, such as the *go to the definition action* that allows for easy navigation to the definition of the current property and another action to *easily open the associated schema for the YAML document*. When creating new YAML documents, the new document wizard now includes a *Customize* option that enables users to configure the generation of new YAML documents based on a specified JSON Schema, ensuring consistency and adherence to predefined rules. For *XSLT and XQuery users*, the built-in Saxon processor used for*transformations and debugging* was updated to version 12.3. Oxygen's support has been enhanced to handle the latest extension functions supported by Saxon. The *Extract Function* refactoring action was improved to better handle XPath expressions. Additionally, two new AI-based extension functions (contributed by the Oxygen AI Positron Assistant add-on) that can be used to rephrase content and to perform validation checks on the existing content are available in the content completion for XSLT, XQuery, XPath, and Schematron. The support to generate *comparison results as documents containing change tracking highlights* is available for both document and directory comparison tools, allowing the changes to be rendered visually in the resulting documents, making it easy to review, accept, or reject them, or enabling the users to publish them and highlight the modified content. These tools are also available as *scripts* for those who are interested in automating these processes, using the Oxygen XML Scripting license. Some of the most popular add-ons were updated. The *Git Client* add-on now comes with integration of *Large File Support (LFS)*, among many other new additions. The *Batch Documents Converter* add-on received various improvements when converting OpenAPI to DITA, Word to HTML/DITA, or Confluence to DITA, and the *OpenAPI Documentation Generator* add-on now has the option to transform the OpenAPI content into DITA output, along with several other enhancements. Other improvements include enhanced coverage for *HTTPS certificate validation in corporate environments by utilizing trusted root certificates from the Windows certificate store*, improved syntax highlighting for *Markdown documents containing LaTeX equations* that allows for more efficient editing and seamless integration of mathematical expressions, and as usual, this release includes several important *component updates*, *bug fixes*, and *security enhancements*. This short video highlights the most important additions to Oxygen XML Editor version 26: https://youtu.be/fWvqYpGtJmw For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html ============================================================================= *Introducing a New Product: Oxygen JSON Editor* JSON developers will be thrilled with the launch of the new *Oxygen JSON Editor*. This specialized product is *designed for editing JSON and JSON Schema documents*, as well as other JSON-related technologies. What sets the Oxygen JSON Editor apart is its *affordable subscription-based pricing option*. Now, developers can *access powerful JSON editing capabilities at a reasonable cost, without compromising on quality*. For more information, see: https://www.oxygenxml.com/json_editor/whats_new.html ============================================================================= *What's New in Oxygen XML Web Author 26* One of the most exciting new features is the preview of the new *Oxygen AI Positron Assistant* plugin that provides a powerful tool to help writers *use AI-generated content*, available now on the Web Author demo server (https://www.oxygenxml.com/oxygen-xml-web-author/app/oxygen.html) and soon to be available for Web Author on-premise installations. The plugin contributes a side pane that offers a variety of *AI-powered actions* with the goal of *improving productivity*. Actions are available to provide helpful hints for the next writing steps, enhance the readability of existing content, correct grammar errors, generate index terms, translate content, create marketing-related material, or even restructure parts of a document. Interface improvements make it *easier to insert special characters*, users can now *edit Mermaid diagrams in the editor*, tracked changes are more visible when renaming elements, and static text labels are now translated properly for the Chinese language. The ability to *merge changes when comparing two documents* is now available to ensure a more accurate and efficient collaboration on documents and users can now trigger comparisons of specific document versions directly from the Version History dialog box. The *Concurrent Editing* feature now works with a *high availability deployment* consisting of two servers to help mitigate the possibility of losing connections, while also providing a higher capacity, as it can accommodate more users. DITA authors now have multiple convenient ways to *edit profiling attributes* within the editor or in the Attributes side-pane and it is now much *easier to create and insert topic references* when editing DITA maps. This short video highlights the most important additions to Oxygen XML Web Author version 26: https://youtu.be/IQKzB3pJnXY For more information, see: https://www.oxygenxml.com/xml_web_author/whats_new.html ============================================================================= *What's New in Oxygen Publishing Engine 26* *Oxygen Publishing Engine version 26 *encompasses the improvements and additions implemented in *Oxygen XML WebHelp* and *Oxygen PDF Chemistry*. This latest release offers some exciting new search features for WebHelp publishers, new customization possibilities for PDF publishers, and the bundled DITA-OT distribution was updated to version 4.1.1. Various other component updates and bug fixes were implemented as well. *Oxygen XML WebHelp version 26* introduces some exciting advanced search features that were implemented in conjunction with the upcoming 4.0 release of *Oxygen Feedback*. Once *Oxygen Feedback 4.0* will be released, WebHelp publishers will have access to *Semantic Search*, which will enhance the accuracy of search results for the end user and they will be able to configure *Faceted Search* functionality in the WebHelp output, enabling users to refine their search results by applying multiple filters that correspond to different facets of the information they are seeking. The introduction of *Labels* in the WebHelp output will make it effortless to search for topics with the same label. Furthermore, the integration with the *Oxygen Feedback Search Engine* will support advanced query syntax, giving users the ability to create complex and flexible queries that generate precise search results. *Oxygen PDF Chemistry version 26* is the latest release for the CSS Paged Media processor used for obtaining PDF output from HTML or XML documents through CSS styling. This version brings the possibility of setting the *width* property on top or bottom page margin boxes to better customize documents when displaying page numbers, publication titles, or other artwork and XPath expressions can be used inside SVG templates to insert dynamic text when creating the PDF output. For more information, see: https://www.oxygenxml.com/publishing_engine/whats_new.html ============================================================================= *DITA-OT Day 2024* On the *11th of February, 2024*, Oxygen XML Editor organizes the 8th edition of the *DITA-OT Day conference in Helsinki, Finland*, a full day, in-person event dedicated to the DITA Open Toolkit project, which is the reference DITA implementation and the core of almost all DITA-based publishing solutions (Oxygen included). Find out more details and registration information at https://www.oxygenxml.com/events/2024/dita-ot_day.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

Webhelp from DITA sources: Control tooltip display in glossary links
by Franz-Josef Knelangen 27 Sep '23

27 Sep '23

Hi there, we have glossary links in our topics, and hovering over them shows them as tooltip. That's fine as long as these entries are not too long. [cid:image001.png@01D9F11C.2B0E5C40] If the glossentry contains a table with a format description, it's no fun to read it: [cid:image002.png@01D9F11C.2B0E5C40] I tried to put the table in an element outside "glossterm" and "glossdef" = "glossBody/glossUsage" but that didn't change anything - still the whole entry is displayed as tooltip. Is there a way to control this? Do you have any workarounds or tips dealing with this situation? TIA and 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.)

1 0

[ANN] Introducing Oxygen Git Client add-on version 5.3.0!
by Alin Belu 21 Sep '23

21 Sep '23

Hello everyone, We are happy to introduce you to *version 5.3.0* of the *Oxygen Git Client add-on*, your trusted companion for Git-related tasks, making version control and collaboration smoother and more efficient! The newest release of our add-on comes with the following key improvements: * *Enhanced Oxygen project detection.* We've fine-tuned our Oxygen project detection to ensure it works more smoothly, saving you valuable time and effort. * *Submodule precision.* Now, when you check out a branch, submodules in parent repositories will be checked out at the index defined in the parent repository. This means your submodules will always reflect the precise state of the parent repository at that time, ensuring your projects stay in sync. For more information on the Oxygen Git Client add-on (including the installation steps), you can check the page below: https://www.oxygenxml.com/doc/ug-editor/topics/git-addon.html We hope that you will enjoy using the most recent release of the add-on as much as we enjoyed developing it. As always, your feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Refactoring functionality
by Oudkerk, Judith 18 Sep '23

18 Sep '23

Hello, I was wondering if you can use the refactoring functionality do the following: Replace all <entry>TEXT</entry> elements with <entry><p>TEXT</p></entry>. In other words, add a <p> element to all entry elements that already contain text (without a <p> element). I’m using Oxygen XML with Eclipse (and the Ixiasoft CCMS Web 6.3 version). I’ve been looking into the refactoring functionality, but I can’t find a way to do this. Thanks in advance for your help. Kind regards, Judith Restricted Information and Basic Personal Data Judith Oudkerk | Technical Writer ELEKTA | Nucletron P.O. Box 930, 3900 AX, Veenendaal, The Netherlands Visiting Address: Waardgelder 1, 3905 TH Veenendaal Judith.Oudkerk(a)elekta.com<mailto:Judith.Oudkerk@elekta.com> | www.elekta.com<https://www.elekta.com/> Nucletron B.V., registered 2730 3235 Nucletron Operations B.V., registered 30129540 [cid:image290631.png@17E70B0A.561E8CC3] This message is confidential and may be legally privileged or otherwise protected from disclosure. If you are not the intended recipient, please telephone or email the sender and delete this message and any attachment from your system; you must not copy or disclose the contents of this message or any attachment to any other person. Any views expressed in this message are those of the individual sender, except where the sender specifies and with authority, states them to be the views of Elekta. Elekta may monitor email traffic data. Restricted Information and Basic Personal Data

1 0

[ANN] Get Ready for DITA-OT Day 2024! (February 11, Helsinki)
by Alin Belu 15 Sep '23

15 Sep '23

Hello everyone, We have some amazing news for you! *DITA-OT Day* is returning for its *8th edition*, taking place this time in *Helsinki, Finland*, on *February 11, 2024*! The full day conference dedicated to the DITA Open Toolkit project, the core of almost all DITA-based publishing solutions, is a free and in-person event. All you have to do to be a part of this event is to register for on-site participation, by filling out the form that is found on the DITA-OT Day 2024 event page - https://www.oxygenxml.com/events/2024/dita-ot_day.html#free-registration . Furthermore, it is important to note that DITA-OT Day coincides with the pre-conference day of DITA Europe, both taking place at the Scandic Park Helsinki hotel. The call for proposals is currently in progress, and we are actively seeking speakers who can address topics related to DITA-OT! Along with the usual updates on new features and plans, this year we want to focus on the people and teams using DITA-OT. Take a look at the Call for Proposals section for more information on how to submit your proposal and the deadline:https://www.oxygenxml.com/events/2024/dita-ot_day.html#call-for-pr… . We look forward to seeing you in Helsinki! PS: In case you missed the opportunity to attend prior events or if you simply want to refresh your memory, you can access the recordings from past DITA-OT Day conferences at: https://www.oxygenxml.com/events/2024/dita-ot_day.html#related-events -- Alin Belu Oxygen XML Editor

1 0

How to get Oxygen to generate an instance containing 100 child elements?
by Roger L Costello 06 Sep '23

06 Sep '23

Hello Oxygen team, I am using Oxygen to generate a sample XML instance from an XSD. Here's my simple XSD: <xs:schema xmlns:xs=http://www.w3.org/2001/XMLSchema> <xs:element name="test"> <xs:complexType> <xs:choice maxOccurs="unbounded"> <xs:element name="A" fixed="A"/> <xs:element name="B" fixed="B"/> <xs:element name="C" fixed="C"/> </xs:choice> </xs:complexType> </xs:element> </xs:schema> Notice the repeatable xs:choice. I then selected Tools >> Generate Sample XML Files ... I want the tool to repeat the xs:choice 100 times. I "think" that I have specified this correctly. See screenshot below. However, the tool only repeats the xs:choice 16 times. Why is that? How to get the tool to generate 100 child elements? [cid:image001.png@01D9E0D1.F71DEAE0]

1 0

[ANN] Join Oxygen XML at tcworld Conference 2023 (Stuttgart, 14-16 November)
by Alin Belu 22 Aug '23

22 Aug '23

Hello everyone, Between the *14th* and the *16th of November*, the Oxygen XML team will exhibit and present at the *tcworld Conference 2023*, the event that brings together participants, speakers, students, and exhibitors in "technical communication" from all over the world to the largest industry meeting place – once again in *the ICS of Messe Stuttgart*! There, you will get the chance to meet a part of the Oxygen team in-person (*George Bina*, *Radu Coravu*,*Alex Jitianu*,*Octavian Nadolu,***and *Sorin Carbunaru*) 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, we prepared for you a great agenda that looks like this: *Wednesday, November 15, 10:45 – 11:15 AM (CET)** **The AI revolution - What's in it for the DITA writers? (DITA Arena) - Sorin Carbunaru* /ChatGPT took the world by storm. While some took shelter, others chose to spread their wings, ride the winds of change, and explore the new possibilities. So where exactly did these winds take the little DITA finch?// //In this presentation, we'll see what new prospects were opened up by AI for DITA content creators, as they are an excellent fit for AI adoption. Why? Because they can use it to boost their productivity, while also keeping the control in their hands by ensuring the content they deliver to the end-users is accurate./ *Wednesday, November 15, 11:30 – 12:15 (CET)** **Harnessing the Power of AI: Enhancing Technical Content Creation with Intelligent Prompts (Presentation) - Alex Jitianu* /In the past few years, the integration of Artificial Intelligence (AI) into various software development tools has witnessed remarkable growth, like the creation of GitHub Copilot software developer assistant. However, the potential of AI extends far beyond code completion. In this presentation, we will explore how AI can revolutionize content creation. We will delve into ways in which AI-powered prompts can serve as valuable writing companions./ *Thursday, November 16, 11:30 – 12:15 (CET)** **Practical Git Workflows for Tech Docs (Presentation) - Radu Coravu* /In this presentation, our main focus will be on the practical aspects and workflows of using Git as a version control system for technical documentation with the DITA XML standard. We will explore how a DITA XML documentation project can be stored on a Git repository along with common settings.// //Throughout the presentation, we will discuss the common editing and collaboration workflows for technical writers utilizing Git repositories. We'll also address storing shared editing and publishing settings, ensuring seamless updates, edits, content commits, and conflict resolution./ For more informations regarding Oxygen XML's participation at tcworld Conference 2023, check out the following link: https://www.oxygenxml.com/events/2023/tcworld_conference_2023.html We can't wait to see you all in Stuttgart! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

How to prevent Format and Indent from modifying the content of specific elements?
by Roger L Costello 14 Aug '23

14 Aug '23

I have an XML document with elements that contain JSON code, e.g., <schema> "$schema": https://json-schema.org/draft/2020-12/schema, "type": "object", "properties": { "password": {"type": "string", "writeOnly": true} } </schema> When I click on the Format and Indent icon, I do not want that content to be changed. Is there a way to instruct Oxygen, "Hey, don't change the content of the <schema> element."? /Roger

2 1

Re: [oXygen-user] [OXYGEN-6052] Why is the JSON Schema $anchor not supported?
by Oxygen XML Editor Support (Florin Nica) 08 Aug '23

08 Aug '23

Hi Roger, The library is called /json-sKema/. You can check its GitHub repository for more details: https://github.com/erosb/json-sKema. Regards, Florin On 08/05/23 2:18 PM, Roger L Costello wrote: > > Florin Nica wrote: > > * We plan to provide full support for JSON Schema /Draft 2020-12/ in > the near future by using another library. > > Would you mind telling me what library (JSON Schema validator tool) > that you will be adding into Oxygen? (I can understand if you do not > wish to tell me.) > > /Roger > > *From:*oXygen-user <oxygen-user-bounces(a)oxygenxml.com> *On Behalf Of > *Oxygen XML Editor Support (Florin Nica) > *Sent:* Tuesday, June 27, 2023 4:01 AM > *To:* oxygen-user(a)oxygenxml.com > *Subject:* [EXT] Re: [oXygen-user] [OXYGEN-6052] Why is the JSON > Schema $anchor not supported? > > Hi Roger, Thank you very much for the feedback. We use a third-party > library for JSON Schema validation and, unfortunately, it does not > support the "$anchor" and "$dynamicAnchor" keywords. This is mentioned > as a limitation in our user-guide, > > ZjQcmQRYFpfptBannerStart > > Hi Roger, > > Thank you very much for the feedback. > > We use a third-party library for JSON Schema validation and, > unfortunately, it does not support the "$anchor" and "$dynamicAnchor" > keywords. This is mentioned as a limitation in our user-guide > <https://www.oxygenxml.com/doc/versions/25.1/ug-editor/topics/json-validatin…>, > but, indeed, the message displayed for "$anchor" is not accurate at all. > > We plan to provide full support for JSON Schema /Draft 2020-12/ in the > near future by using another library. I will let you know when this > support is ready. > > Regards, > Florin > > On 6/22/2023 9:25 PM, Roger L Costello wrote: > > When I add "$anchor" to my JSON Schema, the Oxygen editor gives this error message: > > The keyword "$anchor" is not part of > > JSON Schema Draft 2020-12 specification. > > Therefore, it is ignored by the validation engine. > > But that's not true. See section 8.2.2 of the 2020-12 specification (https://json-schema.org/draft/2020-12/json-schema-core.html#section-8.2.2) > > Using JSON Pointer fragments requires knowledge of the structure of the schema. When writing schema documents with the intention to provide re-usable schemas, it may be preferable to use a plain name fragment that is not tied to any particular structural location. This allows a subschema to be relocated without requiring JSON Pointer references to be updated. > > The "$anchor" and "$dynamicAnchor" keywords are used to specify such fragments. They are identifier keywords that can only be used to create plain name fragments, rather than absolute URIs as seen with "$id"... > > _______________________________________________ > > oXygen-user mailing list > > oXygen-user(a)oxygenxml.com <mailto:oXygen-user@oxygenxml.com> > > https://www.oxygenxml.com/mailman/listinfo/oxygen-user > > -- > Florin Nica > <oXygen/> XML Editor > www.oxygenxml.com <http://www.oxygenxml.com> > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user -- Florin Nica <oXygen/> XML Editor www.oxygenxml.com

1 0

Re: [oXygen-user] [OXYGEN-6052] Why is the JSON Schema $anchor not supported?
by Oxygen XML Editor Support (Florin Nica) 05 Aug '23

05 Aug '23

Hi Roger, Thank you very much for the feedback. We use a third-party library for JSON Schema validation and, unfortunately, it does not support the "$anchor" and "$dynamicAnchor" keywords. This is mentioned as a limitation in our user-guide <https://www.oxygenxml.com/doc/versions/25.1/ug-editor/topics/json-validatin…>, but, indeed, the message displayed for "$anchor" is not accurate at all. We plan to provide full support for JSON Schema /Draft 2020-12/ in the near future by using another library. I will let you know when this support is ready. Regards, Florin On 6/22/2023 9:25 PM, Roger L Costello wrote: > When I add "$anchor" to my JSON Schema, the Oxygen editor gives this error message: > > The keyword "$anchor" is not part of > JSON Schema Draft 2020-12 specification. > Therefore, it is ignored by the validation engine. > > But that's not true. See section 8.2.2 of the 2020-12 specification (https://json-schema.org/draft/2020-12/json-schema-core.html#section-8.2.2) > > Using JSON Pointer fragments requires knowledge of the structure of the schema. When writing schema documents with the intention to provide re-usable schemas, it may be preferable to use a plain name fragment that is not tied to any particular structural location. This allows a subschema to be relocated without requiring JSON Pointer references to be updated. > > The "$anchor" and "$dynamicAnchor" keywords are used to specify such fragments. They are identifier keywords that can only be used to create plain name fragments, rather than absolute URIs as seen with "$id"... > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user > -- Florin Nica <oXygen/> XML Editor www.oxygenxml.com

2 1

[ANN] Discover what's new in Oxygen Git Client add-on version 5.2.0!
by Alin Belu 01 Aug '23

01 Aug '23

Hello everyone, We are thrilled to announce the release of *version 5.2.0* for the*Oxygen Git Client add-on*! This newest update brings an array of new features and improvements, the most important being the introduction of *Large File Support (LFS)* to the Oxygen Git Client. If you have installed LFS and specified which extensions represent large or binary files that should be uploaded through the LFS mechanism, they will be automatically detected and handled correctly. This ensures a smoother and more seamless handling of large files, improving your version control process overall. Additionally, version 5.2.0 offers *improved messages in the user interface* to provide clearer and more informative notifications, making your interaction with the Git Client more intuitive and user-friendly. It's also worth mentioning that now, when you clone a repository, the Git Client will automatically detect and open Oxygen project files. This feature simplifies the process of working with Oxygen projects that are stored in a Git repository. Other improvements added in version 5.2.0 of the Oxygen Git Client add-on include: * The absolute path to the working copy is now displayed in the tooltip of the Git Staging view's working copy combo box. * Enhanced remote change detection and refresh in History view for improved performance. * An issue has been fixed where untracked files were previously not being restored from a stash. * The integrated JGit library was upgraded to version 6.5. * Other bug fixes. For more information on the *Oxygen Git Client add-on* (including the installation steps), you can check the page below: https://www.oxygenxml.com/doc/ug-editor/topics/git-addon.html We hope that you will enjoy using the latest release of this add-on as much as we enjoyed developing it. As always, your feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Version 5.2.0 of the Oxygen Batch Documents Converter add-on is now available!
by Alin Belu 24 Jul '23

24 Jul '23

Hello everyone, We are happy to announce that *version 5.2.0* of the *Oxygen Batch Documents Converter add-on* is now available! For the newest version of the add-on, our team of developers worked hard to bring you the following list of fixes and improvements to make sure that your document conversion process gets to be even smoother: *OpenAPI to DITA* * OpenAPI to DITA conversion now supports "*/*" MIME type documents. * Correct IDs are generated on topics with OpenAPI tags containing multiple words separated by spaces. * Preserve descriptions from responses during OpenAPI v2 conversion. *Word to HTML/DITA* * Tables from Word to HTML/DITA conversion now have 'frame', 'rowsep', and 'colsep' attributes. * No more duplicate IDs on resulting tables. * Default configuration for codeblocks in Word Styles Mapping table added. * Custom styles based on a normal style that don't have a Word style mapping are now properly reported as unknown. *Confluence to DITA* * Confluence to DITA conversion now handles duplicate IDs without errors. * Image paths no longer contain queries, preventing publishing errors. *Others* * Updated JTidy library to version 1.0.4. * Minimum required version of Oxygen increased to 25.1. * Removed the Jackson libraries as they are already available in Oxygen. For more information on the Oxygen Batch Documents Converter add-on (including the installation steps), you can check the page below: https://www.oxygenxml.com/doc/ug-editor/topics/batch-converter-addon.html We sincerely hope you will find this add-on helpful, and as usual, we appreciate your feedback! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: Introducing Oxygen Content Fusion 6.0 Beta (July 26, 2023)
by Alin Belu 18 Jul '23

18 Jul '23

Hello, With the release of the Beta version of Oxygen Content Fusion 6.0, we aimed to enhance the DITA documentation review and publishing processes for the advanced online collaboration platform. As we approach the full release, we highly value your feedback and invite you to actively participate in shaping the final version of Oxygen Content Fusion 6.0, as your insights will play a crucial role in refining this cutting-edge collaboration platform. Thus, next week, on the *26th of July*, join us for the exclusive webinar titled*Introducing Oxygen Content Fusion 6.0 Beta*, where Cristian Talau (project manager at Syncro Soft) will showcase the significant improvements and features of Oxygen Content Fusion 6.0 Beta. The topics of this webinar will focus on the following features and improvements of Oxygen Content Fusion 6.0 Beta: * *Projects:* Seamlessly integrate with Git repositories to track reviewers feedback on dedicated branches for each review task. * *Enhanced Publishing Capabilities:* Effortlessly generate WebHelp or PDF outputs with new publishing features. Customize the output via the integrated Oxygen Styles Basket visual customization tool, providing easy and flexible customization options. * *Improved Review Workflow:* Review task owners now have the ability to close a review, allowing time to address feedback effectively. * *Optimized User Experience:* Alongside the introduction of numerous new features, Oxygen Content Fusion's user interface has undergone enhancements, now offering an improved and refreshed look and feel. This is a free event, but registration is required. You can register at https://www.oxygenxml.com/evs2023-9.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

Re: [oXygen-user] [OXYGEN-6406] The text in Oxygen is fuzzy with my new laptop
by Oxygen XML Editor Support (Adrian Buza) 07 Jul '23

07 Jul '23

Hi, I'm guessing this is v25.1 of Oxygen. Please specify if otherwise. The problem is most likely with the Windows scaling setting, probably different for each monitor. The old laptop probably had the same scaling for both (or a single setting system-wide). *Under Windows Settings > Display settings, check the display resolution and "scale and layout" for each monitor.* Currently Oxygen is only System DPI Aware, it is not Per-Monitor DPI Aware. So if you have two monitors (or laptop screen and monitor) with different DPI/scaling settings, it cannot change the scaling dynamically, if move it to another monitor. Oxygen uses the system wide scaling setting (the one of the primary display) detected at application startup, not the monitor-based scaling setting. * **Quick-fix to try, move Oxygen to the monitor you intend to use it on and restart Oxygen.* Regards, Adrian Adrian Buza oXygen XML Editor and Author Support On 06.07.2023 20:21, Roger L Costello wrote: > > Hi Adrian, > > Sorry, I should have provided the OS. I am running Windows 10. It is > the entire UI that is fuzzy. I should also mention that my laptop is > connected to a large monitor; I am viewing Oxygen on the monitor. No > fuzziness viewing Oxygen on the monitor from my old laptop. > > /Roger > > *From:*oXygen-user <oxygen-user-bounces(a)oxygenxml.com> *On Behalf Of > *Oxygen XML Editor Support (Adrian Buza) > *Sent:* Thursday, July 6, 2023 10:15 AM > *To:* oxygen-user(a)oxygenxml.com > *Subject:* [EXT] Re: [oXygen-user] [OXYGEN-6406] The text in Oxygen is > fuzzy with my new laptop > > Hello, On what OS is Oxygen running (macOS/Windows/Linux)? What > version and build of Oxygen are you using (Help > About)? Is the > entire Oxygen UI fuzzy, or just the text in the editor? Regards, > Adrian Adrian Buza oXygen XML Editor and Author > > Hello, > On what OS is Oxygen running (macOS/Windows/Linux)? > What version and build of Oxygen are you using (Help > About)? > Is the entire Oxygen UI fuzzy, or just the text in the editor? > Regards, > Adrian > Adrian Buza > oXygen XML Editor and Author Support > On 06.07.2023 14:45, Roger L Costello wrote: > > I got a new laptop. > > > > When I open a browser everything in the browser screen is sharp and clear. > > > > When I open an XML document in the Oxygen editor the text is fuzzy. Any suggestions on what to do to make the text sharp and clear? > > > > /Roger > > _______________________________________________ > > oXygen-user mailing list > > oXygen-user(a)oxygenxml.com <mailto:oXygen-user@oxygenxml.com> > > https://www.oxygenxml.com/mailman/listinfo/oxygen-user > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com <mailto:oXygen-user@oxygenxml.com> > https://www.oxygenxml.com/mailman/listinfo/oxygen-user > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

1 0

Re: [oXygen-user] [OXYGEN-6406] The text in Oxygen is fuzzy with my new laptop
by Oxygen XML Editor Support (Adrian Buza) 06 Jul '23

06 Jul '23

Hello, On what OS is Oxygen running (macOS/Windows/Linux)? What version and build of Oxygen are you using (Help > About)? Is the entire Oxygen UI fuzzy, or just the text in the editor? Regards, Adrian Adrian Buza oXygen XML Editor and Author Support On 06.07.2023 14:45, Roger L Costello wrote: > I got a new laptop. > > When I open a browser everything in the browser screen is sharp and clear. > > When I open an XML document in the Oxygen editor the text is fuzzy. Any suggestions on what to do to make the text sharp and clear? > > /Roger > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user >

2 1

[ANN] Content Fusion version 6.0 Beta is now available for evaluation!
by Alin Belu 06 Jul '23

06 Jul '23

Hello, We are proud to announce the immediate availability of the *Beta* version for *Oxygen Content Fusion 6.0*, the web collaboration solution for structured documents! *Oxygen Content Fusion 6.0* introduces a lot of interesting and substantial improvements for the online collaboration platform designed to improve the DITA documentation review and publishing processes. Note that this is currently a *Beta* version of the 6.0 release cycle, so user feedback is welcomed and considered especially helpful as we prepare for the full release. Some of the most interesting new features and improvements implemented in this version include: * The new *projects* feature provides a way to manage a DITA project hosted in a Git repository while maintaining full compatibility with your existing workflows and tools without the need for any type of migration. * *Authors can create review tasks inside a project* and reviewers' suggestions are tracked on a dedicated branch in the Git repository. * New publishing features help authors build *WebHelp and PDF outputs*. * Some built-in templates are available for adjusting the look and feel of the WebHelp or PDF output and the *Oxygen Styles Basket has been integrated* to make it very easy to customize the output using CSS styling. * Review task owners now have the *ability to close a review* to give them time to address feedback or make their own changes before integrating them back into the documentation project. * Numerous enhancements were made to the Content Fusion browser interface to make navigation easier and workflows more efficient. * Bug fixes and security enhancements were also implemented, and various internal components were updated. For more information about the Beta version for Oxygen Content Fusion 6.0 and more details of what was added in this version, see: https://www.oxygenxml.com/content_fusion/6_beta.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

The text in Oxygen is fuzzy with my new laptop
by Roger L Costello 06 Jul '23

06 Jul '23

I got a new laptop. When I open a browser everything in the browser screen is sharp and clear. When I open an XML document in the Oxygen editor the text is fuzzy. Any suggestions on what to do to make the text sharp and clear? /Roger

1 0

[Ann] New maintenance build available for oXygen 25.1 (2023070306)
by Oxygen XML Editor Support (Adrian Buza) 04 Jul '23

04 Jul '23

Dear oXygen users, We announce the release of a new maintenance build (2023070306) for oXygen 25.1 (XML Editor, XML Developer, XML Author, XML WebHelp, PDF Chemistry, 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#2023070306 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

[ANN] The new Oxygen AI Positron Assistant brings chat history, editable entries, user-defined actions, and more!
by Alin Belu 03 Jul '23

03 Jul '23

Hello everyone, We are thrilled to introduce you to the newest version of the *Oxygen AI Positron Assistant* add-on! Version 0.9.3 comes with several exciting features, including a *chat history* so you can revisit previous chats and continue where you left off, *editable user entries* in chat to modify conversations and explore different paths, the introduction of *user-defined actions*, and the possibility to *provide project-specific details for more accurate AI responses*. The *AI Positron Chat* now provides an overall improved experience with the addition of the *History* drop down toolbar button that allows you to go back to previous conversations and continue them. You can also*edit prompts* in the chat discussion thread so you can change the conversation and continue from any point if you want to explore a different path. Additionally, the AI response appears incrementally, as soon as the AI starts generating it, and you now have the option to stop the generation of a response early if you do not consider it fit for your needs. Version 0.9.3 also introduces *user-defined AI actions*. The same approach used for defining built-in actions can now be used to specify actions on the client side through the usage of a JSON configuration file. It may even be linked to a project, making it simple to share actions with everyone who works on a certain project. The newest version of the add-on comes with the possibility to provide *additional options for an action*. To avoid creating too many related actions, it is now possible to specify different facets for an action that the user can choose. This can be best seen in the action that generates short descriptions, as it uses this customization to allow users in choosing different writing styles, such as clear or engaging, as well as setting the number of expected sentences that will be generated. The Oxygen AI Positron Assistant now enables you to *configure a context for all prompts* in the AI Positron Assistant Preferences page. This can be set to be project specific and it allows you to pass certain information to all the built-in actions, so that the AI model will generate better and more relevant results, as it becomes more knowledgeable about your context. It is also worth mentioning that the AI Positron *activity messages have been integrated into the AI Chat view* for a more streamlined and consolidated user experience, thus making the AI Activity View not needed anymore. For additional information on the *Oxygen AI Positron Assistant*, including the installation instructions, you can check out this article on the Oxygen XML Blog: https://blog.oxygenxml.com/topics/ai_positron.html For an in-depth presentation of the various features and use cases for the *Oxygen AI Positron Assistant*, you can view the recent recording of the *AI as a Tool for Technical Content Creation* webinar - https://oxygenxml.com/evs2023-7.html We want to remind you that we plan to frequently release new features and improvements, so please let us know what you think about 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] Webinar: Leveraging the Power of AI and Schematron for Content Verification and Correction (July 5, 2023)
by Alin Belu 29 Jun '23

29 Jun '23

Hello, Your journey into the world of AI continues next week, on the *5th of July*, with the *Leveraging the Power of AI and Schematron for Content Verification and Correction* webinar! During this 1-hour live event, Octavian Nadolu (project manager at Syncro Soft) will be exploring the application of AI in conjunction with Schematron and Schematron Quick Fix (SQF) for content verification and correction. He will begin with a comprehensive overview of AI before going on to highlight the potential advantages it brings and shed light on the challenges we may encounter when utilizing AI for these purposes. Don't miss this opportunity to gain valuable insights into the intersection of AI and content validation by exploring topics such as: * Artificial Intelligence (AI) * OpenAI/Generative Pre-trained Transformer * Schematron and Schematron Quick Fixes (SQF) * Implementing AI in Schematron and SQF * Examples of AI-driven Schematron and SQF Solutions * Benefits of Using AI in Schematron and SQF This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2023-8.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

Why is the JSON Schema $anchor not supported?
by Roger L Costello 22 Jun '23

22 Jun '23

When I add "$anchor" to my JSON Schema, the Oxygen editor gives this error message: The keyword "$anchor" is not part of JSON Schema Draft 2020-12 specification. Therefore, it is ignored by the validation engine. But that's not true. See section 8.2.2 of the 2020-12 specification (https://json-schema.org/draft/2020-12/json-schema-core.html#section-8.2.2) Using JSON Pointer fragments requires knowledge of the structure of the schema. When writing schema documents with the intention to provide re-usable schemas, it may be preferable to use a plain name fragment that is not tied to any particular structural location. This allows a subschema to be relocated without requiring JSON Pointer references to be updated. The "$anchor" and "$dynamicAnchor" keywords are used to specify such fragments. They are identifier keywords that can only be used to create plain name fragments, rather than absolute URIs as seen with "$id"...

1 0

[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