- oXygen-user - www.oxygenxml.com

[ANN] Webinar: Working with DITA in Oxygen - Migrating to DITA and Refactoring (November 24th)
by Alin Belu 19 Nov '21

19 Nov '21

Hello, Next Wednesday, November 24th, get ready to continue your journey into the world of DITA, because the Oxygen XML team brings you the live webinar titled *Working with DITA in Oxygen - Migrating to DITA and Refactoring*! From our experience, most companies do not start new DITA-based projects from scratch. They already have the content written in various formats and they need that content converted to DITA. But once the content is converted, there is still work to be done. It also needs to be refactored to follow the industry’s best practices. To show you how this process can be made as simple as possible, Cosmin Duna (software developer at Syncro Soft/Oxygen XML Editor) has in store for you an exciting live event in which he will cover various topics, such as: * How to use the *Batch Documents Converter* and *Smart Paste* for converting content * How to use the *Main Files Support* for refactoring across the entire project This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-14.html To stay in touch with us and discover what other subjects will be covered in our future presentations, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: The New Oxygen Compare and Merge Scripts (November 17th)
by Alin Belu 12 Nov '21

12 Nov '21

Hello, On Wednesday, November 17th, the Oxygen XML series of live events continues with the webinar titled *The New Oxygen Compare and Merge Scripts*! With the latest release of the Oxygen suite of products, additional support was developed for Oxygen XML Scripting in order to compare and merge files or directories. Octavian Nadolu (product manager at Syncro Soft/Oxygen XML Editor) planned an exciting 1-hour event in which he will cover in great detail the newly implemented scripting support, as well as showing you examples on how to use it efficiently. He won’t be stopping here, as he will also be taking a look at the ways in which it is integrated with Oxygen XML Editor. During this live webinar, you will get to see the following topics being discussed: * The Compare and Merge Files Command-Line Script - used to compare and merge files and get the comparison results in various formats (YAML, JSON, XML, HTML). * The Compare and Merge Directories Command-Line Script - with many options to choose from, such as the comparison mode (content, binary, timestamp), the algorithm to be used for the comparison, the "strength" of the comparison algorithm, various "include/exclude" type file filters, various "ignore" type options to refine the comparison results. * Generating File or Directory Comparison HTML Reports - the support to save the comparison made with Oxygen XML Editor in HTML format. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-13.html To stay in touch with us and discover what other subjects will be covered in our future presentations, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[oXygen 21 & MacOs Monterey 12.01]
by Christophe Marchand 06 Nov '21

06 Nov '21

Hello, have you encountered instability with oXygen 21 and new Release of MacOs, 12.01 ? Just after OS upgrade, oXygen failed to start three or for times, and after few days trying not to work with XML, it now works correctly. Well, at least, it seems to start correctly. I know, I have to buy an upgrade, but I have no plan to do it now... Best regards, Christophe

2 3

[ANN] Webinar: Working with DITA in Oxygen - Quick start with the DITA Startup Project (November 10th)
by Alin Belu 04 Nov '21

04 Nov '21

Hello, The Oxygen XML weekly live event series continues in full force on Wednesday, November 10th, with the webinar titled Working with DITA in Oxygen - Quick start with the DITA Startup Project! As you might know, Oxygen XML Editor provides the ability to organize your DITA resources in projects. The DITA Sample Project is a best practice example that shows how DITA content can be organized to provide a scalable and flexible project structure. With this in mind, Alex Jitianu (DITA evangelist and development lead at Syncro Soft) will take the online stage for this 1-hour presentation in which he will go over: * The DITA Project structure * Using the Main files support to rename or move DITA resources * Creating a unified editing experience through project-level settings * Spell check and terminology check project settings * Sharing a framework customization in the project * Sharing a publishing template in the project This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-12.html To stay in touch with us and discover what other subjects will be covered in our future presentations, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Oxygen DITA References View add-on version 2.0.1 has been released!
by Alin Belu 03 Nov '21

03 Nov '21

Hello, We are excited to announce that version 2.0.1 of the Oxygen DITA References View add-on is available as of now! The free Oxygen DITA References View add-on was created to present incoming and outgoing references for any edited DITA topic and map, including references defined in relationship tables. And with this latest version, you can expect some useful new improvements, such as: * Incoming references are now grouped into three categories: Map, Cross, and Content. * The possibility to copy the location of the reference target by using Ctrl/Cmd+C on the reference. * Fixed an issue where an infinite incoming reference loop was created when a peer map reference was used. To install the add-on, follow these instructions: 1. Go to Help > Install new add-ons... to open an add-on selection dialog box. 2. Enter or paste https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml in the Show add-ons from field. 3. Select the DITA References View add-on and click Next. 4. Read the end-user license agreement. Then select the I accept all terms of the end-user license agreement option and click Install. 5. Restart the application. Result: A DITA References side-view will now be available. This side-view includes actions in the contextual menu to open the selected outgoing reference or show the definition location in case of a related link defined in a relationship table in DITA Map. For more information on the add-on (including the alternative installation procedure), see the details for the Oxygen DITA References View on GitHub: https://github.com/oxygenxml/oxygen-dita-references-view We hope you will find this add-on useful and as always, your feedback is welcomed! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

FOP configuration
by Wendell Piez 02 Nov '21

02 Nov '21

Hello oXygenites: Today I am endeavoring to follow guidelines for creating Accessible PDFs, with "accessible" being in that technical sense we all know, in addition to its more general sense. Apache documentation (eg https://xmlgraphics.apache.org/fop/2.3/accessibility.html) describes how I can set an <accessibility>true</accessibility> in the fop.xconf file to get at least some accessibility features in my PDFs. Of course, I find a copy of this file in the libraries of the oXygen distribution (and once also inside a DITA framework). It has admin permissions. To turn this feature on, is my best approach to edit this file with admin rights or is there a better way? Should I be considering using a framework for this project and if so, how would I set it up for the framework? Assuming there is no way to configure it per Project (maybe even better). Best regards, Wendell -- ...Wendell Piez... ...wendell -at- nist -dot- gov... ...wendellpiez.com... ...pellucidliterature.org... ...pausepress.org... ...github.com/wendellpiez... ...gitlab.coko.foundation/wendell...

2 3

[ANN] Webinar: Comparing and Merging Documents in a Browser Using Oxygen Web Author (November 3rd)
by Alin Belu 28 Oct '21

28 Oct '21

Hello, The Oxygen XML weekly live event series continues on Wednesday,*November 3rd*, with the webinar titled *Comparing and Merging Documents in a Browser Using Oxygen Web Author*! One of the most common parts of documentation workflows for any set of evolving documents, whether it is for a newer version of a product or a simple document that goes through an improvement process, is comparing and merging documents. The possibility to compare and merge them in a browser allows reviewers or other stakeholders to see what was changed without the headache of needing to install a separate tool. Their productivity can further be improved by sharing a link that opens the file comparison tool with the changes already being highlighted. With this in mind, Mihai Coanda (software developer at Syncro Soft) will get you accustomed to this efficient method by showing you: * Where does it fit in Oxygen’s internal workflow and how it is being used by our team. * What is the 3-way merge and in what cases you can benefit from it. * How to resolve the conflicts encountered when multiple users edit the same file. * How to integrate the file comparison tool in a CMS to create a history view. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-17.html To stay in touch with us and discover what other subjects will be covered in our future presentations, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: The New JSON Schema Diagram Editor (October 27th)
by Alin Belu 26 Oct '21

26 Oct '21

Hello, Don't forget to register for the first event of our new series of live webinars created so you can get acquainted with Oxygen's new functionalities! The series will start tomorrow (October 27th) with a webinar presented by Octavian Nadolu, product manager at Syncro Soft/Oxygen XML Editor, titled *The New JSON Schema Diagram Editor*. Octavian will show you how Oxygen now offers even more powerful tools that allow you to design, develop, and edit JSON Schemas. He will be focusing on presenting features ranging from the new intuitive and expressive *visual schema Design mode*, all the way up to the *JSON Schema documentation generator* that includes diagram images for each component. During this live webinar, you will get the chance to take an in-depth look at all of these features, as well as learn: * How to create JSON Schemas from scratch * How to visualize and edit complex JSON Schemas * How to generate JSON Schema documentation This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-16.html To stay in touch with us and discover what other subjects will be covered in our future presentations, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Webinar: The New JSON Schema Diagram Editor (October 27th)
by Alin Belu 21 Oct '21

21 Oct '21

Hello, To celebrate the release of *version 24.0* of the Oxygen XML suite of products, a brand-new series of live webinars have been created to shed light on the interesting new features and updates implemented in this latest version! Every Wednesday, Oxygen XML will host weekly live events where you can learn great insights from some of the most experienced people in the Tech Comm industry. The series will start next week, on October 27th, with a webinar presented by Octavian Nadolu, product manager at Syncro Soft/Oxygen XML Editor, titled *The New JSON Schema Diagram Editor*. Octavian will show you how Oxygen now offers even more powerful tools that allow you to design, develop, and edit JSON Schemas. He will be focusing on presenting features ranging from the new intuitive and expressive *visual schema Design mode*, all the way up to the *JSON Schema documentation generator* that includes diagram images for each component. During this live webinar, you will get the chance to take an in-depth look at all of these features, as well as learn: * How to create JSON Schemas from scratch * How to visualize and edit complex JSON Schemas * How to generate JSON Schema documentation This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-16.html To stay in touch with us and discover what other subjects will be covered in our future presentations, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Version 24 of the Oxygen XML suite of products is now available!
by Alin Belu 18 Oct '21

18 Oct '21

Hello everyone, Today, we are proud to announce the immediate availability of*version 24* of the industry-leading XML suite of products, *Oxygen XML Editor, Author, Developer, Web Author, Publishing Engine, WebHelp, PDF Chemistry, *and *Oxygen XML Scripting.* This new release brings enhancements to the validation support with the DITA validate and check for completeness action being available as a validation unit that can be added to validation scenarios, dynamic publishing for DITA by converting various types of non-DITA resources to DITA, including MS Word, MS Excel, HTML, and Markdown, furthermore, the Enterprise Edition users may now upload and publish DITA to the Zendesk Help Center. The DITA to WebHelp transformation features improved navigation and the PDF Chemistry engine allows controlling the generated PDF security permissions and metadata. The JSON support is improved constantly to match the support Oxygen offers for XML and version 24 brings a visual diagram editor for JSON helpful for increasing productivity when working with simple JSON Schemas and for visualizing, understanding, and editing complex JSON Schemas. With a focus on authoring experience and collaboration, the Oxygen XML Web Author now boasts a re-designed interface, a new visual merge tool that enables you to easily resolve conflicts, and the ever popular Concurrent Editing feature has progressed through the BETA testing stages and now comes bundled with Web Author. More functionality is exposed as part of Oxygen Scripting to enable automation/continuous integration and delivery workflows, including generating diff reports, as well as formatting and indenting XML documents. ============================================================================= *Version 24 *of*Oxygen XML Editor*, the XML community's most advanced bundle of tools, introduces lots of exciting new features, updates, productivity enhancements, new customization options, and various performance optimizations. As the Oxygen team perpetually strives to make the DITA authoring experience more and more efficient and dynamic, DITA users can now configure and run validation scenarios directly from the DITA Maps Manager, or configure validation scenarios that process validation and completeness checks for DITA maps or DITA Open Toolkit projects. With the introduction of new refactoring actions for DITA, it is easier than ever to convert between DITA bookmaps and normal maps, to change or remove profiling attribute values, and to convert direct links to indirect key-based references. To help you get started with your own customizations, a new sample DITA project is available with examples for various framework customizations and best-practices techniques. We also continued to update Oxygen to support the latest DITA 2.0 standard. On the DITA publishing side, a new transformation scenario (available in the Oxygen Enterprise edition) can be used to upload and publish content to the Zendesk Help Center. Also, it is now possible to dynamically convert various types of non-DITA resources (MS Word, MS Excel, HTML, and Markdown) to DITA during the publishing process. For PDF publishing, the output can be generated in compliance with the PDF/Universal Accessibility standard, copyright information is now automatically processed, and you can restrict the permissions for people using your PDF files, for instance to prevent printing or copying of the PDF content, or even to control the access to the PDF document by requiring a password. Oxygen's expanding JSON community will be pleased to learn that a visual diagram editor was integrated in a new specialized editor for JSON Schema documents. It offers validation support, content completion, an outline view, and JSON-specific syntax highlighting. The JSON Schema editor's new intuitive, expressive visual schema design mode provides a simple diagram editor that is helpful for visualizing and understanding both simple and complex JSON Schemas. It also offers various editing features to help you modify JSON Schemas directly within the visual design mode. Some of the general editing productivity improvements include a new Block Tags without Element Names display mode that shows block element tags in a more compact look, the ability to save remote images locally while choosing to update any existing references, and a new XML refactoring operation that can be used to batch accept tracked changes or remove comments and highlights. When using the Compare Files or Compare Directories command-line scripts (or the similar comparison tools within Oxygen), you now have the ability to save the results of a comparison as an HTML report file that can be viewed in your browser or other application. A new tool was also added in Oxygen for generating an HTML report that contains the results of a directory comparison (for either 2-way or 3-way comparisons). Add-ons continue to gain popularity and this latest release gives you the possibility to extend Oxygen's functionality even further by introducing numerous updates and improvements to the Git Client, DITA Prolog Updater, and Batch Converter add-ons. A new entry to the Oxygen add-ons library comes in the form of the Writer Helper. It is designed to help technical writers by offering them tips, finding possible similar content that could be reused, and even has an option for reading content out loud using the operating system's narrator. Some of the other exciting highlights for this version include startup speed performance improvements, some new ways to use editor variables, various API additions, bug fixes, component updates, and much more. For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html ============================================================================= *Oxygen XML Scripting version 24* offers updates and improvements for some of the scripts that are available to provide a variety of functions that can be scheduled or triggered using a command-line tool on Windows, Linux, or macOS. This release brings the possibility of generating various types of comparison reports, a new merge option, several improvements for the file and directory comparison scripts, a brand new script that can be used to batch format and indent multiple files at once, as well as other updates and bug fixes. For more information, see: https://www.oxygenxml.com/xml_scripting/whats_new.html ============================================================================= *Oxygen Publishing Engine version 24* encompasses all of the improvements and new customization possibilities implemented in Oxygen XML WebHelp and Oxygen PDF Chemistry. As an Oxygen XML WebHelp publisher, now you have access to new transformation parameters to help style the WebHelp output to suit your specific needs, new expand/collapse buttons for choosing whether or not to display both the topic and publication table of contents, and various other small updates and bug fixes. Some examples of the improvements and updates that were added to Oxygen PDF Chemistry include the possibility of controlling the security policies for the Chemistry processing, protecting your PDF files using security permissions, for instance to prevent printing or copying of the PDF content, or even to control the access to the PDF document by requiring a password. Some new properties can also be used to control various components in the PDF output (such as the initial settings for how the document is presented, copyright information, or custom metadata). For more information, see: https://www.oxygenxml.com/publishing_engine/whats_new.html ============================================================================= *Version 24.0.0 *of*Oxygen XML Web Author* is the latest release for the innovative web-based XML authoring tool. This release introduces a visual merge tool for resolving conflicts when committing to a shared Git repository, a re-design of the interface to offer a more modern and visually appealing look and better blending when Web Author is embedded in another application (such as a CMS), additional protection against XXE vulnerabilities and other security-related improvements, as well as more customization possibilities, performance optimizations, and accessibility enhancements. Also, the ever popular Concurrent Editing feature has progressed through the BETA testing stages and is now bundled with the Oxygen XML Web Author installers. For more information, see: https://www.oxygenxml.com/xml_web_author/whats_new.html ============================================================================= We hope you will enjoy the latest release of the Oxygen XML suite of products! As always, your feedback on it is welcomed. Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0