- oXygen-user - www.oxygenxml.com

Load external data into form control?
by Scott Prentice 19 Oct '23

19 Oct '23

I'm refining some metadata form controls for a custom framework, and it would be ideal if I was able to load the values and labels for a combobox from an external file (XML or preferably, JSON) rather than hard-coding these values into the CSS. It seems that this may be possible with xpath_eval(). Is anyone aware of any examples of this, or am I heading down a rabbit hole? I'll keep poking at this, but thought I'd see if anyone had thoughts on this effort. Thanks! ...scott

1 0

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