- oXygen-user - www.oxygenxml.com

[ANN] Oxygen XML Users Meetup 2024 recordings are now available!
by Alin Belu 15 Jul '24

15 Jul '24

Hello everyone, We are excited to announce that the recordings of the Oxygen XML Users Meetup 2024, held in the pre-conference day of XML Prague, are now available online! If you were unable to attend the event or just want to relive it, you can catch up on all the insightful presentations and discussions at your convenience. To watch the recordings, please visit our event page: https://www.oxygenxml.com/events/2024/oxygen_user_meetup_Prague.html As always, we appreciate your continued interest and support! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Oxygen Content Fusion 7.0 introduces a personal authoring workspace and support for Continuous Deployment
by Alin Belu 10 Jul '24

10 Jul '24

Hello everyone, We are proud to announce the release of *Oxygen Content Fusion 7.0*, the web-based collaboration platform for content creation! *Oxygen Content Fusion* version *7.0* enhances the project support by introducing a *personal authoring workspace* where you can make changes across multiple files and once you are happy with the results, you can commit them directly to the repository to share them with your team. The dedicated /Changes/ side-view enables you to preview and adjust changes before committing. An XML-aware conflict resolution tool helps you pull changes from the repository, detects conflicts, suggests automated solutions, and also allows merging content manually for more complex scenarios. Along with the powerful editing features for XML documents, the built-in Web Author allows you to edit Markdown files inside the authoring workspace providing syntax preview and toolbar actions to insert common structures. The workspace feature includes a /Publications/ side-view for easy browsing of a publication's DITA map. Users can open the map in a specialized DITA map editor to modify the structure using toolbar or contextual menu actions. The intuitive interface supports drag and drop, copy/paste, and various other actions for organizing topics. The editor also supports advanced DITA features such as profiling attributes, key definitions, and map references. Continuous Deployment for the output is now possible as version 7.0 adds *support for publishing connectors* to enable uploading output to various platforms such as Amazon S3, Netlify, or servers with SFTP protocol. The output can be configured to include an "Edit Online" link in each topic that sends authors to their personal workspace where they can make changes to the source of that topic. When used in conjunction with automated builds, these changes will be live as soon as the build finishes. For more information about the new release, please see: https://www.oxygenxml.com/content_fusion/whats_new.html You may also try these new features on our public demo deployment: https://fusion.oxygenxml.com/projects We hope you will enjoy our latest release! As always, thank you for your support and don't forget that feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

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

17 Jun '24

Hi Scott, I'll add an internal issue to improve the DocumentTypeInformation API. Possibly a not so elegant approach would be to get access to the framework XML file "DocumentTypeInformation.getFrameworkStoreLocation()", parse it and obtain the information from there. Regards, Radu Radu Coravu Oxygen XML Editor On 6/14/24 20:05, Scott Prentice wrote: > > Hi Radu, > > Thanks! I'll play with the script parameter a bit more to see how that > works. > > It seems that the DocumentTypeInfo API is different than the > DocumentTypeInformation API. I'm trying to get the active framework's > "Description", which is available from > DocumentTypeInfo.getDescription() but not > DocumentTypeInformation.getDescription(). Interestingly, > DocumentTypeInformation.getName() does work. > > Any ideas on how to access the framework description from the > authorAccess object? > > Thanks, > > Scott > > On 6/13/24 9:39 PM, Oxygen XML Editor Support (Radu Coravu) wrote: >> >> Hi Scott, >> >> So the "script" parameter should be a piece of Javascript content. >> For example you can pass as value of the "script" parameter this >> entire Javascript code here: >> >> https://github.com/oxygenxml/javascript-sample-operations/blob/master/copy-… >> >> To the value passed using "script" we add the entire Javascript from >> the "commons.js". So I guess in your case you have placed the entire >> content in the "commons.js" and passed an empty "script" parameter, >> which should also work as long as you have a "doOperation()" function. >> >> About accessing the DocumentTypeInfo API, your script has global >> access to an object named "authorAccess" which maps to this Java class: >> >> https://www.oxygenxml.com/InstData/Editor/SDK/javadoc/ro/sync/ecss/extensio… >> >> So something like this in the JS code: >> >> authorAccess.getEditorAccess().getDocumentTypeInformation() >> >> should give you access to this Java class: >> >> https://www.oxygenxml.com/InstData/Editor/SDK/javadoc/ro/sync/exml/workspac… >> >> That similar >> "ro.sync.ecss.extensions.api.webapp.doctype.DocumentTypeInfo" API >> that you wanted access to is specific for our web author in browser >> editor tool. >> >> Regards, >> >> Radu >> >> Radu Coravu >> Oxygen XML Editor >> On 6/13/24 19:48, Scott Prentice wrote: >>> >>> Thanks, Radu. >>> >>> I have a couple questions. >>> >>> It's not clear to me how the "script" parameter works with the >>> JSOperation class. I assume it can be used to pass in values to the >>> code in commons.js, but I'm not seeing how you'd do that. Can you >>> point me to any examples? >>> >>> Also. I see that commons.js has access to the AuthorAccess API. I'd >>> like to access DocumentTypeInfo interface >>> (ro.sync.ecss.extensions.api.webapp.doctype.DocumentTypeInfo) .. can >>> I do that from commons.js? I've tried a few things, without much >>> success. >>> >>> Thanks! >>> >>> Scott >>> >>> >>> On 6/12/24 8:27 PM, Oxygen XML Editor Support (Radu Coravu) wrote: >>>> >>>> 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 >>>> >>>> _______________________________________________ >>>> 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 >> >> _______________________________________________ >> 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-15680] Re: Custom action to generate simple dialog?
by Oxygen XML Editor Support (Radu Coravu) 14 Jun '24

14 Jun '24

Hi Scott, So the "script" parameter should be a piece of Javascript content. For example you can pass as value of the "script" parameter this entire Javascript code here: https://github.com/oxygenxml/javascript-sample-operations/blob/master/copy-… To the value passed using "script" we add the entire Javascript from the "commons.js". So I guess in your case you have placed the entire content in the "commons.js" and passed an empty "script" parameter, which should also work as long as you have a "doOperation()" function. About accessing the DocumentTypeInfo API, your script has global access to an object named "authorAccess" which maps to this Java class: https://www.oxygenxml.com/InstData/Editor/SDK/javadoc/ro/sync/ecss/extensio… So something like this in the JS code: authorAccess.getEditorAccess().getDocumentTypeInformation() should give you access to this Java class: https://www.oxygenxml.com/InstData/Editor/SDK/javadoc/ro/sync/exml/workspac… That similar "ro.sync.ecss.extensions.api.webapp.doctype.DocumentTypeInfo" API that you wanted access to is specific for our web author in browser editor tool. Regards, Radu Radu Coravu Oxygen XML Editor On 6/13/24 19:48, Scott Prentice wrote: > > Thanks, Radu. > > I have a couple questions. > > It's not clear to me how the "script" parameter works with the > JSOperation class. I assume it can be used to pass in values to the > code in commons.js, but I'm not seeing how you'd do that. Can you > point me to any examples? > > Also. I see that commons.js has access to the AuthorAccess API. I'd > like to access DocumentTypeInfo interface > (ro.sync.ecss.extensions.api.webapp.doctype.DocumentTypeInfo) .. can I > do that from commons.js? I've tried a few things, without much success. > > Thanks! > > Scott > > > On 6/12/24 8:27 PM, Oxygen XML Editor Support (Radu Coravu) wrote: >> >> 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 >> >> _______________________________________________ >> 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-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