- oXygen-user - www.oxygenxml.com

Re: [oXygen-user] [OXYGEN-15680] Re: Custom action to generate simple dialog?
by Oxygen XML Editor Support (Radu Coravu) 13 Jun '24

13 Jun '24

Hi Scott, Right. We do not have a special Author operation to show a message to the end user. This operation could be used to open a web page if for example you want to present to the end user the information in a web browser: https://www.oxygenxml.com/doc/versions/26.1/ug-editor/topics/dg-default-aut… Regards, Radu Radu Coravu Oxygen XML Editor On 6/13/24 03:06, Scott Prentice wrote: > If you're interested, here's one way to do this. I'm sure there's a > more elegant way and this is probably a bit if a hack, but it does > what I need right now. > > 1. In. your framework's Document Type dialog, on the Author:Actions > subtab, add an action to the framework, give it an ID and a Name. > 2. In the Action dialog select this Operation: > ro.sync.ecss.extensions.commons.operations.JSOperation > 3. A 'script' argument will be added, leave the value empty. > 4. Choose OK. (Leave the Document Type dialog up for now.) > 5. Create a commons.js file in the root of your framework directory, > with the following content .. > > function doOperation(){ > parentFrame = authorAccess.getParentFrame(); > javax.swing.JOptionPane.showMessageDialog(parentFrame, > "MESSAGE HERE"); > } > > 6. In the Document Type dialog, on the Author:Menu subtab, add your > new action to your menu (assuming one exists). > 7. Choose OK, then OK. > > Open a document in Author view that uses your framework. You should > see the new menu item. > > Clearly, if you're already using the commons.js file for something > else, you'll need to pass in some parameter and tweak the JS code .. > but this is a start. :-) > > Cheers, > > Scott > > On 6/12/24 1:32 PM, Scott Prentice wrote: >> >> Hi, >> >> Is there a built-in method for creating an action (to call from a >> toolbar or menu) that displays a simple dialog that contains >> informational text? I'd like to have an "About" dialog that's >> associated with a framework. I assume I can do this by creating a >> custom class, but wanted to see if there was an OOB option for this. >> >> Thanks! >> >> Scott >> >> >> >> >> _______________________________________________ >> oXygen-user mailing list >> oXygen-user(a)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

2 1

Custom action to generate simple dialog?
by Scott Prentice 13 Jun '24

13 Jun '24

Hi, Is there a built-in method for creating an action (to call from a toolbar or menu) that displays a simple dialog that contains informational text? I'd like to have an "About" dialog that's associated with a framework. I assume I can do this by creating a custom class, but wanted to see if there was an OOB option for this. Thanks! Scott

1 1

[ANN] Oxygen AI Positron Assistant 2.1 introduces GPT-4o to its list of models, along with new AI actions!
by Alin Belu 12 Jun '24

12 Jun '24

Hi everyone, We are proud to announce the release of *version 2.1* for *Oxygen AI Positron Assistant*, a powerful tool that helps users increase their productivity by providing support for using AI-generated content within Oxygen tools - Oxygen XML Editor/Author/Developer, Oxygen XML Web Author, and Oxygen Content Fusion. Version 2.1 expands upon the enhancements of the previous version by adding the advanced multi-modal *GPT-4o* to the list of models to choose from. This model is quicker and more cost-effective compared to the GPT-4 Turbo model. For the Enterprise version of Oxygen AI Positron Assistant, the Microsoft Azure OpenAI Service connector now supports *authentication using Microsoft Entra ID*, providing users with improved security and flexibility. Processing content within the editor has gotten even more easier as any content selected in the main editor area is automatically passed as context for the conversation when directly initiating a new chat with the AI. *New AI actions* have been introduced in this version, allowing users to generate, document, or explain specific code snippets, initiate a conversation with the AI regarding certain code snippets, and create alternate text for images. Version 2.1 also introduces three *AI-powered XML refactoring actions* that enable users working with DITA XML topics to generate alternate text for images, generate missing short descriptions, and shorten existing short descriptions. Furthermore, Oxygen XML Web Author users who integrate the /Oxygen AI Positron Assistant Enterprise for Web Author/ plugin now have the ability to filter the list of AI actions. 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: Web Author Customizations - Getting Started (May 22, 2024)
by Alin Belu 14 May '24

14 May '24

Hi everyone, Join us next week, on *May 22nd*, for the grand finale of our spring webinar series! If you are looking to integrate Oxygen XML Web Author into your existing XML workflow, Mihaela Calotescu, software developer at Syncro Soft, will be your perfect guide. Within this 1-hour event, she'll lead you through the initial steps to unlock the full potential of Web Author. During the *Web Author Customizations - Getting Started* webinar, you'll gain invaluable insights and practical guidance on how to: * Connect Oxygen XML Web Author to your file storage system. * Customize the editor to render your XML documents in a WYSIWYG mode. * Create custom actions and help users easily edit your documents. * Create custom validation rules to ensure the integrity and quality of your XML documents. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2024-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

Re: [oXygen-user] [OXYGEN-14931] How to tell Oxygen to abort loading a large XML file?
by Oxygen XML Editor Support (Radu Coravu) 06 May '24

06 May '24

Hi Roger, When you open such a large file in Oxygen, it should allow you to open in huge file editing mode, so maybe the next time you can pick this option: https://www.oxygenxml.com/doc/versions/26.1/ug-editor/topics/huge-file-edit… Or you can try increasing Oxygen's maximum allowed memory: https://www.oxygenxml.com/doc/versions/26.1/ug-editor/topics/increase-memor… Right now Oxygen is probably in an out of memory state, so you should probably kill it. Oxygen saves auto recovery info for all opened files once every 5 minutes by default, so if you re-open Oxygen and then re-open that other XML file which was not saved, Oxygen should prompt you to use the auto recovery info for it. Regards, Radu Radu Coravu Oxygen XML Editor On 5/6/24 17:12, Roger L Costello wrote: > Hi Folks, > > I dragged and dropped a large (167MB) file into Oxygen. I have another memory-intensive operation (which I can't stop) going on at the same time, so Oxygen is taking a long time to load the XML file. It's been 15 minutes thus far and the file is still not loaded. I would like to tell Oxygen that I've changed my mind, don't load it. But Oxygen is completely unresponsive. > > Is there any way, aside from killing the task (and losing all the changes I made but weren't saved), to get Oxygen to abort loading the file? > > /Roger > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user >

1 0

How to tell Oxygen to abort loading a large XML file?
by Roger L Costello 06 May '24

06 May '24

Hi Folks, I dragged and dropped a large (167MB) file into Oxygen. I have another memory-intensive operation (which I can't stop) going on at the same time, so Oxygen is taking a long time to load the XML file. It's been 15 minutes thus far and the file is still not loaded. I would like to tell Oxygen that I've changed my mind, don't load it. But Oxygen is completely unresponsive. Is there any way, aside from killing the task (and losing all the changes I made but weren't saved), to get Oxygen to abort loading the file? /Roger

1 0

[ANN] Access the Oxygen documentation using the new AI Assistant chatbot!
by Alin Belu 30 Apr '24

30 Apr '24

Hi everyone, We want to let you know that we have integrated an experimental *AI Assistant chatbot* into the Oxygen user guides and into the blog: * Oxygen XML Editor - https://www.oxygenxml.com/doc/versions/26.1/ug-editor/ * Oxygen XML Author - https://www.oxygenxml.com/doc/versions/26.1/ug-author/ * Oxygen XML Web Author - https://www.oxygenxml.com/doc/versions/26.1.0/ug-webauthor/ * Oxygen Content Fusion - https://www.oxygenxml.com/doc/versions/6.2/ug-content-fusion/ * Oxygen Feedback - https://www.oxygenxml.com/doc/versions/4.1/ug-feedback-cloud/ * Oxygen XML Blog - https://blog.oxygenxml.com/index.html It's now easier than ever to access information! Simply ask your questions, and the chatbot will provide the answers. Additionally, it will also point you towards the documentation topics or articles where it found the relevant information. Feel free to explore this feature and share your experience with us! We plan to make this as a generally available functionality of the Oxygen Feedback platform. Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: Oxygen AI Positron - Your Helper in All Stages of Content Creation (May 8, 2024)
by Alin Belu 30 Apr '24

30 Apr '24

Hello, Join us next week, on *May 8th*, as we continue our series of Oxygen XML live events with the webinar titled *Oxygen AI Positron: Your Helper in All Stages of Content Creation*! Over the past year, AI services such as ChatGPT have established themselves as valuable tools for content creation and review. However, with each passing month, new advancements emerge. Among these is OpenAI's GPT4 with Vision, which can analyze images, presenting fresh opportunities for workflows and scenarios in the early stages of content development. In this one-hour webinar, Sorin Carbunaru (senior software developer at Syncro Soft) will explore the ways in which AI can transform content creation through the lens of the Oxygen AI Positron Assistant add-on, focusing on the following topics: * The latest developments in the release of *Oxygen AI Positron 2.0*, including the newly added support for Vision. * Techniques for drafting documentation that integrates both content and images. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2024-2.html We would also like to invite you to join us for our upcoming webinar: May 22, 2024 - Web Author Customizations - Getting Started https://oxygenxml.com/evs2024-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

Uncommenting an ENTITY results in a double-comment
by Roger L Costello 24 Apr '24

24 Apr '24

Hello Oxygen folks, I have an ENTITY declaration commented out:  I wanted to uncomment it, so I selected it and then right-mouse-clicked on Toggle Comment. Here's what Oxygen produced:  Eek! Not what I wanted (or expected). Seems like a bug to me. Yes? /Roger

1 0

[Ann] New maintenance build available for oXygen 26.1 (2024042206)
by Oxygen XML Editor Support (Adrian Buza) 24 Apr '24

24 Apr '24

Dear oXygen users, We announce the release of a new maintenance build (2024042206) for oXygen 26.1 (XML Editor, XML Developer, XML Author, JSON Editor, PDF Chemistry, WebHelp, Publishing Engine). The build number can be verified in the Help -> About dialog box from the application (next to the version number). You can download the new installation kits from our web site: http://www.oxygenxml.com/download.html Here you can find the complete list of bug-fixes: http://www.oxygenxml.com/build_history.html#2024042206 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] Oxygen AI Positron Assistant 2.0 adds Vision support and new productivity actions!
by Alin Belu 23 Apr '24

23 Apr '24

Hi everyone, We are proud to announce *version 2.0* of *Oxygen AI Positron Assistant*, the powerful tool that helps users increase their productivity by providing support for using AI-generated content within the Oxygen tools - Oxygen XML Editor/Author/Developer, Oxygen XML Web Author, and Oxygen Content Fusion! Version 2.0 adds support for *Vision* models, allowing the AI to read and interpret images that can be easily added by users to the prompts entered in the Chat window, thus supporting more use cases. A new action called *Generate Documentation Draft* is available that can be used to create a draft DITA topic. This feature provides users with control over the draft generation process, allowing them to specify the context for the new topic, instructions, and images. Furthermore, this version also introduces an action that enables users to get a proposal for updating a DITA topic after they update the images referenced in that topic, by having the AI analyze the new images and propose content changes. Two new variables that can be applied on content with tracked changes were introduced and they can be used to write prompts, enabling users to provide the AI with both the original and modified text and ask the AI engine to analyze the change. Additionally, users now have the ability to filter the list of AI actions and some of the most frequently used actions (e.g. Correct Grammar, Improve Readability, Use Active Voice) are now available as Quick Assist fixes. The Oxygen XML Enterprise edition license for Oxygen XML Editor, Author, and Developer products now includes access to the Oxygen AI Positron Assistant Enterprise add-on at no extra cost (provided their version is 26.0 or later). Moreover, the Enterprise version of the add-on allows users to connect directly to *Anthropic Claude* (in addition to the existing options for OpenAI and Microsoft Azure OpenAI Service). Additionally, from this release forward, Oxygen XML Web Author users also have access to the new Oxygen AI Positron Assistant Enterprise plugin for Web Author. 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

Add full stop to list item in Reusable content
by Oudkerk, Judith 22 Apr '24

22 Apr '24

Hi All, I was wondering if there’s a way to add a full stop to the final list item of reusable content. We have a list of items that are reusable, but each manual may use different list items. Therefore, the final list item may differ per manual. Since our Style guide dictates that only the final list item should have a full stop, it’s quite difficult to manage this list. Is there a way to add a full stop to the end of a list item outside the reusable content? I tried putting the list items in both <p> and <lines> elements, but then the full stop is placed on a new line in the output PDF: XML: PDF: [cid:image001.png@01DA949C.8EB2EA30] [cid:image003.png@01DA949C.C9088A00] Do you have any other ideas or suggestions? Thanks. 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:image717166.png@15A8DF8A.F1E27249] 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

2 2

[ANN] Oxygen XML Users Meetup @ XML Prague 2024
by Alin Belu 18 Apr '24

18 Apr '24

Hi everyone, The XML Prague Conference will take place between the 6th and the 8th of June, 2024, offering a unique opportunity for developers, markup enthusiasts, information managers, and students to come together in person. Continuing its tradition, the Oxygen XML team will be present at the conference, hosting an *Oxygen XML Users Meetup* on *June 6th*. This meetup provides attendees with firsthand insights into the latest developments straight from the dedicated individuals behind the Oxygen XML suite of products. We extend a warm invitation to all of you to join us at this event and discover the cutting-edge solutions and tools we've been developing. Don't miss this opportunity to meet the Oxygen XML team and stay at the forefront of XML innovation! To find out more about the *Oxygen XML Users Meetup* @ XML Prague 2024, you can check the published full agenda, here: https://www.oxygenxml.com/events/2024/oxygen_user_meetup_Prague.html All the best, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: What's New in Oxygen XML Web Author 26.1 (April 24th, 2024)
by Alin Belu 16 Apr '24

16 Apr '24

Hello, Starting next week, on *April 24th*, we kick off our brand-new series of Oxygen XML live webinars! Join us for our first exciting event where we will unveil the latest enhancements in Oxygen XML Web Author 26.1! In the *What's New in Oxygen XML Web Author 26.1* webinar, Bogdan Dumitru (software developer at Syncro Soft) will showcase a range of new features designed to enhance your authoring experience. Here's a sneak peek at some of the highlights that he'll be covering: - *User Authentication*: Enable secure access to Web Author, adding an extra layer of protection to content access and editing. - *AI Positron Assistant*: Experience the power of artificial intelligence with our enhanced Positron Assistant Side View. - *DITA Profiling improvements*: Easily manage and control your content by selectively showing or hiding specific sections based on DITAVAL filters, ensuring that only relevant content is displayed. - *DITA Project File and Context Filtering*: Set a DITA project file and context to filter document content. - *CSS Inspector Pane:* Check and fine-tune the styling and formatting of your content with the new CSS Inspector Pane. This is a free event, but registration is required. You can register at https://oxygenxml.com/evs2024-1.html We would also like to invite you to join us for our next upcoming webinars: * May 8, 2024 - Oxygen AI Positron: Your Helper in All Stages of Content Creation - https://oxygenxml.com/evs2024-2.html * May 22, 2024 - Web Author Customizations - Getting Started - https://oxygenxml.com/evs2024-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 Content Fusion 6.2 is Now Available!
by Alin Belu 09 Apr '24

09 Apr '24

Hello everyone, We are proud to announce the immediate availability for *Oxygen Content Fusion version 6.2*, the web-based collaboration platform for content creation! The focus of this release was to redesign the user interface after analyzing the possible workflows, updating the layout to include more information and making the relevant actions at each step easily accessible, as well as updating the embedded visual editor that is based upon the Oxygen XML Web Author technology. The new layout adjusts the fonts and spacing to include more information on each page, provides intuitive navigation controls and, in some cases, it extends the working area to take advantage of the full width of the page. Users now have the ability to easily find the tasks they want to focus on by filtering the list of review tasks based on the task name. Task management actions can now be performed directly from the task list, so you can delete a task or mark it as integrated directly from the list of your tasks. The task activity view focuses on the changes made in each user interaction, but also provides actions to compare the selected version of the file with the latest version or open the latest version. Content Fusion's visual editor was updated to integrate the latest changes implemented in *Oxygen XML Web Author 26.1.0*. Some of the interesting new features added for the visual editor include the ability for DITA users to easily switch profiling conditions and choose whether to hide the excluded content or show it as grayed out, and the Outline pane also now distinguishes nodes filtered by a DITAVAL file. When Markdown content is pasted within DITA, DocBook, TEI, or XHTML documents, it is automatically converted to the target vocabulary by the smart paste functionality. The Unicode support was improved to better support surrogate characters (e.g. emoji characters) and the text mode is now available in read-only mode for concurrent editing sessions. Additionally, the Split action now automatically inserts required first child elements. When developers create customizations for the Web Author visual editor, they can now use the new CSS Inspector to easily view the styles applied to the selected element. Additionally, a validation process for uploading frameworks was introduced, ensuring that customized frameworks remain error-free. To enhance the filtering capabilities, a new loading option is available that allows plugin developers to control whether content excluded by a DITAVAL filter is displayed as grayed out or completely hidden. Furthermore, a new API that enables the addition of a toolbar in a side view empowers developers to better customize the layout of the side-views contributed by their plugins. For more information, see: https://www.oxygenxml.com/content_fusion/whats_new.html 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

Re: [oXygen-user] [OXYGEN-14072] Add custom catalog to OT build
by Oxygen XML Editor Support (Radu Coravu) 27 Mar '24

27 Mar '24

Hi Scott, As you seem to have a custom DITA OT installation inside your custom framework, why don't you also use it as a default engine for publishing in the Oxygen Preferences->DITA page? Other than that, the DITA OT needs to have a plugin containing extra catalogs (or as a hack you need to manually make changes to the "catalog-dita.xml" inside the DITA OT). There is no possibility to enforce an extra set of XML catalogs from the exterior when starting the DITA OT. At some point I wished there was such a way: https://github.com/dita-ot/dita-ot/issues/1515 Also Jarno Elovirta experimented at some point with a way to install plugins in the DITA OT without the need to change any files in the DITA OT folder itself, this pull request was abandoned though: https://github.com/dita-ot/dita-ot/pull/3152 Regards, Radu Radu Coravu Oxygen XML Editor On 3/27/24 02:08, Scott Prentice wrote: > I've got a custom framework that includes an OT installation that > provides our custom doctype files and custom plugins. Editing topics > that use this custom doctype is handled without problems, and using > transformation scenarios that are supported by the embedded OT also > works fine. But, I'd like to use an OT target that lives in the > default Oxygen OT installation. My Oxygen DITA settings still point to > the "built-in" OT, so when I set up a transformation scenario for the > Oxygen OT target, it starts to work, but fails when it can't find the > custom DTD. > > When I add a pointer from [OXYGEN]/org.dita.base/catalog-dita.xml that > references my custom catalog, the build completes fine. BUT .. I don't > want to modify the default Oxygen installation files. > > Some thoughts .. > > - I don't think there's a param that I can add to the transformation > scenario to reference my custom catalog .. is there? > > - I've tried adding my catalog in Settings > XML > XML Catalog .. but > that didn't seem to have any affect. > > Is there any way to add a custom catalog without editing the default > Oxygen files? > > Currently using Oxygen 25.1. > > Thanks! > > ...scott > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user >

2 1

Add custom catalog to OT build
by Scott Prentice 27 Mar '24

27 Mar '24

I've got a custom framework that includes an OT installation that provides our custom doctype files and custom plugins. Editing topics that use this custom doctype is handled without problems, and using transformation scenarios that are supported by the embedded OT also works fine. But, I'd like to use an OT target that lives in the default Oxygen OT installation. My Oxygen DITA settings still point to the "built-in" OT, so when I set up a transformation scenario for the Oxygen OT target, it starts to work, but fails when it can't find the custom DTD. When I add a pointer from [OXYGEN]/org.dita.base/catalog-dita.xml that references my custom catalog, the build completes fine. BUT .. I don't want to modify the default Oxygen installation files. Some thoughts .. - I don't think there's a param that I can add to the transformation scenario to reference my custom catalog .. is there? - I've tried adding my catalog in Settings > XML > XML Catalog .. but that didn't seem to have any affect. Is there any way to add a custom catalog without editing the default Oxygen files? Currently using Oxygen 25.1. Thanks! ...scott

1 0

[ANN] Version 26.1 of the Oxygen XML Suite of Products is Now Available!
by Alin Belu 25 Mar '24

25 Mar '24

Hello everyone, We are incredibly proud to announce the immediate availability of *version 26.1* of our industry-leading XML suite of products: *Oxygen XML Editor*, *Author*, *Developer*, *Web Author*, *Publishing Engine*, *WebHelp*, *PDF Chemistry*, *Scripting*, and *JSON Editor*. The *Enterprise edition* of Oxygen XML Editor/Author/Developer becomes *AI-ready*, offering access without the need for an additional subscription to the *Oxygen AI Positron Assistant Enterprise* add-on which allows direct connection to OpenAI accounts or to the Microsoft Azure OpenAI Service. Version 26.1 introduces new functionality tailored for *DITA users*, *XSLT/XQuery developers*, and *JSON/YAML developers*, enhancing productivity and versatility across various workflows. The Oxygen Publishing Engine include float support and new CSS properties, providing users with greater control over their PDF output customization. Oxygen Web Author brings support for DITA-OT project files to manage the editing context and improved handling of DITAVAL filters. Additionally, version 26.1 introduces the JSON Schema Validator add-on, facilitating seamless validation of JSON documents against JSON schema. Moreover, the Batch Documents Converter add-on now includes XSD to JSON Schema conversions, expanding its utility. ====================================================================== *What's New in Oxygen XML Editor 26.1* Oxygen XML Editor is an incremental release of the industry-leading bundle of tools for content authors, developers, collaborators, and publishers. Starting with this version, *DITA authors* can now convert sections to new topic files while preserving the DITA topic type, saving time and effort while ensuring that content remains properly structured. When editing DITA topics, several actions listed as proposals are accessible from the content completion window to help make it easier to insert content references and key references. A new option is also available to control whether or not non-DITA resources are automatically converted to DITA when inserting topic references in the DITA Maps Manager, yet another time saving improvement. *DITA publishers* that use the Zendesk Help Center transformation scenario will be happy to know that it now automatically creates and publishes a table of contents and also supports publishing to a subsection. For CSS-based PDF transformations, the new support for prepress print layout ensures that your PDFs are print-ready. The PDF transformation now also automatically fixes some incorrect values for the units of measurement detected in the width/height of images. When running DITA transformations, the real-time progress is constantly updated in the status bar to keep users informed of the current publishing step being processed. *Author mode* improvements include the content completion's Split action now automatically adding required first child elements inside the newly created element, removing extra steps from the editing process. Also, the spell checker now detects spelling errors for text inside two consecutive inline elements without a space in between them, helping to keep content error-free by preventing words from being incorrectly merged together. Some quality of life improvements were also added when using *Markdown*. The Smart Paste mechanism converts Markdown content that is pasted within XML documents in Author mode into the target vocabulary. Syntax highlights are now displayed for other languages embedded within Markdown, making it easy to identify and edit code snippets in different languages. The DITA preview pane now presents colors and filters for profiling attributes, allowing users to visualize their filtered content with ease. *JSON users* now have the power to transform JSON documents using *XSLT transformation scenarios*, unlocking a myriad of new possibilities. The content completion for JSON offers proposals even when no schema is associated and the JSON Outline view can help increase productivity as it now displays the number of child elements in each array's label and also supports drag and drop. Furthermore, basic text editing support was added for*JSON5* documents, and a new *JSON Schema Validator add-on* is available to provide support for validating JSON documents against JSON schema version 2020-12. The *AI Positron Assistant* continues to get impressive updates. A separate Enterprise version of the Oxygen AI Positron Assistant add-on is now available for users who want to connect directly to OpenAI accounts or Microsoft Azure OpenAI Service. New document templates are available to help easily create AI Positron custom actions, unlocking personalized AI solutions. A new AI action is also available to translate content into any desired language. The AI Positron Refactoring action makes it easier than ever to refactor and optimize AI projects and it now works when applied on remote resources. In addition, the chat pane now uses XML syntax highlighting for XML code to make it easier to visualize and understand the AI response. Other features and improvements were added as well. One such feature is the ability to execute Quick fix proposals in bulk, which allows users to resolve multiple issues at once. The latest engines are available for the Saxon XSLT and XQuery Transformer add-on and XProc 3.0 schemas were added to offer support for content completion and validation for XProc 3.0 files. Unique values are now automatically generated for ID-type attributes that are inserted using the Content Completion Assistant, saving time by eliminating the need to manually add them. Also, schema files and new file templates were added to support editing DocBook 5.2 documents and SVG 1.2 Tiny documents. This release also implements a variety of performance improvements, security enhancements, API and component updates, and various bug fixes. For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html ====================================================================== *What's New in Oxygen JSON Editor 26.1* The JSON support added in Oxygen XML Editor/Developer is also available in the Oxygen JSON Editor version 26.1. JSON users now have the power to transform JSON documents utilizing *XSLT transformation scenarios*, access to content completion for JSON even when no schema is associated, JSON Outline view that displays the number of child elements in each array label and also supports drag and drop, basic text editing for *JSON5* documents, and the new *JSON Schema Validator add-on* provides support for validating JSON documents against JSON schema version 2020-12. Furthermore, this release also sees the implementation of various performance improvements, security enhancements, API and component updates, and bug fixes. For more information, see: https://www.oxygenxml.com/json_editor/whats_new.html ====================================================================== *What's New in Oxygen XML Scripting 26.1* The *DITA Validate and Check for Completeness* script received important performance enhancements, significantly reducing the time it takes for the script to finish when using DITAVAL filters. For more information, see: https://www.oxygenxml.com/xml_scripting/whats_new.html ====================================================================== *What's New in Oxygen XML Web Author 26.1* This release has some interesting new features for DITA users, introducing *support for DITA-OT project files* and providing better handling of DITAVAL filters. The DITA Map pane allows users to specify a DITA-OT project file and choose between the contexts defined within it. Users may also easily switch profiling conditions, and there is the option to hide or present as grayed out content that is excluded by the current filter in the document, DITA Maps pane, and in the Outline pane. The AI Positron Assistant's feature for previewing changes was improved to allow choosing which of the AI's proposed changes will be incorporated into users' documents. When dragging a node within the Outline pane, the outline tree automatically scrolls along with the movement to make it easier to precisely drop the node where needed. The Unicode support was improved to better support surrogate characters (e.g. emoji characters) and the text mode is available as read-only mode for concurrent editing sessions. When Markdown content is pasted within DITA, DocBook, TEI, or XHTML documents, it is automatically converted to the target vocabulary by the smart paste functionality. If users develop Web Author customizations, the new CSS Inspector lets them see the styles of the selected element and the process of uploading a framework now includes validation to keep customized frameworks error-free. Server logs are available from the Administration Page to help troubleshoot issues with the Web Author server and some new URL parameters are also available to impose a DITAVAL filter or a DITA-OT project context for filtering the document. Version 26.1 also brings a variety of performance improvements, security enhancements, API and component updates, and bug fixes. For more information, see: https://www.oxygenxml.com/xml_web_author/whats_new.html ====================================================================== *What's New in Oxygen Publishing Engine 26.1* *Oxygen Publishing Engine version 26.1* adds basic float support, automatic fixes for incorrect values for width or height properties, and new CSS properties are available for configuring the PDF output. Additionally, the Zendesk Help Center transformation scenario now automatically creates and publishes a table of contents and supports publishing to a subsection. Furthermore, several performance improvements, component updates, and bug fixes were implemented. For more information, see: https://www.oxygenxml.com/publishing_engine/whats_new.html ====================================================================== *Oxygen XML Users Meetup @ XML Prague 2024* Between the 6th and the 8th of June, 2024, the XML Prague Conference makes its return, offering a unique opportunity for developers, markup enthusiasts, information managers, and students to come together in person. Continuing its tradition, the Oxygen XML team announces its presence at the conference, hosting yet another *Oxygen XML Users Meetup* on *June 6th*. This meetup has become a cornerstone of the event, providing attendees with firsthand insights into the latest developments straight from the dedicated individuals behind the Oxygen XML suite of products. To find out more about this opportunity to connect, collaborate, and stay at the forefront of XML innovation, the event page is available here: https://www.oxygenxml.com/events/2024/oxygen_user_meetup_Prague.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

Re: [oXygen-user] [OXYGEN-13754] QuickFix and DITA default attributes
by Oxygen XML Editor Support (Radu Coravu) 14 Mar '24

14 Mar '24

Hello Jirka, As usually default attributes appear on elements in the Schematron schema and there is no way to know if they have been set in the schema or directly on the XML element. You can use a template to filter out the class attribute, something similar to this older forum thread: https://www.oxygenxml.com/forum/post54152.html#p54152 Regards, Radu Radu Coravu Oxygen XML Editor On 3/13/24 20:36, Jirka Kosek wrote: > Hi, > > I'm creating few small "refactoring actions" using Schematron and > QuickFix for DITA in oXygen. It works except that default attributes > are being copied when some element is copied using QuickFix. For > example the following QuickFix > > <sch:pattern> > <sch:rule context="p"> > <sch:report test="image and > following-sibling::*[1]/self::fig[not(image)]" > sqf:fix="wrap-image">Image is misplaced and not > enclosed by a figure.</sch:report> > > <sqf:fix id="wrap-image"> > <sqf:description> > <sqf:title>Move image into adjacent figure.</sqf:title> > </sqf:description> > <sch:let name="image" value="image"/> > <sqf:delete/> > <sqf:add match="following-sibling::*[1]" position="last-child" > select="$image"/> > </sqf:fix> > > </sch:rule> > </sch:pattern> > > Will move image > > <image href="media/image29.png"/> > > as > > <image class="- topic/image " href="media/image29.png" > placement="inline" > xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/"/> > > I understand that this is perhaps because QuickFix is internally > implemented as XSLT transformation so default attributes are loaded > from DTD during the parsing. I can live with added @class and > @placement, but xmlns:ditaarch namespace declaration instantly > triggers validation error in oXygen which is inconvenient? Is this > something you can fix in next releases? > > For now I've workaround that is using XSLT for performing QuickFix > action and uses <xsl:copy copy-namespaces="no"> and I intentionally do > not copy @class attribute. But QuickFix is much more concise. > > Thanks and have a nice day, > > Jirka > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

1 0

QuickFix and DITA default attributes
by Jirka Kosek 13 Mar '24

13 Mar '24

Hi, I'm creating few small "refactoring actions" using Schematron and QuickFix for DITA in oXygen. It works except that default attributes are being copied when some element is copied using QuickFix. For example the following QuickFix <sch:pattern> <sch:rule context="p"> <sch:report test="image and following-sibling::*[1]/self::fig[not(image)]" sqf:fix="wrap-image">Image is misplaced and not enclosed by a figure.</sch:report> <sqf:fix id="wrap-image"> <sqf:description> <sqf:title>Move image into adjacent figure.</sqf:title> </sqf:description> <sch:let name="image" value="image"/> <sqf:delete/> <sqf:add match="following-sibling::*[1]" position="last-child" select="$image"/> </sqf:fix> </sch:rule> </sch:pattern> Will move image <image href="media/image29.png"/> as <image class="- topic/image " href="media/image29.png" placement="inline" xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/"/> I understand that this is perhaps because QuickFix is internally implemented as XSLT transformation so default attributes are loaded from DTD during the parsing. I can live with added @class and @placement, but xmlns:ditaarch namespace declaration instantly triggers validation error in oXygen which is inconvenient? Is this something you can fix in next releases? For now I've workaround that is using XSLT for performing QuickFix action and uses <xsl:copy copy-namespaces="no"> and I intentionally do not copy @class attribute. But QuickFix is much more concise. Thanks and have a nice day, Jirka -- ------------------------------------------------------------------ Jirka Kosek e-mail: jirka(a)kosek.cz http://xmlguru.cz ------------------------------------------------------------------ Professional XML and Web consulting and training services DocBook/DITA customization, custom XSLT/XSL-FO document processing ------------------------------------------------------------------ Bringing you XML Prague conference http://xmlprague.cz ------------------------------------------------------------------

1 0

Re: [oXygen-user] [OXYGEN-13700] cross references in reusable content
by Oxygen XML Editor Support (Radu Coravu) 13 Mar '24

13 Mar '24

Hi Judith, With pleasure, maybe you can start a discussion with the Ixiasoft side about this. Regards, Radu Radu Coravu Oxygen XML Editor On 3/13/24 09:51, Oudkerk, Judith wrote: > > > Hi Radu, > > Thanks for your quick and extensive reply. Unfortunately, the trick > doesn’t work in our Eclipse/CMS web environment ☹. It did work in my > Oxygen stand alone version, so I did something right… > > Kind regards, > > Judith > > 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 > > > | > > > www.elekta.com <https://www.elekta.com/> > > Nucletron B.V., registered 2730 3235 > Nucletron Operations B.V., registered 30129540 > > > > 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 > > From:* oXygen-user <oxygen-user-bounces(a)oxygenxml.com> *On Behalf Of > *Oxygen XML Editor Support (Radu Coravu) > *Sent:* Tuesday, March 12, 2024 9:59 AM > *To:* oxygen-user(a)oxygenxml.com > *Subject:* Re: [oXygen-user] [OXYGEN-13700] cross references in > reusable content > > Hello Judith, > > An internal link inside a reused component should look like this: > > <div id="reusable"> > <table id="myTable"> > <tgroup cols="1"> > <tbody> > <row> > <entry></entry> > </row> > </tbody> > </tgroup> > </table> > <p> > Paragraph <xref href="#./myTable"/> > </p> > </div> > > So: > > <xref href="#./myTable"/> > > That "#." part is called a self link, there are some examples of it here: > > https://www.oxygenxml.com/dita/1.3/specs/langRef/base/xref.html > > So the "<xref href="#./myTable"/>" should properly resolve in the > HTML/PDF no matter where the entire reusable component will be used. > > But this depends also on the publishing offered by Ixiasoft which we > do not control. > > About how you can insert "<xref href="#./myTable"/>" constructs, > Ixiasoft in general allows only inserting keyref links but in this > case such a relative href link would need to be inserted in order for > the link to work. If Ixiasoft's Oxygen integration does not offer you > the way to insert such a link in the Author page, you can try to > insert it in the Text editing mode and ask Ixiasoft to take such an > use case into account for a future version. > > About this remark: > > Do you offer DITA or Oxygen courses for technical authors who > would like to learn a bit more about how these kind of things work? > > We do not offer training/courses. Even if we would, it would not help > you much because you are using Oxygen with Ixiasoft which controls > what actions and functionality the editor offers, the workflows are > controlled by the CMS. > > The DITA 1.3 specification is quite an useful set of resources about > what the DITA standard can and cannot do. > > We also have a set of videos for learning DITA with Oxygen (but they > are with Oxygen desktop which has more functionality than the Oxygen > products which are embedded and customized by Ixiasoft): > > https://blog.oxygenxml.com/topics/learnDita.html > > Hope this helps! > > Regards, > > Radu > > Radu Coravu > Oxygen XML Editor > > > Restricted Information and Basic Personal Data > > On 3/12/24 10:26, Oudkerk, Judith wrote: > > Hi All, > > A colleague of mine would like to use cross references within > reusable content. For example, he created a reusable content topic > with <p> elements and <table> elements. In the <p> elements, he > created an <xref> to the <table> element, but in the PDF, this > does not result in a correct link. Is there a way to incorporate > <xref> elements in reusable content? I would think it’s possible > with conkeyrefs, but I can’t figure out how to implement this. Any > suggestion would be appreciated. > > We work with Oxygen embedded in Ixiasoft Eclipse / Madcap IXIA > CCMS Web. > > Thank you. > > Kind regards, > > Judith > > PS. Do you offer DITA or Oxygen courses for technical authors who > would like to learn a bit more about how these kind of things work? > > 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 > > > > 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 > > > > _______________________________________________ > > oXygen-user mailing list > > oXygen-user(a)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

2 1

Re: [oXygen-user] [OXYGEN-13700] cross references in reusable content
by Oxygen XML Editor Support (Radu Coravu) 13 Mar '24

13 Mar '24

Hello Judith, An internal link inside a reused component should look like this: > <div id="reusable"> > <table id="myTable"> > <tgroup cols="1"> > <tbody> > <row> > <entry></entry> > </row> > </tbody> > </tgroup> > </table> > <p> > Paragraph <xref href="#./myTable"/> > </p> > </div> So: > <xref href="#./myTable"/> That "#." part is called a self link, there are some examples of it here: https://www.oxygenxml.com/dita/1.3/specs/langRef/base/xref.html So the "<xref href="#./myTable"/>" should properly resolve in the HTML/PDF no matter where the entire reusable component will be used. But this depends also on the publishing offered by Ixiasoft which we do not control. About how you can insert "<xref href="#./myTable"/>" constructs, Ixiasoft in general allows only inserting keyref links but in this case such a relative href link would need to be inserted in order for the link to work. If Ixiasoft's Oxygen integration does not offer you the way to insert such a link in the Author page, you can try to insert it in the Text editing mode and ask Ixiasoft to take such an use case into account for a future version. About this remark: > Do you offer DITA or Oxygen courses for technical authors who would > like to learn a bit more about how these kind of things work? We do not offer training/courses. Even if we would, it would not help you much because you are using Oxygen with Ixiasoft which controls what actions and functionality the editor offers, the workflows are controlled by the CMS. The DITA 1.3 specification is quite an useful set of resources about what the DITA standard can and cannot do. We also have a set of videos for learning DITA with Oxygen (but they are with Oxygen desktop which has more functionality than the Oxygen products which are embedded and customized by Ixiasoft): https://blog.oxygenxml.com/topics/learnDita.html Hope this helps! Regards, Radu Radu Coravu Oxygen XML Editor On 3/12/24 10:26, Oudkerk, Judith wrote: > > Hi All, > > A colleague of mine would like to use cross references within reusable > content. For example, he created a reusable content topic with <p> > elements and <table> elements. In the <p> elements, he created an > <xref> to the <table> element, but in the PDF, this does not result in > a correct link. Is there a way to incorporate <xref> elements in > reusable content? I would think it’s possible with conkeyrefs, but I > can’t figure out how to implement this. Any suggestion would be > appreciated. > > We work with Oxygen embedded in Ixiasoft Eclipse / Madcap IXIA CCMS Web. > > Thank you. > > Kind regards, > > Judith > > PS. Do you offer DITA or Oxygen courses for technical authors who > would like to learn a bit more about how these kind of things work? > > > 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 > > > | > > > www.elekta.com <https://www.elekta.com/> > > Nucletron B.V., registered 2730 3235 > Nucletron Operations B.V., registered 30129540 > > > > 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 > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 1

Re: [oXygen-user] [OXYGEN-8414] Refactoring functionality
by Oxygen XML Editor Support (Radu Coravu) 12 Mar '24

12 Mar '24

Hello Judith, Oxygen has the ability to create custom XML refactoring actions based on XSLT or XQuery and to apply such actions on multiple files from the local disk. We also have a predefined "Wrap element content" XML refactor action which would probably help in this case: https://www.oxygenxml.com/doc/versions/25.1/ug-editor/topics/predefined-ref… But unfortunately as the files are on the Ixiasoft CMS our XML refactoring actions cannot run over the files from the Ixiasoft storage. If for example you export the project to the local disk you could use the Oxygen desktop application's "XML Refactoring" tool. I think you should also consider adding a Schematron custom validation check in your Oxygen DITA framework customization to report such problems so that people will be notified when they insert text in cells without wrapping it in pargraphs. Regards, Radu Radu Coravu Oxygen XML Editor On 9/18/23 12:55, Oudkerk, Judith wrote: > > 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 > > > | > > > www.elekta.com <https://www.elekta.com/> > > Nucletron B.V., registered 2730 3235 > Nucletron Operations B.V., registered 30129540 > > > > 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 > > > _______________________________________________ > oXygen-user mailing list > oXygen-user(a)oxygenxml.com > https://www.oxygenxml.com/mailman/listinfo/oxygen-user

2 9

[ANN] DITA-OT Day 2024 Helsinki Recordings
by Alin Belu 07 Mar '24

07 Mar '24

Hi everyone, Last month, Oxygen XML Editor hosted in Helsinki the DITA-OT Day 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 8th 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, 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 relive the insightful discussions and presentations by accessing the complete library of recordings and slides from this year's DITA-OT Day through the following link: https://www.oxygenxml.com/events/2024/dita-ot_day.html All the best, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Version 6.0.0 of the Oxygen Batch Documents Converter add-on is now available!
by Alin Belu 06 Mar '24

06 Mar '24

Hello everyone, We are happy to announce that *version 6.0.0* of the *Oxygen Batch Documents Converter add-on* is now available! With this update, users can now seamlessly convert XSD to JSON Schema (version 2020-12). Additionally, we have implemented enhancements related to the processing of custom-styled lists for Word to HTML/DITA conversions. Furthermore, to optimize performance and reliability, we have updated the Apache POI library, utilized for conversions from Word (only ".doc" format) and Excel, to version 5.2.5. 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