- oXygen-user - www.oxygenxml.com

[Ann] Oxygen Terminology Checker add-on version 2.0
by Alin Belu 12 Nov '20

12 Nov '20

Hello, We are glad to announce version 2.0 of our Terminology Checker add-on is now available in the *Oxygen XML* default add-on repository! The add-on is free and is compatible with any Oxygen XML Editor or XML Author version 20.0 and newer. 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. Select "Default Update Site" (or paste https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml <https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml>) in the *Show add-ons from* field. 3. Select the *Terminology Checker* add-on and click *Next*. 4. Select the *I accept all terms of the end user license agreement* option and click *Finish*. 5. Restart the application. Version 2.0 of the add-on brings these useful new features: * Partial support to load Vale <https://github.com/errata-ai/vale> rules and use them to highlight problems. Supported Vale scopes: /heading/, /table.header/, /table.cell/, /list/, /paragraph/, /code/,/strong/, /emphasis/. Supported Vale extension points: /Existence/, /Substitution/, /Occurrence/. For example, you can download the Microsoft style guide yaml rules <https://github.com/errata-ai/Microsoft/tree/master/Microsoft> and add them to the terminology folder configured in the *Preferences->Plugins / Terminology Checker* page. * The new *Terminology Helper* side view gives an overview of the terminology problems. Clicking in the side view on the incorrect term will focus the matching term in editor area. * Share favorite rules with the team: define a folder /oxygen-term-checker/ in the root of your project and terms are automatically loaded from it. * Use capturing groups in the suggestions and messages in your custom term rules using the term match regular expression. * Match user defined custom terms at word level, character level or with a regular expression. * Insert replacement suggestion value as plain-text or as XML fragment. * Set problem severity (info, warning or error) for each matched term. * Enable/disable add-on from the tool bar without restarting *Oxygen*. We hope you will find the plugin useful and as always any feedback is welcomed. Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Master files?
by David Birnbaum 10 Nov '20

10 Nov '20

Dear oxygenxml.com, Thank you, Gerrit and Octavian, for the quick and helpful responses. Thanks to your advice, which helped me understand when and how <oXygen/> updates the dependencies when using master files, I realized both why the problem was happening and—alas!—that in an effort to simplify the description when I wrote for advice, I had unwittingly omitted a decisive detail. Octavian writes: The master files graph is updated automatically when you save a file from the editing area. Therefore, when you add the "xsl:import" instruction in the master file, the module should be added in the graph and validated correctly. If a module is not detected correctly, you can also try to refresh the Master Files folder from the Project view. For this you can use the "Refresh" action from the Project view contextual menu. I described my workflow as having a master file (a.xsl) that imports a library of functions (lib.xsl) and some subsidiary files that contain only templates (b.xsl, c.xsl, etc.). The issue was that the template files use functions declared in lib.xsl, but the template files do not import lib.xsl directly. Since the template files are intended to be used only as imports into a.xsl, and a.xsl imports lib.xsl, this means that the library functions are available when I run a real transformation. The problem I reported was that when I created a new template file to be imported, <oXygen/> was raising errors about unknown functions in it, although older template files that used the same functions did not raise those errors. This led me to understand that <oXygen/> was able to learn about the dependency hierarchy, but that that didn't happen automatically and completely whenever I created a new template file to be imported. What I left out, because I did not recognize its importance at the time, is that the import is mediated; a.xsl imports only lib.xsl and an auxiliary file (let's call it aux.xsl), which consists entirely of <xsl:import> instructions to import b.xsl, c.xsl, etc. The intermediary step is based on https://www.oxygenxml.com/archives/xsl-list/201510/msg00002.html; I want to import everything in the modules directory without having to mention them all explicitly, so I run a preprocessing XSLT script that creates aux.xsl, and a.xsl then imports that. This means, I now realize (funny how obvious things can be in retrospect!), that of course 1) I have to rerun the preprocessing script to update aux.xsl every time I create a new template file to be imported, and 2) <oXygen/> will not know that this file has been imported if it is not watching it. Keeping it open in <oXygen/> and ensuring that it reloads/refreshes each time I rerun the preprocessing script fixes the problem. This all makes perfect sense ... er ... in retrospect. Best, David djbpitt(a)gmail.com

1 0

Master files?
by David Birnbaum 09 Nov '20

09 Nov '20

Dear oxygen-user list, I've configured an XSLT transformation using master-file support, where there is one master XSLT file (a.xsl), which imports (with <xsl:import>) a file of functions (lib.xsl) and a set of files that contain only templates (b.xsl, c.xsl, etc.). The imported template files use functions defined in lib.xsl but don't import those functions directly. Since the imported template files are never run on their own, and used only by being imported into a.xsl, the functions from lib.xsl are available to the imported template files when they are used, and the transformation runs successfully. I have specified a.xsl as a master file, and <oXygen/> validates it successfully. For the most part (the four scariest words in debugging!) the imported template files do not raise real-time validation errors about unknown functions, even though they would have access to the functions they use only because both they and those functions are imported into a.xsl together. So far, so good. My issue is that when I create a new template file to be imported into a.xsl, <oXygen/> doesn't seem to know that it should be validated with the understanding that it is being imported into a.xsl, which is also importing lib.xsl. This means that when I create a new template file, <oXygen/> raises real-time validation errors about unknown functions, even though it does not raise those errors for other imported template files that use similar function calls. At some point <oXygen/> seems to learn that the new imported template files should be checked with access to master-file information, that is, that they will have access to the functions in question when they are used, at which point the imported template files no longer raise validation errors when I have them open in <oXygen/>. I have not, however, been able to identify what exactly enables <oXygen/> to learn this about new imported files as I am creating them, or how to notify <oXygen/> explicitly about them when I first begin to author them. Can someone please advise? Thanks, David djbpitt(a)gmail.com

3 2

[Ann] Webinar: Introducing the Oxygen Publishing Engine for DITA
by Alin Belu 30 Oct '20

30 Oct '20

Hello, Next Wednesday, on November 4, you are invited to our latest live event - “Introducing the Oxygen Publishing Engine for DITA” webinar! Have you been looking for a solution that offers support for transforming your DITA content into PDF and WebHelp output? Look no further! In this webinar, Julien Lacour, software developer at Syncro Soft, will introduce you to the Oxygen Publishing Engine – an automation product that bundles the DITA Open toolkit transformation engine with Oxygen publishing plugins and the PDF Chemistry engine. This event will represent a crash-course for you to learn what the Oxygen Publishing Engine is by showing you how to install it, configure it in a Continuous Integration system, and then customize your output. You will be shown its components, various workflows, and also get the chance to see how to transform a DITA map document by learning how to: * Use the “DITA Map PDF – based on HTML5 & CSS” transformation on an integration server using a publishing template for customizing the output. * Create a custom CSS stylesheet and use it in your transformation to get that extra level of customization for your specific needs. * Debug the CSS inside both a web browser and Oxygen to see how to choose the correct selectors and properties used for further styling your content. This is a free event and you can register at http://www.oxygenxml.com/evs2020-15.html Make sure to check the full list of our upcoming Events: https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Set Color in Data Source Explorer
by Karl Stubsjoen 26 Oct '20

26 Oct '20

This is a wish request. Would be great if there was an option to set the color for the objects and collections in the Data Source Explorer window for a top level connection. Think DEV vs. PROD. When you have the explorer expanded and you are looking at virtually the same list of objects in PROD as in DEV you have to be VERY CAREFUL that you don't actually perform an action in PROD that you intended to do in DEV! However, if the color of the collections in PROD could arbitrarily be set, in my case I'd choose to make all of those objects red, it would be a nice visual guard against making this mistake. Karl..

2 1

[Ann] Webinar: Explore Web Author beyond technical documentation
by Alin Belu 23 Oct '20

23 Oct '20

Hello, Our weekly series of live events continues on Wednesday (October 28), with the “Explore Web Author beyond technical documentation” webinar! Picture a growing company. As it grows, so does the need for standardized procedures. And when new people join the company, they often need to be trained to follow existing procedures. As you can see, a lot of time is spent in training sessions, affecting your overall productivity. With this in mind, Bogdan Dumitru, software developer at Syncro Soft, will show you how Web Author comes in handy in instances like this one, allowing you to build guided procedures where new employees don't require additional training or validation. During this webinar, you will learn various ways in which Web Author can be used to enhance your productivity: * Guiding new writers with the help of Schematron Quick Fixes or easy-to-configure contextual actions, so they can just follow the on-screen instructions. * Creating forms and sharing them with other users, with the possibility of automated processing. * Using Web Author to keep track of standardized procedures (e.g. release notes) with the possibility of filtering out the completed tasks and only focusing on the ongoing ones. * Document collaboration with real-time co-authoring. Instead of having read-only access to a document, now you can work alongside other colleagues. This is a free event and you can register at http://www.oxygenxml.com/evs2020-14.html Make sure to check the full list of the upcoming webinars on our Events page: https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[Ann] Webinar: Transforming HTML documents to PDF, Part 1 - Basic CSS Layout
by Alin Belu 16 Oct '20

16 Oct '20

Hello, We continue our weekly series of live events, next Wednesday (October 21), with the “Transforming HTML documents to PDF, Part 1 - Basic CSS Layout” webinar. If you want to be able to define the look and format of your document but struggling to grasp the basics of CSS, then this is the perfect crash-course for you! In this webinar, Julien Lacour, software developer at Syncro Soft, will teach you a basic understanding of the CSS layout to help you to have a better understanding of PDF publishing. Be assured that there is no need for you to have any CSS background to learn the concepts explained during this webinar, but we promise to help get you up to speed by teaching you: * The basics of Cascading Style Sheets (CSS) and HTML5. * How to customize your document with the help of fonts, text, and background colors, and by adjusting the position of elements on your page. * How to debug your CSS document fast and easy with the help of Oxygen. * How to put your CSS to good use and obtain a deliverable PDF output. This is a free event and you can register at http://www.oxygenxml.com/evs2020-13.html Make sure to check the full list of the upcoming webinars on our Events page: https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[Ann] Release of Git Client Add-On version 2.3
by Alin Belu 13 Oct '20

13 Oct '20

Hello, We are excited to announce the release of version 2.3 for the Oxygen Git Clientadd-on! One of the most important featuresaddedin thisversionof the add-onis the Git Branch Manager, a side-view that presents all the local and remote branches as a tree. Actions added to the tree's contextual menu make it easier for you to check out branches and to create or delete branches. Also, you cannoweasily switch between local branches with the Git Branch Manager or by using the drop-down menu in the top-right corner of the Git Staging view. Other improvementsadded inversion 2.3 of theOxygenGit Clientadd-on that expand its functionality even furtherinclude: * A new action (Reset "[branch_name]" to this commit) was added in the history table that can be used to undo changes by moving the HEAD of the current branch to the selected commit. * Some editor variables are now supported, including ${git(working_copy_name)}, ${git(working_copy_path)}, ${git(short_branch_name)}, ${git(full_branch_name)}. * The Git History view now has better automatic refresh support. * A confirmation dialog box has been added for instances when you try to commit without a message. * The add-on now contributes a preferences page (Options > Preferences > Plugins > Git Client) that contains a "Notify me about new commits in the remote repository" option. When this option is selected, Oxygen will show notification messages when it detects that new commits have been pushed to the remote repository. * Support for French localization was added. * TheJGitcomponent included in the Git Client was updated to version 5.9.0. * Various other minor improvements and bug fixes were implemented. For more information, see the details for the Git Client add-on on GitHub: https://github.com/oxygenxml/oxygen-git-plugin/blob/master/README.md We hope that you will enjoyusingthelatestrelease oftheOxygen Git Clientadd-on as much as weenjoyeddevelopingit! Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[Ann] Webinar: Introduction to XSLT using Oxygen XML Editor
by Alin Belu 13 Oct '20

13 Oct '20

Hello, Our weekly live event series continues this Wednesday (October 14) with the “Introduction to XSLT using Oxygen XML Editor” webinar! During this event, you will learn how to process XML documents with a combination of XSLT, the most powerful language designed to process XML documents, and Oxygen, the tool that is most suited for this job. Whether you are a novice or you have been using Oxygen for years, Octavian Nadolu, software architect at Syncro Soft, will show you an easy-to-use workflow, as well as many great features that you may not have been aware of. This live webinar will also teach you how to resolve a variety of problems by introducing you to: * XSLT editing features, such as the Content Completion Assistant that makes XSLT editing easy and intuitive. * XSLT validation and how to use Oxygen’s validation abilities with the support of multiple XSLT processors and automatic validation to keep your XSLT document valid at all times. * XSLT transformations and how to create a simple XSLT transformation scenario and apply it to XML documents. * XPath Content Completion Assistant that shows the proposed list of XPath functions in the current context, documented with information from the W3C specifications. This is a free event and you can register at http://www.oxygenxml.com/evs2020-12.html Make sure to check the full list of the upcoming webinars on our Events page: https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

[Ann] New maintenance build available for oXygen 22.1 (2020100710)
by Adrian Buza 09 Oct '20

09 Oct '20

Dear oXygen users, We announce the release of a new maintenance build (2020100710) for oXygen 22.1 (XML Editor, XML Developer, XML Author, XML WebHelp, PDF Chemistry, 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#2020100710 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