- oXygen-user - www.oxygenxml.com

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

[ANN] Writer Helper Add-on - the newest release in the Oxygen add-on library!
by Alin Belu 14 Oct '21

14 Oct '21

Hello, Great news, everyone!Today,weannounce thereleaseofa newadd-on that providesgreatsupport for helping technical writers - the Writer Helper Add-on! This newentry to the always-expanding Oxygen add-on library contributesa side-view named 'Writer Helper' that containsseveraltools intended to enhance the technical writers’ day-to-day activity: Review-Selectfolders or files in the Project view and start a review session for them. This is useful for reviewing a set of documents. SimilarContent-Select folders or files in the Project view, then choose a list of elements to check for similarity. This is useful for finding possible elements that can be reused instead of being copy-pasted between documents. Read Aloud-Selectcontent in the current document and use the Play button to listen to how it is read by the operating system's narrator. This is useful for those who want to review content by listening to it. Tips-View a list of editing tips tuned for technical writers. This is useful for discovering productivity tips to make your editing experience more efficient and productive. To install the add-on, follow these instructions: 1. Go toHelp->Installnew add-onsto open an add-on selection dialog box. 2. Enter or pastehttp://www.oxygenxml.com/InstData/Addons/default/updateSite.xmlin theShow add-ons fromfield. 3. Select theWriter Helperadd-on and clickNext. 4. Read the end-user license agreement. Then select theI accept all terms of the end-user license agreementoption and clickFinish. 5. Restart. 1. 2. 3. 4. 5. We hope that you willfind therelease of theWriter Helper add-onusefuland any feedback will be welcomed! Best regards, Alin -- Alin Belu Oxygen XML Editor

3 2

[ANN] Version 3.0.0 of the Oxygen Git Client add-on has been released!
by Alin Belu 11 Oct '21

11 Oct '21

Hi everyone, We are excited to announce the release of the Oxygen Git Client add-on version 3.0.0! Our developing team spent great efforts to further expand the add-on's functionality with the addition of these following improvements: 1. You can save the uncommitted changes into stashes, reapply or delete the stashed changes. 2. You can create new tags from the Git History contextual menu. In the Git Staging toolbar, there is an action to list all the tags. Tags from the local repository can be deleted or pushed to the remote repository. 3. Added a Merge "SELECTED_BRANCH" into "CURRENT_BRANCH" action in the contextual menu for local branches in Git Branch Manager. 4. When showing the history for a directory in the affected files section, the files that are descendants of the directory are presented on top and the files that are outside it are grayed out. 5. Added a Revert commit action in the contextual menu for commits from the Git History view. It creates a new commit that reverts all the changes from the selected commit. 6. Added a Reset file to this commit action to the contextual menu for resources associated to a revision in the Git History view. It checks out the selected version of the file. 7. Added an Open working copy version action to the contextual menu for resources associated to a revision in the Git History view. 8. A warning message is now displayed when trying to use the Mark as resolved action on a file that contains conflict markers. 9. A message prompt is now displayed if you try to switch the branch while there are uncommitted changes so that you can confirm that you want to stash the changes or move the changes to the new branch. 10. A new editor variable is now supported: ${git(working_copy_url)}. It is resolved to the URL of the current working copy directory. 11. When hovering the cursor over the Pull and Push buttons, the displayed tooltip now shows information about some of the incoming/outgoing commits (such as the date, author and message). 12. When hovering the cursor over a branch name, a tooltip is displayed that provides information about the last commit performed on that branch (such as the author and the date of the commit). 13. An information message that is shown when starting Oxygen while being on a detached HEAD now presents more information about the checked-out commit (ID, author, date, message). 14. The add-on's minimum compatible Oxygen version was increased to version 22.1. 15. The highlight boxes that surround branches and tags are now styled differently so that it is easier to identify which represents a branch and which represents is a tag. 16. The settings in the Git client preferences page can be saved at project level. The project can then be shared with other users and everyone will have the same Git client settings. 17. Fixed an issue that caused the commit details to be incorrectly displayed when a filter text was active in the History view. To find out more details about the add-on and how you can install it, we invite you to take a look at the below page: https://www.oxygenxml.com/doc/versions/23.1/ug-editor/topics/git-addon.html We hope that you will enjoy using version 3.0.0 of the Oxygen Git Client add-on and as always, any feedback on it is welcomed! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Major issue with this app and multi stand-alone windows
by Karl Stubsjoen 15 Sep '21

15 Sep '21

I have been struggling with this for years. When you drag any document into a new window, dialogs and menu options are no longer available. For example, if I drag an Xml document from the main Oxygen window into a new standalone window and then try to use the menu option: DOCUMENT | SCHEMA | GENERATE/CONVERT SCHEMA; is not available. Also, things like the Outline view, the Quick Search, Transformation Scenarios, etc.. all of a sudden are not available for any document that is hosted in a standalone window. It becomes very difficult (to impossible) to use the app when you spread windows across your desktops. Is this a known issue and can this be fixed? I'm a Windows user. Karl Stubsjoen (602) 845-0006

2 1

[ANN] Webinar: Transforming XML and HTML documents to PDF using CSS, Part 4 - Advanced functionalities (TODAY)
by Alin Belu 15 Sep '21

15 Sep '21

Hello, Have you registered for today's Oxygen XML live webinar? No worries, you still got time! The beginning of this fall brings with it the conclusion to one of our most highly-rated webinar series, Transforming XML and HTML documents to PDF using CSS. Get ready for the grand finale with Part 4 - Advanced functionalities! You started your journey by learning the basic CSS layout, and you continued with more advanced CSS properties until you were ready to tackle PDF publishing on your own. Now, Julien Lacour (software developer at Syncro Soft) brings to you his latest tutorial explaining how CSS can be your best asset when styling a production-ready PDF output. Today, on September 15, let’s explore together the more advanced functionalities needed for you to become an unstoppable PDF publishing machine: * Hyphenation * PDF Bookmarks * Setting PDF metadata like title, author etc. * Using XPath from CSS to generate dynamic content This is a free event but registration is required. You can register at http://www.oxygenxml.com/evs2021-11.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 Translator Helper add-on version 1.1.0 has been released!
by Alin Belu 12 Sep '21

12 Sep '21

Hi everyone, We are excited to let you know that we updated the free Oxygen Translator Helper add-on to version 1.1.0! Starting with this version, the Translator Helper is now enhanced to provide support for translating content to various languages using "DeepL Translator”. To install it you can use the Oxygen main menu "Help->Install new add-ons", choose the default Oxygen add-on update site and you will find an add-on named "Translator Helper" in the list. To update the existing add-on you can use the Oxygen main menu Help->"Check for add-ons updates" action. Just to recap, the add-on has two main features: 1. You can translate content using "Google Translate" or "DeepL" to various languages: * Select the content to translate in the Author visual editing mode. You can also select the entire document contents but the translator might have limitations for the total amount they can translate. * Right click. Select "Translate->Google Translate" or "Translate->DeepL Translator" and choose the target language. * Copy the translated content from the opened web page. * Click Replace in the Oxygen Translate using Google Translate dialog that showed up. The original content should now be replaced with the translated content, the original element structure and attributes should remain unchanged. * In addition you can choose to show the original document content in the Translator Helper side view. This will allow you to correct the translation further by looking at the original text and the translated text side by side. 2. You can see the original content side by side with the content that you are translating, so you can translate correctly and easy by right clicking in the Author visual editing mode and invoking the Show current content in side view action. I hope you will find the updated Oxygen Translator Helper add-on useful and, as always, any feedback on it will be welcomed! Best regards, Alin -- Alin Belu Oxygen XML Editor

2 1