- oXygen-user - www.oxygenxml.com

[ANN] Webinar: Add-ons You Can Use for Technical Writing (December 8th)
by Alin Belu 02 Dec '21

02 Dec '21

Hello everyone, The year is quickly coming to an end so let’s meet again one more time,*on December 8th*, for one of the most requested Oxygen live webinars: *Add-ons You Can Use for Technical Writing*! As you all know, Oxygen already offers extensive support for technical authoring but why not try and expand it even further with a variety of easy-to-install add-ons! During our last live event of the year, Alex Jitianu (DITA evangelist and development lead at Syncro Soft) aims to take a deeper look at some of the most popular add-ons available in the Oxygen library and at the types of benefits they provide. Find out how easy it is to install them, as well as learn some ideas for how they can be integrated into your particular authoring workflow. The add-ons that will be featured in this webinar include: * The *Git Client add-on* that contributes a Git client directly in the Oxygen interface. * The *DITA Outgoing References add-on* that contributes a side view where you can see all the outgoing references for the current topic. * The *Terminology Checker add-on* that highlights matched terms in the Author visual editing mode. * The *Translator Helper add-on* that translates content using Google Translate or DeepL Translator to various languages. * The *Writer Helper add-on* that helps with the review process, finding similar content, reads content with an operating system-specific narrator, and provides Oxygen productivity tips. This is a free event but registration is required. You can register at https://oxygenxml.com/evs2021-15.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] Working with DITA in Oxygen - Compiled video tutorials
by Alin Belu 26 Nov '21

26 Nov '21

Hello everyone, Along the years, the ever-expanding Oxygen video library offered our users countless resources for increasing their authoring experience via demonstrations and recorded webinars. For the people that might be overwhelmed when it comes to starting their journey into working with DITA, we compiled a collection of Oxygen webinars meant to be used as a guide. The videos found on the below page will not only help you jump-start your authoring activity, but will also help you optimize your experience through various tutorials ranging from basic profiling and reuse strategies, all the way up to more advanced concepts. As all of our other learning resources channels, this page will be continuously updated so make sure to check it regularly: https://www.oxygenxml.com/working_with_dita_in_oxygen.html Have a wonderful day! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[ANN] Version 3.2.0 of the Oxygen Batch Documents Converter add-on has been released!
by Alin Belu 23 Nov '21

23 Nov '21

Hello everyone, We are excited to announce that *version 3.2.0* of the *Oxygen Batch Documents Converter add-on* is now available! For the new version of the add-on, we implemented a Preferences page that contains an option for customizing the conversions from Word (Word to HTML/DITA/DocBook) by mapping Word styles to HTML elements, as well as an option for choosing the maximum heading level for creating nested topics or separate DITA topic files when converting Word/HTML to DITA. Also, we are glad to inform you that the hierarchy level obtained in conversions from Word/HTML to DITA maps has been improved. Along with these major improvements, version 3.2.0 of the Oxygen Batch Documents Converter add-on comes with the following: * Warnings are now presented if unrecognized Word styles are found when converting Word documents. * All 'class' attributes are converted from the intermediary HTML into DITA 'outputclass' attributes when processing Word to DITA. * The file name is used as the title when the document doesn't contain headings in Word/HTML to DITA conversions. * The table of contents is ignored when converting Word to HTML/DITA. * Added an 'outputclass' attribute with an "endnote" value on the 'fn' DITA elements that resulted from Word endnotes. * Copied relative resources into the output folder in HTML to DITA conversions. * Superscript and subscript are allowed when converting Markdown to DITA. * Fixed some cases where internal references were not converted properly in Word to HTML/DITA conversions. * Fixed a case where equations were not converted in Word to HTML/DITA conversions. * Fixed an issue where a space between underline elements and other inline elements was ignored. * Fixed an error in HTML to XHTML conversions when processing elements with whitespace content. 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 Batch Documents Converter 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 Finish. 5. Restart the application. Result: A Batch Documents Converter submenu will now be available in the Tools menu and in the contextual menu. This submenu will contain a list of the various types of available conversions. Selecting one of the types of conversions will open a dialog box where you can configure options for the conversion. For more information on the add-on (including the alternative installation procedure), see the details for the Oxygen Batch Documents Converter on the page below: https://www.oxygenxml.com/doc/ug-editor/topics/batch-converter-addon.html We hope you will find this add-on useful and as always, your feedback is welcome! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[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