- oXygen-user - www.oxygenxml.com

Re: [oXygen-user] New Git plugin for Oxygen
by Pierre Attar 25 Aug '17

25 Aug '17

Alex, It works now. Thanks a lot, Pierre Le 23/08/2017 à 08:15, Alex Jitianu a écrit : > > Hello, > > We've released a new version (1.0.8) that should fix this problem. > Please try again and let us know how it goes. > > Best regards, > Alex > -- > Alex Jitianu > <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger > http://www.oxygenxml.com > On 8/22/2017 6:19 PM, Pierre ATTAR wrote: >> 3 plugins are installed : >> Componize plugin >> A customization of the ditamap gui >> Xspec plugin >> >> Regards, Pierre >> >> >> Le 22 août 2017 14:49:20 GMT+02:00, Alex Jitianu >> <alex_jitianu(a)sync.ro> a écrit : >> >> Hello, >> >> Sorry about that... First of all let's make Oxygen start again. The >> first step is to identify Oxygen's options directory. Depending on the >> platform the options folder is located as follows: >> - Windows XP - [user-home-folder]\Application Data\com.oxygenxml >> - Windows Vista/7 - [user-home-folder]\AppData\Roaming\com.oxygenxml >> - Mac OS X - [user-home-folder]/Library/Preferences/com.oxygenxml >> - Mac OS X - ~/Library/Preferences/com.oxygenxml >> - Linux - [user-home-folder]/.com.oxygenxml >> >> Inside this directory search for and remove the directory: >> git.support <http://git.support>-1.0.7 >> >> Oxygen should now start again. >> >> Do you have, by any chance, any other plugins installed inside Oxygen? >> One of these plugins might be contributing a slf4j jar inside the main >> Oxygen ClassLoader. To find out which plugins are installed, please go >> to Options->Preferences... on the Plugins page. Nevertheless, we should >> take care of such situations so I will let you know as soon as we >> release a fix. >> >> Best regards, >> Alex >> >> >> -- >> Envoyé de mon truc mobile. Veuillez excuser ma brièveté. >

1 0

Re: [oXygen-user] New Git plugin for Oxygen
by Alex Jitianu 23 Aug '17

23 Aug '17

Hello, Sorry about that... First of all let's make Oxygen start again. The first step is to identify Oxygen's options directory. Depending on the platform the options folder is located as follows: - Windows XP - [user-home-folder]\Application Data\com.oxygenxml - Windows Vista/7 - [user-home-folder]\AppData\Roaming\com.oxygenxml - Mac OS X - [user-home-folder]/Library/Preferences/com.oxygenxml - Mac OS X - ~/Library/Preferences/com.oxygenxml - Linux - [user-home-folder]/.com.oxygenxml Inside this directory search for and remove the directory: git.support-1.0.7 Oxygen should now start again. Do you have, by any chance, any other plugins installed inside Oxygen? One of these plugins might be contributing a slf4j jar inside the main Oxygen ClassLoader. To find out which plugins are installed, please go to Options->Preferences... on the Plugins page. Nevertheless, we should take care of such situations so I will let you know as soon as we release a fix. Best regards, Alex -- Alex Jitianu <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com On 8/22/2017 1:24 PM, Pierre Attar wrote: > Hum, seems that there is a problem with the plugin, perhap's due to > franch language : unable to start oxygen since I install the plugin. > > Pierre > > Cannot start <oXygen/> XML Editor. > Due to:java.lang.reflect.InvocationTargetException > java.lang.reflect.InvocationTargetException > at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native > Method) > at sun.reflect.NativeConstructorAccessorImpl.newInstance(Unknown > Source) > at > sun.reflect.DelegatingConstructorAccessorImpl.newInstance(Unknown Source) > at java.lang.reflect.Constructor.newInstance(Unknown Source) > at ro.sync.ui.application.ApplicationLauncher.d(Unknown Source) > at ro.sync.ui.application.ApplicationLauncher.launch(Unknown Source) > at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) > at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) > at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) > at java.lang.reflect.Method.invoke(Unknown Source) > at ro.sync.exml.Oxygen.main(Unknown Source) > at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) > at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) > at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) > at java.lang.reflect.Method.invoke(Unknown Source) > at com.exe4j.runtime.LauncherEngine.launch(LauncherEngine.java:65) > at com.exe4j.runtime.WinLauncher.main(WinLauncher.java:101) > at > com.install4j.runtime.launcher.WinLauncher.main(WinLauncher.java:26) > Caused by: java.lang.LinkageError: loader constraint violation: when > resolving method > "org.slf4j.impl.StaticLoggerBinder.getLoggerFactory()Lorg/slf4j/ILoggerFactory;" > the class loader (instance of ro/sync/util/k/e) of the current class, > org/slf4j/LoggerFactory, and the class loader (instance of > ro/sync/util/ib) for the method's defining class, > org/slf4j/impl/StaticLoggerBinder, have different Class objects for > the type org/slf4j/ILoggerFactory used in the signature > at org.slf4j.LoggerFactory.getILoggerFactory(LoggerFactory.java:299) > at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:269) > at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:281) > at org.eclipse.jgit.util.FS.<clinit>(FS.java:160) > at org.eclipse.jgit.api.Git.open(Git.java:99) > at > com.oxygenxml.git.service.GitAccess.setRepository(GitAccess.java:134) > at > com.oxygenxml.git.view.WorkingCopySelectionPanel$1.itemStateChanged(WorkingCopySelectionPanel.java:104) > at javax.swing.JComboBox.fireItemStateChanged(Unknown Source) > at javax.swing.JComboBox.selectedItemChanged(Unknown Source) > at javax.swing.JComboBox.contentsChanged(Unknown Source) > at javax.swing.AbstractListModel.fireContentsChanged(Unknown Source) > at javax.swing.DefaultComboBoxModel.setSelectedItem(Unknown Source) > at javax.swing.DefaultComboBoxModel.addElement(Unknown Source) > at javax.swing.JComboBox.addItem(Unknown Source) > at > com.oxygenxml.git.utils.StagingPanelRefresh.addGitFolder(StagingPanelRefresh.java:108) > at > com.oxygenxml.git.utils.StagingPanelRefresh.checkForGitRepositoriesUpAndDownFrom(StagingPanelRefresh.java:99) > at > com.oxygenxml.git.utils.StagingPanelRefresh.execute(StagingPanelRefresh.java:48) > at > com.oxygenxml.git.utils.StagingPanelRefresh.call(StagingPanelRefresh.java:42) > at > com.oxygenxml.git.CustomWorkspaceAccessPluginExtension.applicationStarted(CustomWorkspaceAccessPluginExtension.java:42) > at ro.sync.exml.MainFrame.rvm(Unknown Source) > at ro.sync.exml.MainFrame.<init>(Unknown Source) > at ro.sync.exml.MainFrame.<init>(Unknown Source) > ... 18 more > > Le 22/08/2017 à 10:36, Alex Jitianu a écrit : >> Hello everyone, >> >> Those of you that are using Git might be interested to know that >> there is a new Git plugin for Oxygen [1]. If you want to give it a >> try, it can be quickly installed through Oxygen's add-on support >> [2][2.1]. In the beginning we focused on the essential functionality, >> the operations that are performed often, like committing, pulling >> changes etc. Another cool feature is the use of Oxygen's Diff tool >> [3] to highlight the changes. Moreover, if the file is in conflict >> (has been modified both by you and another), Oxygen's Three Way Diff >> [4] will show a comparison between the local change, the remote >> change, and the original base revision. >> >> Please let us know if you have any suggestions about how to make it >> better or what other functionality is worth adding. >> >> >> [1] https://github.com/oxygenxml/Oxygen-Git-Plugin#git-support-plugin >> [2] >> https://www.oxygenxml.com/doc/versions/19.0/ug-editor/topics/installing-and… >> [2.1] >> https://raw.githubusercontent.com/oxygenxml/Oxygen-Git-Plugin/master/build/… >> [3] >> https://www.oxygenxml.com/doc/versions/19.0/ug-editor/topics/file-compariso… >> [4] >> https://www.oxygenxml.com/doc/versions/19.0/ug-editor/topics/file-compariso… >> >> Best regards, >> Alex > >

2 2

Schematron Quickfix - selection?
by Wendell Piez 22 Aug '17

22 Aug '17

Hello oXygen friends, I need to build an ID-selector functionality into a Schematron Quickfix. That is, when an element fails validation against a Schematron (because an IDREF attrbute is missing or points to the wrong kind of element), I would like the user to be able to choose from IDs of available elements. Ideally, the Quickfix would acquire information from the elements being selected from, so the user would see not only their IDs but also certain values associated with them (to enable the correct selection). Not having found any hints in oXygen Help or in Quickfix documentation online, I suspect this isn't possible in the current version. (I'm using v19.0.) Am I wrong? If not, do any workarounds come to mind? Thanks, Wendell -- Wendell Piez | http://www.wendellpiez.com XML | XSLT | electronic publishing Eat Your Vegetables _____oo_________o_o___ooooo____ooooooo_^

3 3

Strange error with oxygen xml editor 19
by Bernhard Kleine 09 Aug '17

09 Aug '17

Today I tried to add a figure as well as a table in the author modus using special adding as XML and got both times a validation error. This error was not apparent when the very same figure or table was added while in text modus. The respective code in text mode is not different whether you add a figure or a table in author or text mode while validation sees something different. This is obviously a bug. Still in the test phase I have not enquired yet where to send bug reports. Regards Bernhard -- spitzhalde9 D-79853 lenzkirch bernhard.kleine(a)gmx.net www.b-kleine.com, www.urseetal.net - thunderbird mit enigmail GPG schlüssel: D5257409 fingerprint: 08 B7 F8 70 22 7A FC C1 15 49 CA A6 C7 6F A0 2E D5 25 74 09

2 1

olink verification
by Bernhard Kleine 26 Jul '17

26 Jul '17

The olinking does not work: I have a document and glossar. The links to the glossar are via olink. At some time this has been working, but I do not know what I have changed so that it does work any further. Linking to the Glossartest.xml document or to the xml:id="Glossartest" did not work either. What is wrong? the respective error messages: > [xslt] : Warning! Failure reading > file:/K:/BuchprojektSpringer/xlm/olinkdb.xml Cause: > java.io.FileNotFoundException: K:\BuchprojektSpringer\xlm\olinkdb.xml > (Das System kann die angegebene Datei nicht finden) > [xslt] Olink error: could not open target database 'olinkdb.xml'. > [xslt] Error: unresolved olink: targetdoc/targetptr = > 'Glossartest/glo.Bsx'. I have seen a faintly similar thread about olinking, but that did not help me. BTW Glossartest.xml and newbooktest.xml validate just fine. Regards Bernhard spitzhalde9 D-79853 lenzkirch bernhard.kleine(a)gmx.net www.b-kleine.com, www.urseetal.net - thunderbird mit enigmail GPG schlüssel: D5257409 fingerprint: 08 B7 F8 70 22 7A FC C1 15 49 CA A6 C7 6F A0 2E D5 25 74 09

2 3

Fatal error when using refactoring action
by Lionel MOIZEAU 12 Jul '17

12 Jul '17

Hi, When I use a refactoring action such as Insert element, I get the following error ! Description java.lang.IllegalArgumentException: Misdeclaration of xmlns namespace Severity Fatal System ID C:\Program Files\Oxygen XML Editor 19\refactoring\insert-element.xq<file:///C:\Program%20Files\Oxygen%20XML%20Editor%2019\refactoring\insert-element.xq> With the following trace. java.lang.IllegalArgumentException: Misdeclaration of xmlns namespace at net.sf.saxon.query.StaticQueryContext.declareNamespace(StaticQueryContext.java:750) at net.sf.saxon.s9api.XQueryCompiler.declareNamespace(XQueryCompiler.java:365) at ro.sync.exml.xmlrefactory.c.c.d.p(Unknown Source) at ro.sync.exml.xmlrefactory.c.c.d.g(Unknown Source) at ro.sync.exml.xmlrefactory.c.d.k(Unknown Source) at ro.sync.exml.xmlrefactory.c.c.c(Unknown Source) at ro.sync.exml.xmlrefactory.c.c.b(Unknown Source) at ro.sync.exml.xmlrefactory.ui.i.j(Unknown Source) at ro.sync.exml.xmlrefactory.ui.i.k(Unknown Source) at ro.sync.exml.xmlrefactory.ui.i.i(Unknown Source) at ro.sync.exml.xmlrefactory.ui.i$_b.rhe(Unknown Source) at ro.sync.ui.application.nb.run(Unknown Source) I tried to add a <test> element under the <foo> element in a file like this: <?xml version="1.0" encoding="UTF-8"?> <root> <foo/> </root> Can you help me? Best regards, Lionel MOIZEAU Head of Technical Information Department L-Acoustics Tel : +33 1 69 63 23 99 www.l-acoustics.com<http://www.l-acoustics.com/>

3 4

[Ann] New maintenance build available for oXygen 19.0 (2017062918)
by Adrian Buza 05 Jul '17

05 Jul '17

Dear oXygen users, We announce the release of a new maintenance build (2017062918) for oXygen 19.0 (XML Editor, XML Developer, XML Author, XML WebHelp). 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#2017062918 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 Tel: +1-650-352-1250 ext.202 Fax: +40-251-461482 support(a)oxygenxml.com http://www.oxygenxml.com

1 0

Current ditamap editor variable
by Lionel MOIZEAU 05 Jul '17

05 Jul '17

Hi ! Is there a way to get the current ditamap as an editor variable ? By current map I mean the one open in the DITA Maps manager or selected in the Root map dropdown menu [cid:image001.png@01D2F598.961ECA00] It would be very helpful ! Best regards, Lionel MOIZEAU Head of Technical Information Department L-Acoustics Tel : +33 1 69 63 23 99 www.l-acoustics.com<http://www.l-acoustics.com/>

2 2

[oXygen XML Editor Blog] - DITA Linking Strategies
by oXygen XML Editor Blog 01 Jul '17

01 Jul '17

oXygen XML Editor Blog /////////////////////////////////////////// DITA Linking Strategies Posted: 30 Jun 2017 06:11 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/NkzlLkUcD9Q/dita-lin… This small tutorial is based on the "DITA Linking Strategies" presentations I made for the DITA Europe 2016 and DITA North America 2017 conferences. It's a general overview about DITA linking possibilities and best practices. Also, it's meant as a continuation of the DITA Reuse Strategies blog post. According to Wikipedia: "A link, is a reference to data that the reader can directly follow either by clicking, tapping, or hovering." Basically, we should regard linking as yet another form of content reuse, except that instead of presenting the content in place, it re-directs the end user to some other resource. I'll start with describing linking at DITA Map level. Map-Level Linking A DITA Map uses topic references to assemble the content of a publication. <topicref href="installation.dita"> <topicref href="server_installation.dita"/> <topicref href="client_side_installation.dita"/> </topicref> Depending on the output format, the topic reference may be a link in the table of contents for the XHTML-based outputs or it may be interpreted as a content reference for the PDF-based output that generates a single monolith document. So the role of the topicref is dual, it may sometimes be regarded as a link to a topic and sometimes as a content reference. Chunking DITA topic modules should be kept as small as possible, but sometimes the end user may need to read more than one topic to achieve a single task. So, when publishing to HTML-based outputs, you will end up asking yourself this question:Should I prefer larger HTML files or more links in the TOC? And you should always consider these two ideas: Links are disruptive. Ideally, users would not need to jump around in content to read the entire story they are searching for. Small topics that are usually read consecutively by the end user can probably get merged together. For example, if the installation of your product requires installing both a server-side and a client-side component, by using DITA chunking you can choose to have separate DITA topic modules for each of the installation procedures but merge the topics together in the web-based outputs:<map> <title>User Guide</title> <topicref href="installation.dita" chunk="to-content"> <topicref href="server_installation.dita" toc="no"/> <topicref href="client_side_installation.dita" toc="no"/> </topicref> </map> You can read more about chunking in the DITA 1.3 specification. The DITA Style Guide also has a good overview about why it is preferable to write small topics and then merge them together using the chunking mechanism. Topic-Level Linking Links that appear inside topics can be divided into various categories and I'll discuss each of these categories separately. In-Content Links In-content links are links added manually in the topic content:<li>See: <xref href="http://www.../" format="html" scope="external"/></li> You should keep in mind that this kind of link is disruptive to the reading experience because when end users encounter them, they need to decide weather to read further on or to follow the link. On the other hand, this may sometimes be a good thing. For example, one of the installation steps may require the end user to download a certain library from an external website before continuing. You can read more about links in general in the DITA 1.3 specification. The DITA Style Guide, written by Tony Self, also discourages the use of in-content links. Related Links Related links are placed at the end of the DITA topic and they allow the end user to explore additional resources after the current topic has been read.<related-links> <link href="http://tomcat.apache.org/" format="html" scope="external"/> </related-links> To minimize disruption when reading the content in general, the preferred place where to place links is at the end of the generated HTML page. You can read more about related links in the DITA 1.3 specification. Defining Related Links using Relationship Tables Related links do not need to be manually added at the end of each topic. You can define relationship tables in the DITA Map:<reltable> <relrow> <relcell> <topicref href="client_side_installation.dita"/> </relcell> <relcell> <topicref href="server_installation.dita"/> </relcell> </relrow> …….. </reltable> These tables can define associations between two or more topics, associations that automatically contribute to the related links creation in the generated HTML output. Here are some benefits of using relationship tables: A topic should have as few links as possible defined directly within. This makes it easier to reuse the topic in various contexts and keeps it as separate as possible for other parts of the DITA project, decreasing the possibility of broken links. By default, links defined in relationship tables are bi-directional, allowing users to land on any of the topics when searching for solutions and find their way to the related ones. Using a relationship table separates the task of writing topics from the task of finding relationships between topics. You can read more about relationship tables in the DITA 1.3 specification. The DITA Style Guide also recommends using relationship tables. Indirect Links (Key References) All the link samples we've look at so far have been direct links, links that point to the target using the @href attribute. Indirect links require two steps: Define a key in the DITA Map for the target.<keydef keys="client_installation" href="client_side_installation.dita"/> Use the defined key to reference the target resources.<xref keyref="client_installation"/> Here are some of the benefits of indirect linking: Offers the ability to reuse link target text and meta data. If you want to have custom text for a certain link, you can define it directly in the DITA Map:<keydef keys="dita_ot_website" href="http://www.dita-ot.org/" format="html" scope="external"> <topicmeta> <linktext>DITA Open Toolkit Web Site</linktext> </topicmeta> </keydef>and then add key references in all other places:<xref keyref="dita_ot_website"/> Easier conditional linking (including links to topics that sometimes may be missing). If you want your topic to link either to one target or to another depending on the filtering/profiling conditions, instead of adding profiling directly on the link, you can add the profiling conditions directly in the DITA Map: <topicref keys="slicing" href="slicing_vegetables_for_experts.dita" audience="expert"/> <topicref keys="slicing" href="slicing_vegetables_for_novices.dita" audience="novice"/> <keydef keys="slicing" audience="noLink"><topicmeta><keywords> <keyword>Slicing</keyword></keywords></topicmeta> </keydef>and then link to the key from each topic: <xref keyref="slicing"/> Easier link management. A good overview about all the outbound links in your project helps you maintain and control lists of allowed external web sites. With indirect references, you can define all references to external resources in a separate DITA Map. An example of a DITA project using indirect links to achieve separation of links by purpose can be found here: https://github.com/oxygenxml/dita-project-best-practices. Makes it easier to move/rename topics. When you move or rename a topic referenced via indirect links, only the link defined in the DITA Map will break, making it easier to fix broken links. There is an overview about indirect addressing on the DITA XML Org website. The DITA 1.3 specification also has a chapter about indirect links. Auto-Generated Links Until now, I've talked about manually added links, either in the topic or in relationship tables. Using the DITA @collection-type attribute, you can define relationships between parent and child topic references in the DITA Map, relationships that result in automatic links added between them: <topicref href="installation.dita" collection-type="sequence"> <topicref href="server_installation.dita"/> <topicref href="client_side_installation.dita"/> </topicref> There are 3 useful types of @collection-type values: Unordered - Links are generated from parent to children, and from children to parent. Family - Links are generated from parent to children, from children to parent, and from sibling to sibling. Sequence - Links are generated from parent to children, from children to parent, and from child to previous sibling (if applicable) and next sibling (if applicable). You can read more about auto-generated links in the DITA Style Guide. Conditional Links in Distinct Publications You may publish documentation for multiple products from the same DITA content. Also, you may want to have links point to various targets depending on the product for which you want to publish the documentation. Or, you may want to suppress links completely in certain publications. When using direct linking, you will need to profile each link depending on the publication:Find our more about slicing vegetables: <xref href="slicing_vegetables_for_experts.dita" audience="expert"/> <xref href="slicing_vegetables_for_novices.dita" audience="novice"/>.With indirect links, you can define the profiling attributes as DITA Map level: <topicref keys="slicing" href="slicing_vegetables_for_experts.dita" audience="expert"/> <topicref keys="slicing" href="slicing_vegetables_for_novices.dita" audience="novice"/>and thus, simplify the reference made in the topic content:Find our more about slicing vegetables: <xref keyref="slicing/>. Conditional Links in the Same PublicationUsing DITA 1.3 key scopes, you can reuse a topic multiple times in a DITA Map and have each referenced topic contain links to various target topics. For example, if my preparing_vegetables.dita topic has a link:<link keyref="slicing"/>you can define various key scopes in the DITA Map that bind the "slicing" key to various targets: <topichead navtitle="Cooking for Experts" keyscope="expert"> <topicref href="preparing_vegetables.dita" keys="preparing"/> <topicref href="slicing_vegetables_for_experts.dita" keys="slicing"/> </topichead> <topichead navtitle="Cooking for Novices" keyscope="novice"> <topicref href="preparing_vegetables.dita" keys="preparing"/> <topicref href="slicing_vegetables_for_novices.dita" keys="slicing"/> </topichead>This previous blog post contains more details about key scopes. Link Text When linking to an external resource or to a DITA topic or element, the publishing engine will attempt to deduce the link text from the target context. For example, the link to a DITA topic or element that contains a <title> will use that title as the link text. The link to an external resource (for example to http://www.oxygenxml.com) will, by default, use the HTTP location as the link text. You can also customize each link text individually. So, ask yourself this question: Should I leave the link text to be automatically computed or should I set a more friendly text? For internal links to elements that have a title, in general it is more flexible to not set a custom text and let the publishing engine decide one for you. For external links, you should usually specify your custom link text. Should I Link or Should I Reuse? Suppose you want to bring a certain paragraph, note, or section to the end user's attention. If that particular target element is not very large, you should always reuse it (using a content reference) instead of linking to it. Conclusions As with all large projects, managing links in a growing DITA project can be problematic, so you need to become organized. As an overview of what we've discussed so far, I suggest the following best practices: Linking is a form of reuse so: Reuse small pieces of content instead of linking to them Avoid too much linking (linking is disruptive) Use indirect links. It will allow you to reuse link text and make profiling/filtering easier while giving you a better overview of the outbound links for your project. If you want to experiment with the various linking strategies I discussed above, you can find some samples here: https://www.oxygenxml.com/forum/files/linking-strategies-samples.zip. -- You are subscribed to email updates from "oXygen XML Editor Blog." To stop receiving these emails, you may unsubscribe now: https://feedburner.google.com/fb/a/mailunsubscribe?k=y_tRXtumvTurKTedh51Jnl… Email delivery powered by Google. Google Inc., 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States

1 0

[oXygen XML Editor Blog] - Checking terminology when editing in Oxygen XML Editor
by oXygen XML Editor Blog 17 Jun '17

17 Jun '17

oXygen XML Editor Blog /////////////////////////////////////////// Checking terminology when editing in Oxygen XML Editor Posted: 15 Jun 2017 11:28 PM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/OPQOXtUW3J8/checking… In this blog post I will try to give a general overview about the current possibilities you have available to impose your own language checking rules when working with Oxygen XML Editor. Builtin support Oxygen comes bundled with the popular Hunspell spell checker and besides the regular bundled dictionaries for English, German, Spanish and French it allows you to install new dictionaries, either for other languages or custom dictionaries (for example dictionaries of medical terms) which you can build separately: https://www.oxygenxml.com/doc/versions/19.0/ug-editor/topics/spell-dictiona…. Besides the spell checker, Oxygen also has support for Auto-correct and you can add your own Auto-correct pairs to Oxygen. Commercial alternatives Acrolinx is a very popular commercial tool for checking content for consistency and terminology. The plugins Acrolinx developed for Oxygen standalone, Oxygen Eclipse plugin and Oxygen Web Author allow you to run the Acrolinx checker directly from inside the application. HyperSTE is yet another popular commercial tool for checking content and terminology. They also have a plugin for Oxygen standalone. Open source alternatives LanguageTools is an Open Source proofreading program for English, French, German, Polish, and more than 20 other languages . There is an open source plugin for Oxygen available on GitHub. The DITA Open Toolkit terminology checker plugin from Doctales contains Schematron rules checking that various words adhere to the terminology dictionaries which are custom built using DITA. Building your own terminology checker The fastest and simplest way to build a simple terminology checker is by using Schematron rules. The Doctales plugin is a good example for this. At some point, as the terminology dictionary keeps growing you may encounter delays and slow downs when editing the documents and validating it using the custom Schematron rules. So an alternative to this is by using our Author SDK to build your own Oxygen plugin which can use our API to check the content and then add highlights. The LanguageTools open source plugin may be a good starting example for this. -- You are subscribed to email updates from "oXygen XML Editor Blog." To stop receiving these emails, you may unsubscribe now: https://feedburner.google.com/fb/a/mailunsubscribe?k=y_tRXtumvTurKTedh51Jnl… Email delivery powered by Google. Google Inc., 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States

1 0

[oXygen XML Editor Blog] - Batch converting HTML to XHTML
by oXygen XML Editor Blog 13 Jun '17

13 Jun '17

oXygen XML Editor Blog /////////////////////////////////////////// Batch converting HTML to XHTML Posted: 12 Jun 2017 02:03 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/aF0B0Z1Zw1I/batch-co… Let's say you have a bunch of possible not-wellformed HTML documents already created and you want to process them using XSLT. For example you may want to migrate the HTML to DITA using the predefined XHTML to DITA Topic transformation scenario available in Oxygen. So you need to create valid XML wellformed XHTML documents from the existing HTML documents and you need to do this in a batch processing automated fashion. There are lots of open source projects which deliver processors which can convert HTML to its wellformed XHTML equivalent. For this blog post we'll use HTML Tidy. Here are a couple of steps to automate this process: Create a new folder on your hard drive (for example I created one on my Desktop: C:\Users\radu_coravu\Desktop\tidy) and download there the HTML Tidy executable specific for your platform: http://binaries.html-tidy.org/. In the same folder with the Tidy executable create an ANT build file called build.xml having the following content: <project basedir="." name="TidyUpHTMLtoXHTML" default="main"> <basename property="filename" file="${file}"/> <target name="main"> <exec command="tidy.exe -o ${output.dir}/${filename} ${file}"/> </target> </project> Link in the Oxygen Project view the entire folder where the original HTML documents are located. Right click the folder, choose Transform->Configure Transformation Scenarios... and create a new transformation scenario of type ANT Scenario. Modify the following properties in the transformation scenario: Change the scenario name to something relevant like HTML to XHTML. Change the Working Directory to point to the folder where the ANT build file is located, in my case: C:\Users\radu_coravu\Desktop\tidy. Change the Build file to point to your custom build.xml, in my case: C:\Users\radu_coravu\Desktop\tidy\build.xml. In the Parameters tab add a parameter called file with value ${cf} and a parameter called output.dir with value the path to the output folder where the equivalent XHTML files will be stored, in my case I set it to: C:\Users\radu_coravu\Desktop\testOutputXHTML. Apply the newly transformation scenario on the entire folder containing the HTML documents. At the end in the output folder you will find the XHTML equivalents of the original HTML files, XHTML documents which can later be processed using XML technologies like XSLT or XQuery. -- You are subscribed to email updates from "oXygen XML Editor Blog." To stop receiving these emails, you may unsubscribe now: https://feedburner.google.com/fb/a/mailunsubscribe?k=y_tRXtumvTurKTedh51Jnl… Email delivery powered by Google. Google Inc., 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States

1 0

Saxon config file resources/fileExtension not supported
by Florent Georges 02 Jun '17

02 Jun '17

Hi, Not a big deal, but the element resources/fileExtension seems not to be supported when editing a Saxon config file. Some details there: http://saxon.markmail.org/thread/mdgdftkssbhbsjzr I just created a new file in oXygen, choosing "Saxon Config File". Regards, -- Florent Georges H2O Consulting http://h2o.consulting/

2 1

Chemistry PDF: build fails Cannot convert string "" to xs:decimal: no digits in value;
by Yves Barbion 27 Apr '17

27 Apr '17

Hi I'm trying to create a PDF from DITA content, using Chemistry but my build fails. I get this error message: BUILD FAILED C:\Program Files\Oxygen XML Author 19\frameworks\dita\DITA-OT2.x\build.xml:45: The following error occurred while executing this line: C:\Program Files\Oxygen XML Author 19\frameworks\dita\DITA-OT2.x\plugins\com.oxygenxml.pdf.css\build.xml:194: The following error occurred while executing this line: C:\Program Files\Oxygen XML Author 19\frameworks\dita\DITA-OT2.x\plugins\com.oxygenxml.pdf.css\build.xml:132: Fatal error during transformation using C:\Program Files\Oxygen XML Author 19\frameworks\dita\DITA-OT2.x\plugins\com.oxygenxml.pdf.css\xsl\post-process.xsl: Cannot convert string "" to xs:decimal: no digits in value; SystemID: file:/C:/Program%20Files/Oxygen%20XML%20Author%2019/frameworks/dita/DITA-OT2.x/plugins/com.oxygenxml.pdf.css/xsl/post-process-tables.xsl; Line#: 100; Column#: 80 Any ideas? Thanks Yves

2 1

[oXygen XML Editor Blog] - DITA Inheritance Hierarchy
by oXygen XML Editor Blog 25 Apr '17

25 Apr '17

oXygen XML Editor Blog /////////////////////////////////////////// DITA Inheritance Hierarchy Posted: 24 Apr 2017 02:20 PM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/_uE1DzO51sg/dita-inh… The DITA standard is based on this concept of inheritance which allows extending or restricting the vocabulary while allowing the XML content to still be regarded as valid DITA. Even in the DITA standard there are various element which are specializations of others (for example "b" is a specialization of ph"). The XSLT styesheets which are used for publishing match all DITA elements by the value of their @class attribute so knowing how elements may extend each other may be useful when customizing the DITA XSLTs. A DITA inheritance hierarchy list for the base DITA specification is presented below. Would you consider it useful if a future version of Oxygen would have some kind of a tool to show such hierarchies even for custom DITA specializations? topic/copyryear topic/foreign mathml-d/mathml svg-d/svg-container topic/author topic/example topic/unknown topic/titlealts topic/linktext topic/category topic/data relmgmt-d/change-request-reference relmgmt-d/change-person relmgmt-d/change-request-id relmgmt-d/change-request-system relmgmt-d/change-completed relmgmt-d/change-started ut-d/sort-as relmgmt-d/change-item relmgmt-d/change-organization relmgmt-d/change-summary concept/data glossentry/glossPartOfSpeech glossentry/glossProperty glossentry/glossStatus relmgmt-d/change-revisionid topic/longdescref topic/audience topic/abstract concept/abstract glossentry/glossdef topic/related-links topic/body task/taskbody concept/conbody glossentry/glossBody troubleshooting/troublebody reference/refbody topic/ph hi-d/overline hi-d/line-through hi-d/sub pr-d/sep equation-d/equation-inline pr-d/repsep equation-d/equation-number hi-d/tt task/cmd pr-d/synph sw-d/userinput ut-d/coords pr-d/oper hi-d/sup pr-d/var sw-d/msgph pr-d/codeph ui-d/uicontrol hi-d/i hi-d/u sw-d/filepath sw-d/systemoutput pr-d/delim hi-d/b ui-d/menucascade topic/object topic/fig ut-d/imagemap pr-d/syntaxdiagram equation-d/equation-figure topic/featnum topic/lines topic/brand topic/state topic/source topic/link topic/vrm topic/sli topic/navtitle topic/figgroup pr-d/synblk pr-d/fragment ut-d/area pr-d/groupcomp pr-d/groupseq pr-d/groupchoice topic/note hazard-d/hazardstatement concept/note glossentry/glossScopeNote glossentry/glossUsage topic/ol task/substeps task/steps topic/stentry task/choption reference/propvalue reference/propvaluehd reference/propdeschd reference/propdesc reference/proptype reference/proptypehd task/choptionhd task/chdesc task/chdeschd topic/dlentry pr-d/plentry topic/vrmlist topic/entry topic/fn pr-d/synnote topic/xref mathml-d/mathmlref svg-d/svgref concept/xref glossentry/glossAlternateFor pr-d/synnoteref pr-d/fragref pr-d/coderef topic/component topic/series topic/bodydiv reference/refbodydiv troubleshooting/troubleSolution concept/conbodydiv topic/data-about topic/tgroup topic/keywords topic/boolean topic/critdates topic/strow task/chrow reference/property topic/simpletable reference/properties task/choicetable topic/linklist topic/revised topic/table topic/dt pr-d/pt topic/image hazard-d/hazardsymbol concept/image glossentry/glossSymbol topic/ul hazard-d/messagepanel task/choices task/steps-unordered topic/p concept/p glossentry/glossSurfaceForm troubleshooting/responsibleParty topic/q topic/linkinfo topic/dd pr-d/pd topic/lq topic/prodinfo topic/dl pr-d/parml topic/prolog topic/indextermref topic/copyright topic/div equation-d/equation-block topic/sthead task/chhead reference/prophead topic/tbody topic/searchtitle topic/colspec topic/created topic/tm topic/text topic/cite topic/li hazard-d/howtoavoid task/step task/substep hazard-d/consequence hazard-d/typeofhazard task/choice task/stepsection topic/permissions topic/no-topic-nesting topic/dlhead topic/prodname topic/index-base indexing-d/index-sort-as indexing-d/index-see indexing-d/index-see-also topic/indexterm topic/copyrholder topic/longquoteref topic/required-cleanup topic/ddhd topic/sl topic/draft-comment topic/section task/postreq task/result troubleshooting/remedy task/tasktroubleshooting concept/section glossentry/glossAlt task/context troubleshooting/cause task/steps-informal reference/refsyn task/prereq troubleshooting/condition topic/pre sw-d/msgblock pr-d/codeblock ui-d/screen topic/topic troubleshooting/troubleshooting concept/concept glossgroup/glossgroup glossentry/glossentry reference/reference task/task topic/platform topic/alt topic/keyword ui-d/shortcut markup-d/markupname xml-d/parameterentity xml-d/xmlatt xml-d/numcharref xml-d/xmlpi xml-d/textentity xml-d/xmlnsname xml-d/xmlelement pr-d/parmname pr-d/option sw-d/cmdname ui-d/wintitle ut-d/shape sw-d/varname pr-d/apiname pr-d/kwd sw-d/msgnum topic/thead topic/publisher topic/desc topic/term abbrev-d/abbreviated-form topic/title concept/title glossentry/glossShortForm glossentry/glossAbbreviation glossentry/glossSynonym glossentry/glossterm glossentry/glossAcronym topic/itemgroup task/steptroubleshooting task/tutorialinfo task/info task/stepxmp task/stepresult topic/row topic/linkpool topic/param topic/shortdesc topic/resourceid topic/dthd topic/metadata relmgmt-d/change-historylist topic/othermeta topic/prognum topic/sectiondiv -- You are subscribed to email updates from "oXygen XML Editor Blog." To stop receiving these emails, you may unsubscribe now: https://feedburner.google.com/fb/a/mailunsubscribe?k=y_tRXtumvTurKTedh51Jnl… Email delivery powered by Google. Google Inc., 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States

1 0

[Ann] New maintenance build available for oXygen 19.0 (2017042020)
by Adrian Buza 24 Apr '17

24 Apr '17

Dear oXygen users, We announce the release of a new maintenance build (2017042020) for oXygen 19.0 (XML Editor, XML Developer, XML Author, XML WebHelp). 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#2017042020 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 Tel: +1-650-352-1250 ext.202 Fax: +40-251-461482 support(a)oxygenxml.com http://www.oxygenxml.com

1 0

Announce: A UBL editing framework for the oXygenXML editor
by G. Ken Holman 17 Apr '17

17 Apr '17

Fellow UBL-Dev list members, For those of you who work with the http://www.oxygenxml.com editing tool, I have created a framework for three OASIS Universal Business Language (UBL) vocabularies: UBL 2.1 (ISO/IEC 19845:2015), UBL 2.2 csd01 (in development) and UBL 2.2 Pre-award csd02wd01pa01 (in development). The framework can be downloaded from here: http://www.CraneSoftwrights.com/resources/ubl/#oxygenubl I am planning improvements, so keep an eye out for any new releases of the tool here: http://www.CraneSoftwrights.com/resources/crane-resources.rss ... as I won't post notifications of updates to the mail list. Please let me know (off list) if you have any questions or issues with this. . . . . . . . Ken cc: UBL-Dev, UBL-TC, oXygen user list -- UBL introduction lecture - Exchange Summit - Orlando, FL - 2017-04-24 | Contact info, blog, articles, etc. http://www.CraneSoftwrights.com/u/ | Check our site for free XML, XSLT, XSL-FO and UBL developer resources | Streaming hands-on XSLT/XPath 2 training class @ US$45 (5 hours free) |

2 1

foreign markup in ISO Schematron launched by NVDL
by Imsieke, Gerrit, le-tex 10 Apr '17

10 Apr '17

Hi, I’m calling an ISO Schematron from an NVDL in oXygen 19 which works fine so far. Now we were wondering whether we may also use foreign markup, in particular XSLT. But I don’t see an obvious way how to pass allow-foreign=true to the Schematron validator (not sure whether it is relying on the default XSLT2 ISO Schematron implementation anyway). This is not important for our current use case. Just asking out of interest and because Matthieu raised the question. Gerrit -- Gerrit Imsieke Geschäftsführer / Managing Director le-tex publishing services GmbH Weissenfelser Str. 84, 04229 Leipzig, Germany Phone +49 341 355356 110, Fax +49 341 355356 510 gerrit.imsieke(a)le-tex.de, http://www.le-tex.de Registergericht / Commercial Register: Amtsgericht Leipzig Registernummer / Registration Number: HRB 24930 Geschäftsführer: Gerrit Imsieke, Svea Jelonek, Thomas Schmidt, Dr. Reinhard Vöckler

5 6

Re: [oXygen-user] oXygen XML 19: import keyboard shortcuts from previous version?
by Franz-Josef Knelangen 07 Apr '17

07 Apr '17

Hi Yves, my keyboard shortcuts were updated somehow – my clunky Alt+Shift+E for “Select Element” works in oXygen 19 where I never defined it … Don’t know where/how these are stored. Best, Franz-Josef ________________________________ AKG Software Consulting GmbH Franz-Josef Knelangen Uhlandstraße 12 79423 Heitersheim Germany Tel.: +49 (0)7634 5612-611 Fax: +49 (0)7634 5612-300 E-Mail: fjk(a)akgsoftware.de Internet: www.akgsoftware.de<http://www.akgsoftware.de> Geschäftsführer: Dipl.-Ing. Artur K. Günther, Dipl.-Ing. Arno Brüggemann, Dipl.-Ing. (FH) Bernhard Feser, Dipl.-Ing. Jens Günther Sitz der Gesellschaft: Heitersheim, HRB 310383 (Amtsgericht Freiburg) Von: oXygen-user [mailto:oxygen-user-bounces@oxygenxml.com] Im Auftrag von Yves Barbion Gesendet: Freitag, 7. April 2017 11:34 An: oXygen User ML <oxygen-user(a)oxygenxml.com> Betreff: [oXygen-user] oXygen XML 19: import keyboard shortcuts from previous version? Hi oXy folks Is there a way (import/export maybe?) to get my keyboard shortcuts from previous versions into oXygen XML Editor/Author 19? Thanks Yves

2 1

A way to force catalog reload ?
by Christophe Marchand 07 Apr '17

07 Apr '17

Hello ! I use a per-project catalog, defining ${pdu}/catalog.xml in preferences / XML / Catalogs When I edit the catalog in Oxygen, or when the catalog is modified outside, the URI resolver is not updated. More, if I open another project, then re-open the project with the modified catalog, URI resolver still uses the previous version of the catalog. Is there a way to force the catalog reload, without stopping / starting oXygen ? Best, Christophe

2 2

oXygen XML 19: import keyboard shortcuts from previous version?
by Yves Barbion 07 Apr '17

07 Apr '17

Hi oXy folks Is there a way (import/export maybe?) to get my keyboard shortcuts from previous versions into oXygen XML Editor/Author 19? Thanks Yves

1 0

Training courses for DITA users working with oXygen XML Author
by Muneat Mahfud 31 Mar '17

31 Mar '17

My name is Muneat and I work with Mekon. In the past, we have provided several training courses that covered DITA and oXygen XML Author and we are now planning to offer two new classes in the next few months. The first one will be in Scotland on 26/04/2017 - 28/04/2017 and the second one in London on 10/05/2017 - 12/05/2017 The course covers DITA concepts as well as DITA authoring with oXygen XML Author. It is a hands-on training course where you will learn about oXygen XML Author's specific support for DITA, including how to edit topics and maps, how to reuse and manage content, and how to publish from oXygen through the DITA Open Toolkit. For more details please see our course page at: http://mekon.com/consulting-and-training/training/dita-authoring-oxygen-xml… and feel free to contact me directly if you need any additional information. Thank you, Muneat

1 0

[Ann] Oxygen 19.0 beta
by Oxygen XML Editor Support (Radu Coravu) 16 Mar '17

16 Mar '17

Hi everybody, We are working hard preparing to launch Oxygen 19.0 in about 3 weeks and we found some time to prepare and upload Oxygen 19.0 (standalone and Eclipse plugin) beta kits on our web site: https://www.oxygenxml.com/beta19/oxygenxml_editor.html The list of new Oxygen 19 features can be found here: https://www.oxygenxml.com/whatisnew19.html It would be great if you would find the time to test Oxygen 19.0 and give us some feedback. If you start the Oxygen 19.0 beta application and it requests a license key you can request one from our web site or drop us an email and we'll generate one for you. As usual we've put quite a lot of effort into DITA, Docbook editing improvements, WebHelp publishing improvements, XSLT enhancements plus various component updates. A short what's new list grouped by category can be found below: 1) DITA: https://www.oxygenxml.com/whatisnew19.html#19DITA Fast Create Multiple Topics at Once DITA Reusable Components View Convert between DITA Topic Types Introducing Chemistry - Built-in CSS-based PDF Processor for Publishing DITA to PDF Improvements for Converting DITA to PDF using CSS Master Files Support for DITA Improved DITA Map Validation Content Completion for IDs in Text Mode 2) DocBook: https://www.oxygenxml.com/whatisnew19.html#19DocBook Support for DocBook 5.1 Publish Tracked Changes and Comments to PDF Output Multimedia Support in DocBook 3) XSLT: https://www.oxygenxml.com/whatisnew19.html#19XSLT Convert Between Multiple xsl:if and xsl:choose XSLT Code Quality Assurance Improved Error Localization in XPath Expressions Improved Refactoring Support for XSLT 4) WebHelp: https://www.oxygenxml.com/whatisnew19.html#19WebHelp Search Auto-Completion Phrase Search Support Improved Sorting for Search Results Show Missing Terms for Search Results Search Results Pagination 5) Component Updates: https://www.oxygenxml.com/whatisnew19.html#19Component_Updates Exist 3.0 Saxon Updated to 9.7.0.15 DITA OT 2.4.4 DITA For Publishers Plugins Updated to 1.0.0RC26 TEI Schemas 3.1.0 / TEI Stylesheets 7.42.0 DocBook XSLT Stylesheets 1.79.2 EpubCheck 4.0.2 DITA OT OOXML Plugin 1.2 Calabash 1.1.15 jQuery 3.1.1 XSpec 0.5.0 Neko 1.9.22 Apache Ant 1.9.8 Markdown Plugin for DITA OT 1.2.3 6) As usual we also added lots of new API: https://www.oxygenxml.com/whatisnew19.html#19API Regards, Radu Radu Coravu <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com

1 0

conformance to the XML 1.0 character set
by Michael Hopwood 09 Mar '17

09 Mar '17

Dear oxygen colleagues, I’d like to check a large XML file for conformance to the XML 1.0 character set: https://www.w3.org/TR/REC-xml/#charsets Is this check bundled in with well-formedness and/or validation checks? Or is there another feature somewhere in oxygen I can use? Best wishes, Michael Hopwood Technical Writer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Global Legal Entity Identifier Foundation (GLEIF) Bleichstrasse 59, 60313, Frankfurt am Main, Germany Web: www.gleif.org . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Global Legal Entity Identifier Foundation (GLEIF) Bäumleingasse 22, 4051, Basel, SwitzerlandChairman of the Board: Gerard HartsinkCEO: Stephan WolfThis message may contain confidential and/or privileged information. If you are not the intended recipient or if you have received this message in error, please notify the sender and delete this message. Any unauthorized copying, disclosure or distribution of this message is strictly forbidden.

2 1

Can custom XML Refactoring operation resolve XIncludes via doc()?
by Amanda Galtman 07 Mar '17

07 Mar '17

Hi, I see from the following doc page that custom XML Refactoring operations disable the XInclude mechanism. https://oxygenxml.com/doc/versions/18.1/ug-editor/topics/custom-refactoring… I understand the purpose of "safe mode" for the file that the refactoring operation is modifying. In my case, my refactoring operation needs to retrieve data from an auxiliary XML file using doc(). The other XML file is a DocBook targetset file. Read-only access to the targetset file is good enough, but I really need to get inside the subordinate XInclude files. Is this possible in the context of a custom XML Refactoring XSLT operation? Thanks, Amanda

3 5

My code snippets lost
by Karl Stubsjoen 25 Feb '17

25 Feb '17

A bunch of code templates that I created are missing now. I've been using them for a long time and now they are just gone! Might they be somewhere saved on disk? Where should I go looking for them? Karl..

3 3