- oXygen-user - www.oxygenxml.com

oxygenxml and multitrans?
by Jakob Fix 01 Oct '15

01 Oct '15

Hello, I've been wondering whether there is some kind of API or a plugin available for OxygenXML with the translation workbench tool called MultiTrans. cheers, Jakob.

2 2

Free Webinar Today [DITA Glass]
by Radu Coravu 29 Sep '15

29 Sep '15

Hi everybody, Today, Sep 16 between 11:00 AM and 12:30 PM EDT Comtech and Oxygen are hosting a free webinar about dynamic content conversions, a feature we added in Oxygen 17.0. So if you want to find out more details or to join us please follow this link: http://comtech-serv.com//index.php?main_page=product_info&cPath=28_2_149&pr… Regards, Radu Radu Coravu <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com

3 3

Xquery unit test framework
by Erik Zander 28 Sep '15

28 Sep '15

Hi all, In oxygen there's the template for creating xspec tests for XSLT and it can by looking at the XSLT file create some of the tests. I wonder if there's something similar for xquery? Best Regards Erik Zander

2 1

This might have been foolish, but ...
by Ben McGinnes 26 Sep '15

26 Sep '15

Hello, So I was poking around in the oxygen/templates/ directory and had a little look at the ePub 3.0 template in there. Given what I've said about ePub 3.0 and internal structure in the past, it was inevitable that I modify the template in there to add a version with subdirectories for assorted purposes and it certainly looks like it's behaving at least as far as being an additional global template. Obviously there would be no point in mentioning it here if I wasn't sharing. Anyone interested can find it here: https://github.com/adversary-org/epub-tools/tree/master/oxygen/templates In that directory you'll find the original template, mainly for comparison (and yes, making an oxygen/templates/ path in that repo is solely to make it obvious to others where to install/copy to). The template I'm referring to here is the one called "EPUB 3.0 DroidBook.epub.bin" and is so named for the embedded font I've dumped in there (Droid Sans Fallback Full). There's another template in there as well, "EPUB 3.0 BrythonBook.epub.bin" and you're welcome to play with it, of course, but I should warn you that it is *highly* experimental. It's basically built on the DroidBook template, but includes a complete implementation of Brython. Brython is an implementation of Python 3.3 for browsers and javascript. It allows you to use python code in the same way as one might normally use javascript and since ePub 3 is supposed to allow a subset of javascript I figured I'd see whether I could get this thing to work in an ePub too. I won't be too surprised if it goes nowhere and it's quite possible it might do Bad Things™ instead. On the other hand, there's nothing lost by trying it and seeing what breaks. Even if it doesn't play nicely with ePub, it ought to play quite well with regular HTML and XHTML projects. As is amply demonstrated on its website and described on GitHub: http://brython.info/ https://github.com/brython-dev/brython If anyone does decide to play with Brython and ePub, I'll be interested to hear how it goes; whether that be a success or a catastrophic failure. With regards to licenses; the original templates from oXygenXML followed fairly basic specifications from the IDPF, Brython uses a BSD license (the license file is in the ePub, in the resurced subdirectory with the README and the Droid Sans font). My bits barely qualify as needing a license, but if you must have one then my WTFNMF Public License ought to do the job nicely. You can find the terms of that here: https://github.com/adversary-org/wtfnmf Oh, yes, the manifest for the Brython experiment does include all the files for the implementation (you're welcome). So it should just be a matter of calling brython.js by its relative path in any HTML or XHTML file to make it work. At least in theory, there's been zero testing yet. Regards, Ben -- Ben McGinnes http://www.adversary.org/ Twitter: benmcginnes Writer, Systems Administrator, Trainer, ICT Consultant GPGME Python 3 API Maintainer, GNU Privacy Guard https://www.gnupg.org/ Encrypted email preferred, primary OpenPGP/GPG key: 0x321E4E2373590E5D OpenPGP/GPG key here: http://goo.gl/GVGwT and http://goo.gl/SDs0D OpenPGP/GPG key transition: http://www.adversary.org/keyswitch.txt.asc

1 0

Autumn conferences
by George Bina 22 Sep '15

22 Sep '15

Hi all, After some quiet time during the summer, we will have a busy schedule this autumn. First, we will be in San Jose, California, next week on Oct 1-2 at the Information Development World conference. You can meet us at the oXygen XML Editor stand in the exhibition area or attend or session on Friday, 2:00pm-2:45pm: Single-Source Publishing Across Multiple Formats https://www.eiseverywhere.com/ehome/113382/schedule/ After that, we will participate also this year at the TEI Members Meeting in Lyon, France. We will host a half day workshop on Oct 28 http://tei2015.huma-num.fr/en/workshops/#item3 If you attend TEI Members Meeting and you are interested in extending the TEI support in oXygen or to find the latest additions to oXygen please register to join us there: https://docs.google.com/forms/d/1Bd9fGF7CY9V5gh9o7ukKhLX-iVMezu3LV2wVOVucXu… November will be the busiest month, we start with the TCWorld conference by Tekom, taking place in Stuttgart, where we have 3 presentations in the main conference program, plus one product presentation, plus a larger stand where you are welcome to meet us http://conferences.tekom.de/tcworld15/conference-program/conference-program/ A few days after Tekom we move to Munich and we turn into hosts, as we organize the second edition of the DITA-OT Day event, a conference dedicated to the core engine behind DITA implementations, the DITA-OT open source project: http://www.oxygenxml.com/events/2015/dita-ot_day.html This is a free event but registration is required. We organize the DITA-OT Day in the pre-conference day of DITA Europe, and at the same location, so it should be really easy to attend both events - or event all 3 events in one trip: TCWorld, DITA-OT Day and DITA Europe. We plan to end the 2015 events with DITA Europe where we will have a stand where you can meet our team as well as two interesting presentations at the conference https://ditaeurope.infomanagementcenter.com/ Best Regards, George -- George Cristian Bina <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com

1 0

In-element whitespace and Author Mode
by Andreas Wagner 18 Sep '15

18 Sep '15

Dear list, I am sorry for bringing up yet another whitespace question. I almost believe that in XML the devil lives in the whitespaces. Also, it is quite possible that our problem is specific to our particular situation and of no interest to other projects. But then again, maybe someone is able to help nonetheless. We deal with TEI xml documents recording linebreaks that in many cases are not meant to represent a word boundary: <lb n="016_011"/>que con el pre<lb break="no" rendition="#noHyphen" n="016_012"/>sidente o juez que reside en la prouincia: puede <lb n="016_013"/>hazer thesoreros y receptores en su prouincia: In order to improve readability of the XML source, all our lines begin at the leftmost position of the line no matter the nesting level the current the paragraph is at. The exception is lines that begin with four spaces in order to align the @n-attribute with other lines and yet have the lb-element begin without intervening whitespace at the end of the preceding line/word fragment. But when I edit the document in author mode, it removes the linebreak within the element, so that the first of the following is a very long line and the snippet is only two lines long: <lb_n="016_011"/>que_con_el_pre<lb_break="no"_rendition="#noHyphen"_n="016_012"/>sidente_o_juez_que_reside_en_la_prouincia:_puede <lb n="016_013"/>hazer thesoreros y receptores en su prouincia: (Whitespace and indenting preferences are mentioned below.) Now our workflow relies on an external file providing links to certain places in the TEI file: <a href="W0004.xml#line=449;column=1">016_013</a> Therefore it is somewhat annoying that editing the TEI leads to ("hard") lines being drawn together and the external file increasingly pointing to wrong places. I understand that author mode parses the XML into a DOM tree and re-serializes it on save, so I don't know if this behaviour can be changed at all. But then what would you suggest how we should be approaching this problem? (Can we point to the relevant place based on the @n-attribute of the lb element? If we had to provide all the lbs with @xml:ids I think it would thwart our attempts to make the xml sources better readable. And all of this would help us with linking the two files, but the xml file would still end up with bad readability.) Thank you for any idea, Andreas P.S. I have selected the "Preserve empty lines", "Preserve text as it is" and "Preserve line breaks in attributes" in Options | Preferences | Editor/Format/XML and added "*" to the "Preserve Space" Elements. I also think I have deactivated pretty printing everywhere I could. In Editor | Edit Modes | Author | Format and indent, I have chosen "only the modified content". -- Dr. Andreas Wagner Project "The School of Salamanca" Academy of Sciences and Literature, Mainz and Institute of Philosophy Goethe University Frankfurt http://salamanca.adwmainz.de IGF HP 25 / R 2.455 Norbert-Wollheim-Platz 1 60629 Frankfurt am Main Tel. +49 (0)69/798-32774 Fax +49 (0)69/798-32794

2 1

copying tables from other sources
by Cwiklowski, Don 15 Sep '15

15 Sep '15

Whenever I copy a table from Word or Excel, or even HTML to a DITA reference topic all of the elements come across as <properties> (etc), but if I drop it into a Concept, Oxygen translates a table into the proper DITA elements. Does anyone know how to fix this since the majority of our Reference topics contain tables? Don Cwiklowski, Jr. Sr. Technical Communicator Customer Technical Communications | Operations and Technology MasterCard 2200 MasterCard Blvd | O'Fallon, MO 63366 tel 636-722-6802 don_cwiklowski(a)mastercard.com<mailto:don_cwiklowski@mastercard.com> [cid:image001.gif@01D0EF87.2A1DBDC0]<www.mastercard.com> Please think of the environment before printing this email. CONFIDENTIALITY NOTICE This e-mail message and any attachments are only for the use of the intended recipient and may contain information that is privileged, confidential or exempt from disclosure under applicable law. If you are not the intended recipient, any disclosure, distribution or other use of this e-mail message or attachments is prohibited. If you have received this e-mail message in error, please delete and notify the sender immediately. Thank you.

2 1

[oXygen XML Editor Blog] - A Short Story of Reuse
by oXygen XML Editor Blog 14 Sep '15

14 Sep '15

oXygen XML Editor Blog /////////////////////////////////////////// A Short Story of Reuse Posted: 07 Sep 2015 02:38 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/-bqdMBmNY0Q/a-short-… Give the smartest human in the world a piece of wood and ask him/her to make paper. Give him/her no prior tools and it will take years to come up with a decent process which would result in some brown almost usable thick piece of paper. This blog post is about reuse, not necessarily reuse of tools and materials, but reuse of knowledge. Humanity has evolved not because each generation is smarter than the last one but because we learned to reuse and pass knowledge to larger and larger audiences and from one generation to another. Almost all tools that we use today are made up of quite a complex set of components which interact with each other. There is no one person in a car assembly factory who still knows all the pieces and how they come together. Although using the tool is easier than interacting with all components which make it up, you still need knowledge to operate it and in this day and age having enough people to teach how a certain tool can be used is no longer an option. You need to pass knowledge in other forms, on paper or in some kind of digital form. So I would define technical communication as a means of passing knowledge about using tools to a larger audience. Reuse in technical communication can be structured on many levels: Reuse written content by publishing it to more than one format (PDF, HTML, EPUB, MS Word). It turns out that XML is perfect for publishing content in more than one format. XML is not designed to be consumed directly by end users and its benefit lies directly in this. Your XML content should contain all the data necessary for obtaining all the output formats. So if you are using XML in your technical content, no matter what standard or custom vocabulary, you can safely check the first and most important level of reuse. Create larger publications from existing ones. Either using an XML standard like XInclude or using standards with their own diverse and powerful methods of reuse like DITA, or by performing custom techniques you can merge XML content in larger publications. Reuse content written for a certain tool to document the functionality and behavior of a very similar tool. In most mature XML standards like DITA and Docbook there is this implemented concept of profiling which allows you to dynamically filter at publishing time content marked with certain attributes from your original XML project. In this way from the same XML content you can publish documentation for multiple similar tools. Reuse smaller pieces of common content in more than one publication. Again, using XML standards like XInclude or DITA specific standards like content references you can create and maintain small libraries of reusable XML content, then reuse these components across various publications. Reuse images and other binary resources in multiple publications. Because XML content does not embed binary resources, these resources are stored separately and thus they can be reused in multiple places. So these are what I consider to be the main selling points for using XML in technical documentation. As usual any feedback is welcomed. -- 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

3 2

About oXygen XML Editor
by oXygen XML Editor Blog 03 Sep '15

03 Sep '15

oXygen XML Editor Blog /////////////////////////////////////////// DITA 1.3 Branch Filtering - Next Generation of Reuse Posted: 02 Sep 2015 05:51 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/tZnLUSz5jiU/dita-13-… Thanks to the hard working OASIS DITA TC Group the DITA 1.3 standard is quite close to being released. Oxygen 17.1 which will be released probably in September this year will have experimental DITA 1.3 support. This will include publishing using a custom build of the latest DITA Open Toolkit 2.x engine in which the main developer Jarno Elovirta has already added incipient support for key scopes and branch filtering. In this blog post I'm going to give you a small example of how branch filtering can benefit two cases of reuse which could not be done previously. You can read more about branch filtering in the DITA 1.3 specs. Case 1 - Combine Two Profiles in the Same Publication Let's say you have a DITA Project about preparing and cooking vegetables. And your DITA Map looks like this:<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map> <title>Cooking vegetables</title> <topicref href="cleaningTableArea.dita" audience="novice"/> <topicref href="preparingVegetables.dita"/> <topicref href="addingExtraFlavor.dita" audience="expert"/> </map> You have some content common both for expert and novice users but you also have content which is specific for a target audience. You do not need to teach expert chefs how to clean the table and you do not want to teach novice cooks about enhanced flavoring techniques. All is fine until at some point you decide to produce a publication which contains merged inside both the novice and the expert map contents. And here's where branch filtering comes for help. You can create a main DITA Map which reuses your current DITA Map with two profiling contexts:<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map> <title>Cooking Vegetables.</title> <topichead navtitle="Cooking for Beginners" keyscope="novice"> <topicref href="vegetables.ditamap" format="ditamap"> <ditavalref href="novice.ditaval"/> </topicref> </topichead> <topichead navtitle="Cooking for Experts" keyscope="expert"> <topicref href="vegetables.ditamap" format="ditamap"> <ditavalref href="expert.ditaval"/> </topicref> </topichead> </map> Case 2 - Reusing Common Topics with Different Product NamesLet's say you have a simple DITA task in which you have described how a certain task can be performed for a certain product. In our case, the task describes peeling potatoes: The task works and at some point in your Vegetables Soup publication you realise you need to write a similar task about peeling cucumbers. The task is exactly the same, except the product name. So naturally you want to reuse the existing written task. For this we re-write the task so that instead of of the product potatoes it contains two consecutive profiled product names:Peeling <ph product="potatoes">potatoes</ph><ph product="cucumbers">cucumbers</ph>and include the task in the main DITA Map in two places with different ditaval filters applied:<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map> <title>Peeling Vegetables.</title> <topichead navtitle="Potatoes"> <topicref href="peeling.dita"> <ditavalref href="potatoes.ditaval"/> </topicref> </topichead> <topichead navtitle="Cucumbers"> <topicref href="peeling.dita"> <ditavalref href="cucumbers.ditaval"/> </topicref> </topichead> </map> This kind of usage will produce in the HTML output folder two topic HTML files from the single peeling.dita, one for each filter context. The DITA samples for this post can be downloaded from http://www.oxygenxml.com/forum/files/branchFilteringBlogSamples.zip. As usual any feedback is welcomed. If you would like to beta test Oxygen XML Editor 17.1 with experimental DITA 1.3 support please contact us: support(a)oxygenxml.com. -- 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

Odd webhelp with feedback error message
by Jim Henderson 01 Sep '15

01 Sep '15

I'm receiving the following e-mail from a testing server that I'm using feedback on: [73.53.13.170] - 2015-08-26 10:27:46: Unknown error type: [8] Undefined property: RecordSet::$m_CurrentRow on line 200 in file /var/www/html/PingID-API/oxygen-webhelp/resources/php/classes/db/RecordSet.php , PHP 5.4.16 (Linux) This happens when I submit a comment in the comment system. Doesn't seem to matter if I'm authenticated or not. I've tried this on CentOS 7.0 and SUSE Linux Enterprise 11 SP3, and both of them are generating this message for some reason. The output was generated with Oxygen 17. I've got other webhelp with feedback that works OK (in fact, I can use the same output set on another server and it works just fine). I've got mysql installed and the php mysql extension is present as well. I've set up the database fine, and I can see the comments in the UI, but the e-mails being sent only contain this error. I'm not even sure where to start to troubleshoot this - anyone have any ideas? Thanks, Jim -- [image: Ping Identity logo] <https://www.pingidentity.com/> Jim Henderson Technical Writer @ jhenderson(a)pingidentity.com [image: phone] +1 720.390.3443 Connect with us… [image: twitter logo] <https://twitter.com/pingidentity> [image: youtube logo] <https://www.youtube.com/user/PingIdentityTV> [image: LinkedIn logo] <https://www.linkedin.com/company/21870> [image: Facebook logo] <https://www.facebook.com/pingidentitypage> [image: Google+ logo] <https://plus.google.com/u/0/114266977739397708540> [image: slideshare logo] <http://www.slideshare.net/PingIdentity> [image: flipboard logo] <http://flip.it/vjBF7> [image: rss feed icon] <https://www.pingidentity.com/blogs/>

2 3

About oXygen XML Editor
by About oXygen XML Editor 28 Aug '15

28 Aug '15

About oXygen XML Editor /////////////////////////////////////////// DITA 1.3 Implementation Status in upcoming Oxygen XML Editor 17.1 Posted: 26 Aug 2015 10:48 PM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/yUZ8D06g8Zo/dita-13-… We plan to release Oxygen 17.1 in about a month or two, probably at the beginning of October this year. Starting with version 17.1, Oxygen includes experimental support for editing and publishing using some of the DITA 1.3 features. If you want to test this support and give us feedback please contact us directly to obtain an Oxygen 17.1 beta kit. To enable DITA 1.3 editing support in Oxygen 17.1 and use the custom bundled DITA Open Toolkit 2.1 for publishing, open the Preferences dialog box, go to DITA, and select the Built-in DITA OT 2.x radio button. The following table is a list of DITA 1.3 features and their implementation status: DITA 1.3 Features Implementation Status Feature Editing Publishing [Latest DITA Open Toolkit 2.x is used.] DITA 1.3 DTD, XML Schema, and Relax NG-based maps/topics/tasks/references, etc. New DITA 1.3 file templates. Also by default DITA topics and maps which do not specify version in the DOCTYPE declaration are also considered to be DITA 1.3. Specific annotations presented in the content completion window and documentation tooltips for all new DITA 1.3 elements. See below Learning Object and Group maps New file templates No specific support implemented Troubleshooting specialization Create and edit new troubleshooting topics No specific support implemented XML markup domain Validation and Content Completion Special rendering in PDF and XHTML-based outputs. Equation and MathML domain Validation and content completion Display and Insert equations Special rendering in PDF and XHTML-based outputs. SVG domain Validation and content completion Display referenced SVG content Special rendering in PDF and XHTML-based outputs. Other new DITA 1.3 elements (div, strike-through, overline, etc) Validation and Content Completion. Special rendering in PDF and XHTML-based outputs. Release management domain Validation and Content Completion No specific support implemented. Scoped keys Define key scopes Validate and check for completeness Resolve keyrefs and conkeyrefs taking key scopes into account. Partially implemented. Various issues may still be encountered. Branch filtering Display, create and edit ditavalref elements. Partially implemented. Various issues may still be encountered. Shorthand to address syntax that identifies elements in the same topic Properly resolved for validation, links, and conrefs. Implemented. Various table attributes (orientation, rotation, scope, and headers on cells) Not implemented in the Table Properties action support. But attributes can be changed from the Attributes view. Not implemented. New Map topicref attributes (cascade, deliveryTarget) Allow setting new attributes, propose proper values for them. Implemented. -- You are subscribed to email updates from "About oXygen XML Editor." 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

bug report: repeated schema-declared element content
by Syd Bauman 26 Aug '15

26 Aug '15

Assignment: write a RELAX NG schema for Keats _On first looking into Chapman's Homer_. I (deliberately) wrote a ridiculously literalist schema, attached. When I create a new XML document that uses this schema, oXygen properly inserts the required elements, including all 14 required <pLine> elements. When I ask for auto-completion (CTL-space) of the <head> or any of the @n, oXygen does the right thing and gives me the one and only correct choice as the only possible value in the pop-up. But when I ask for auto-completion of <pLine>s 2 through 14, the one and only possible value in the pop-up is the content for the first <pLine>! Worth noting that jing gets it right. After filling in the content using auto-completion, validation will say of <pLine> 2, e.g., character content of element "pLine" invalid; must be equal to "And many goodly states and kingdoms seen;" Details: <oXygen/> XML Developer 17.0, build 2015052917 Mac OS X 10.6.8 error occurs using XML syntax or compact syntax Also tested on: <oXygen/> XML Developer 17.0, build 2015051321 Ubuntu 12.04 only tested compact syntax start = element poem { element head { "On first looking into Chapman's Homer" }, element sonnet { element pLine { attribute num { "01" }, "Much have I travell'd in the realms of gold," }, element pLine { attribute num { "02" }, "And many goodly states and kingdoms seen;" }, element pLine { attribute num { "03" }, "Round many western islands have I been" }, element pLine { attribute num { "04" }, "Which bards in fealty to Apollo hold." }, element pLine { attribute num { "05" }, "Oft of one wide expanse had I been told" }, element pLine { attribute num { "06" }, "That deep-brow'd Homer rules as his demesne;" }, element pLine { attribute num { "07" }, "Yet did I never breathe its pure serene" }, element pLine { attribute num { "08" }, "Till I heard Chapman speak out loud and bold:" }, element pLine { attribute num { "09" }, "Then felt I like some watcher of the skies" }, element pLine { attribute num { "10" }, "When a new planet swims into his ken;" }, element pLine { attribute num { "11" }, "Or like stout Cortez when with eagle eyes" }, element pLine { attribute num { "12" }, "He star'd at the Pacific — and all his men" }, element pLine { attribute num { "13" }, "Look'd at each other with a wild surmise —" }, element pLine { attribute num { "14" }, "Silent, upon a peak in Darien." } } } -- Syd Bauman, EMT-Paramedic Senior XML Programmer/Analyst Northeastern University Women Writers Project s.bauman(a)neu.edu or Syd_Bauman(a)alumni.Brown.edu

4 5

About oXygen XML Editor
by About oXygen XML Editor 25 Aug '15

25 Aug '15

About oXygen XML Editor /////////////////////////////////////////// DITA 1.3 Key Scopes - Next Generation of Reuse Posted: 24 Aug 2015 03:34 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/eupu2DkD4is/dita-13-… Thanks to the hard working OASIS DITA TC Group the DITA 1.3 standard is quite close to being released. Oxygen 17.1 which will be released probably in September this year will have experimental DITA 1.3 support. This will include publishing using a custom build of the latest DITA Open Toolkit 2.x engine in which the main developer Jarno Elovirta has already added incipient support for key scopes and branch filtering. In this blog post I'm going to give you a small example of how key scopes can benefit simple cases of reuse which could not be done previously. Let's say you have a simple DITA task in which you have described how a certain task can be performed for a certain product. In our case, the task describes peeling a potato: The task works and at some point in your Vegetables Soup publication you realise you need to write a similar task about peeling cucumbers. The task is exactly the same, except the product name. So naturally you want to reuse the existing written task. For this we re-write the task so that instead of of the product potatoes it contains a key reference:<ph keyref="vegetable"/> Next we need to define in our DITA Map the vegetable key and bind it to a specific value in the potatoes context: <topicref href="potatoes_overview.dita" keyscope="potatoes">  <keydef keys="vegetable"> <topicmeta> <keywords> <keyword>potatoes</keyword> </keywords> </topicmeta> </keydef>  <topicref href="peeling.dita"/> </topicref>and add in our DITA Map another key scope with the overview and the task which deal with cucumbers peeling: <topicref href="cucumbers_overview.dita" keyscope="cucumbers">  <keydef keys="vegetable"> <topicmeta> <keywords> <keyword>cucumbers</keyword> </keywords> </topicmeta> </keydef>  <topicref href="peeling.dita"/> </topicref> As you may have noticed, we have not used the key scope names for anything. Just by defining the key scopes, we made the product name to be expanded differently in both contexts. But our Vegetables Soup publication may also contain a topic which lists all possible vegetables. This topic is defined in a context outside any key scope:<topicref href="vegetables_over.dita"/>and this overview topic can refer to each product name using the full keyscope key reference value:<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> <topic id="vegetables_over"> <title>Vegetables Overview</title> <body> <p>This is an overview of all vegetables necessary to make soup. You will learn how to use vegetables like <ph keyref="potatoes.vegetable"/> and <ph keyref="cucumbers.vegetable"/> to make a great starter soup.</p> </body> </topic> As stated before, this kind of reuse was not possible using the standard DITA 1.2 standard constructs. As it turns out, with DITA 1.3 we can also implement this kind of reuse using branch filtering. The DITA samples for this post can be downloaded from http://www.oxygenxml.com/forum/files/keyscopesBlogSamples.zip. As usual any feedback is welcomed. If you would like to beta test Oxygen XML Editor 17.1 with experimental DITA 1.3 support please contact us to support(a)oxygenxml.com. -- You are subscribed to email updates from "About oXygen XML Editor." 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

Mac OSX, single instance of diffFiles?
by Steven Anderson 21 Aug '15

21 Aug '15

I've got a Mac and I'd like to have a single instance of diffFiles running. I tried to add -Dcom.oxygenxml.MultipleInstances=false\ to the shell script invocation, but that didn't seem to help. Is there a way to specify this? -- Steve

2 2

Schematron for Multi-Lingual Schemas?
by Tony Graham 21 Aug '15

21 Aug '15

I'm looking at localising the Schematron messages in 'focheck' (https://github.com/AntennaHouse/focheck) The non-normative advice in Annex G, "Use of Schematron for Multi-Lingual Schemas", in the Schematron spec is to use multiple <diagnostic>, one for each translation of the text from an <assert> or <report>. oXygen, unsurprisingly, shows every applicable <diagnostic>. This gets a bit cluttered and, for some user, puts the readable version of the message right at the very end. Is there a way to put multiple, localised versions of a message in a Schematron file and have only the preferred one show? Is there an alternative to making multiple single-language versions of the Schematron? And, while I'm at it, what can be done about l10n of the annotations in Relax NG schema that become tool-tips in oXygen? Regards, Tony Graham. -- Senior Architect XML Division Antenna House, Inc. ---- Skerries, Ireland tgraham(a)antenna.co.jp

3 5

About oXygen XML Editor
by About oXygen XML Editor 13 Aug '15

13 Aug '15

About oXygen XML Editor /////////////////////////////////////////// Document Type Extension Sharing Posted: 12 Aug 2015 04:41 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/CruPt7osXjg/document… You can extend a default bundled document type (like DITA or Docbook) in the Document Type Association preferences page, make modifications and then share the extension with your team. The steps below describe how an extension of the DITA framework which removes certain elements from the content completion list can be constructed and shared: Create somewhere on your disk, in a place where you have full write access a folder structure like: custom_frameworks/dita-extension. In the Document Type Association / Locations preferences page add in your Additional frameworks directories list the path to your custom_frameworks folder. In the Document Type Association preferences page select the DITA document type configuration and use the Extend button to create an extension for it. Give a custom name to the extension, for example DITA - Custom and then change its Storage to external, then save it to a path like: path/to/.../custom_frameworks/dita-extension/dita-extension.framework. Make changes to the extension, for example go to the Author->Content completion tab and add in the Filter - Remove content completion items list elements which should not be presented to the end users. Click OK to close the dialog and then either OK or Apply to save the preferences changes. After you perform the steps above you will have in the dita-extension folder a fully functioning framework which can be shared with others. The framework can then be shared with others in several ways: Copy it to their [OXYGEN_DIR]/frameworks directory. Create somewhere on disk a custom_frameworks folder, copy the framework there and then from the Document Type Association / Locations preferences page add in your Additional frameworks directories list the path to the custom_frameworks folder. Distribute the framework along with a project. Follow these steps: On your local drive, create a directory with full write access, containing the project files and a custom_frameworks folder containing your dita-extension. Start the application, go to the Project view and create a project. Save it in the newly created directory. In the Document Type Association / Locations preferences page, select Project Options at the bottom of the page. Add in the additional framework directories list an entry like ${pd}/custom_frameworks. Add other resources to your project, for example you can have all your DITA content located inside the project folder. You can then share the new project directory with other users. For example you can commit it to your version control system and have they update their working copy. When they open the customized project file in the Project view, the new document type becomes available in the list of Document Types. Deploy the framework/document type configuration as an add-on. After your team members install the framework they can check in Document Type Association preferences page in the list of Document Types to see if the framework is present and if it appears before the bundled DITA framework (meaning that it has higher priority). -- You are subscribed to email updates from "About oXygen XML Editor." 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

Schematron template?
by David Birnbaum 07 Aug '15

07 Aug '15

Dear <oXygen/> users, The template loaded when I create a new Schematron seems to have changed in version 17 not only with the addition of Schematron Quick Fix capabilities, but also by replacing the default namespace declaration: xmlns="http://purl.oclc.org/dsdl/schematron" with a namespace prefix definition: xmlns:sch="http://purl.oclc.org/dsdl/schematron" so that the Schematron document is now, by default, in no namespace. This isn't a problem (I can live with it or change it, as I prefer), but it makes me wonder why the default behavior was changed. Are there advantages to defaulting to no namespace, instead of to the Schematron namespace? Thanks, David

4 3

draft-comment without @author?
by Yves Barbion 27 Jul '15

27 Jul '15

Hi group When I insert a draft-comment in a DITA topic, I see that the name of the author of the draft-comment is filled in automatically, which is nice. But is there also an easy way (a setting in the preferences maybe) to insert a draft-comment without the author's name? Thanks -- Yves Barbion www.scripto.nu

2 2

adding namespace prefix to autocomplete list
by Erik Zander 23 Jul '15

23 Jul '15

Hi, I have been searching for some information (but not found) on how I can add my own prefixes to XSLT editor like the one for xmlns:saxon="http://saxon.sf.net/" where you get the autocomplete alternative xmlns:saxon. This when activating autocomplete in the xsl:stylesheet element attribute list. Looking forward to any help. Regards Erik

2 2

[Ann] New maintenance build available for oXygen 17.0 (2015071312)
by oXygen XML Editor Support (Ionela Istodor) 20 Jul '15

20 Jul '15

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

1 0

About oXygen XML Editor
by About oXygen XML Editor 18 Jul '15

18 Jul '15

About oXygen XML Editor /////////////////////////////////////////// Controlled Attribute Values (Part 2 - Advanced) Posted: 17 Jul 2015 03:42 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/NE2VjDi24KA/controll… As already presented in Controlled Attribute Values for your DITA Project, Oxygen allows you to add or replace possible values for attributes or elements based on a simple configuration file. A more complex scenario is one in which in order to decide which values to provide, you need more context information. Let's take this DITA fragment: <metadata> <othermeta name="name" content="value"/> </metadata> What we want is to offer proposals for @content but the possible values for @content depend on the value of @name. We will see how we can solve this dependency. The configuration file The configuration file (cc_value_config.xml) allows calling an XSLT stylesheet and that's just what we will do:<match elementName="othermeta" attributeName="content"> <xslt href="meta.xsl" useCache="false"/> </match> As you can see, we can't express the dependency between @content and @name inside the configuration file . I also want to mention that because the values for @content are dynamic, we want the XSLT script to execute every time the values are requested (we shouldn't cache the results). We enforce this by setting @useCache to false. The XSLT script The XSLT script has access to the XML document (through the documentSystemID parameter) but it lacks any context information, we can't really tell for which othermeta element was the script invoked. To counter this limitation, we will use Java extension functions and we will call Oxygen's Java-based API from the XSLT. Here how it looks:<?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xd="http://www.oxygenxml.com/ns/doc/xsl" xmlns:tei="http://www.oxygenxml.com/ns/doc/xsl" xmlns:prov="java:ro.sync.exml.workspace.api.PluginWorkspaceProvider" xmlns:work="java:ro.sync.exml.workspace.api.PluginWorkspace" xmlns:editorAccess="java:ro.sync.exml.workspace.api.editor.WSEditor" xmlns:saxon="http://saxon.sf.net/" xmlns:textpage="java:ro.sync.exml.workspace.api.editor.page.text.xml.WSXMLTextEditorPage" xmlns:authorPage="java:ro.sync.exml.workspace.api.editor.page.author.WSAuthorEditorPage" xmlns:ctrl="java:ro.sync.ecss.extensions.api.AuthorDocumentController" exclude-result-prefixes="xs xd" version="2.0"> <xsl:param name="documentSystemID" as="xs:string"></xsl:param> <xsl:template name="start"> <xsl:variable name="workspace" select="prov:getPluginWorkspace()"/> <xsl:variable name="editorAccess" select="work:getEditorAccess($workspace, xs:anyURI($documentSystemID), 0)"/> <xsl:variable name="pageID" as="xs:string" select="editorAccess:getCurrentPageID($editorAccess)"/> <xsl:variable name="name" as="xs:string"> <xsl:choose> <xsl:when test="$pageID='Text'"> <xsl:variable name="textpage" select="editorAccess:getCurrentPage($editorAccess)"/>  <xsl:value-of select="textpage:evaluateXPath($textpage, 'xs:string(./parent::node()/@name)')"/> </xsl:when> <xsl:when test="$pageID='Author'"> <xsl:variable name="authorPage" select="editorAccess:getCurrentPage($editorAccess)"/> <xsl:variable name="caretOffset" select="authorPage:getCaretOffset($authorPage)"/> <xsl:variable name="ctrl" select="authorPage:getDocumentController($authorPage)"/> <xsl:variable name="contextNode" select="ctrl:getNodeAtOffset($ctrl, $caretOffset)"/>  <xsl:value-of select="ctrl:evaluateXPath($ctrl, 'xs:string(@name)', $contextNode, false(), false(), false(), false())[1]"/> </xsl:when> </xsl:choose> </xsl:variable> <items> <xsl:choose> <xsl:when test="$name = 'temperatureScale'"> <item value="Celsius" annotation="(symbol C)"/> <item value="Fahrenheit" annotation="(symbol F)"/> </xsl:when> <xsl:when test="$name = 'measurement'"> <item value="Metric" annotation="Metric system"/> <item value="Imperial" annotation="Also known as British Imperial"/> </xsl:when> </xsl:choose> </items> </xsl:template> </xsl:stylesheet> It is also worth mentioning that in the next Oxygen version (17.1) we will provide a more elegant solution to this situation. The XSLT script will receive a new parameter, an XPath expression that will identify the element for which content completion was invoked. But maybe we will talk about that in a future post... -- You are subscribed to email updates from "About oXygen XML Editor." 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

About oXygen XML Editor
by About oXygen XML Editor 16 Jul '15

16 Jul '15

About oXygen XML Editor /////////////////////////////////////////// Controlled Attribute Values for your DITA Project Posted: 15 Jul 2015 03:31 AM PDT http://feedproxy.google.com/~r/AboutOxygenXmlEditor/~3/AGTBTAnCxA0/controll… Frequently when editing DITA content you will feel the need to enforce a controlled set of values when editing certain attributes. For example you may want to impose that the values for the @outputclass attribute on the element codeblock are either language-xml or language-css. This is useful in order to remind writers that any other value will not be interpreted by the build process in a significant manner. Oxygen has a couple of easy ways in which controlled values can be imposed for certain attributes: You can edit the XML configuration file OXYGEN_INSTALL_DIR/frameworks/dita/resources/cc_value_config.xml and provide additional entries. In the case of our small example for providing controlled values for the @attribute the configuration file should contain an additional entry:<match elementName="codeblock" attributeName="outputclass"> <items action="addIfEmpty"> <item value="language-xml" annotation="XML Syntax Highlight"/> <item value="language-css" annotation="CSS Syntax Highlight"/> </items> </match>Besides providing a hard-coded list of values the content completion configuration file is flexible enough to allow calling an XSLT stylesheet which could retrieve those values from other sources (for example via HTTP from an Exist database). Provide those controlled values via a Subject Scheme Map (my favorite). Coming back to our example, you can create a small Subject Scheme map with the file name controlledValues.ditamap and the content:<!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN""map.dtd"> <subjectScheme> <subjectHead> <subjectHeadMeta> <navtitle>Provide controlled attributes</navtitle> </subjectHeadMeta> </subjectHead> <hasInstance> <subjectdef keys="languageTypeKey"> <subjectdef keys="language-xml"> <topicmeta> <navtitle>XML Syntax Highlight</navtitle> </topicmeta> </subjectdef> <subjectdef keys="language-css"> <topicmeta> <navtitle>CSS Syntax Highlight</navtitle> </topicmeta> </subjectdef> </subjectdef> </hasInstance> <enumerationdef> <elementdef name="codeblock"/> <attributedef name="outputclass"/> <subjectdef keyref="languageTypeKey"/> </enumerationdef> </subjectScheme>then you can refer to it from your main DITA Map like:<topicref href="controlledValues.ditamap" format="ditamap" type="subjectScheme"/> If the attributes on which you want to impose certain values are DITA profiling attributes, you can go to the Oxygen Preferences->Editor / Edit modes / Author / Profiling/Conditional Text page and define the set of allowed values for them. The only problem with the first approach is the fact that validation will not impose those values and writers will not receive validation error messages if they set another value for the specific attribute. So you will probably need to add a Schematron check in order to signal errors when a certain attribute's value does not match the list of controlled attribute values. For both the second and third approaches, validation will warn the writers if certain attribute values do not match values in the controller values list. -- You are subscribed to email updates from "About oXygen XML Editor." 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

Possible standalone WebDAV client with oXygen?
by David Sewell 13 Jul '15

13 Jul '15

I and a couple of other people in my department often need to read and write files via WebDAV connections (specifically, to MarkLogic's WebDAV server interface to its database). We all use OS X as our platform, and we have often found that the built-in WebDAV mounting support in OS X Finder is unreliable. We have used an alternative standalone client (Transmission), but lately it has had some performance problems as well. The internal WebDAV client within oXygen has always been solidly reliable. Is there any chance that it could be bundled or sold separately as a standalone WebDAV client? Would other oXygen users find that useful? (Or does anyone have suggestions about other OS X WebDAV clients to try?) David -- David Sewell, Editorial and Technical Manager ROTUNDA, The University of Virginia Press PO Box 400318, Charlottesville, VA 22904-4314 USA Email: dsewell(a)virginia.edu Tel: +1 434 924 9973 Web: http://rotunda.upress.virginia.edu/

3 2

Problems with copy and paste from Firfox
by Sascha Manns 10 Jul '15

10 Jul '15

Hello List, actually i'm writing with XML-Editor a document. Sometimes i'm using copy and paste from Firefox to XML-Editor in Author-Mode. The problem is, after STRG+V the text is inserted on the wished place, but the umlauts are broken. So the german word "Beträge" looks like "Betrýge". I've seen in the sourcecode of the website UTF-8 is set as charset. Inside the XML Editors settings i have set: Fallback Charset: UTF-8. Also my docbook file begins with: <?xml version="1.0" encoding="utf-8"?>. So i don't understand why this broken char happens. Maybe anyone knows more? Greetings Sascha -- Yours sincerly Sascha Manns *** XCOM AG Legal Disclaimer *** Diese E-Mail einschliesslich ihrer Anhaenge ist vertraulich und ist allein für den Gebrauch durch den vorgesehenen Empfaenger bestimmt. Dritten ist das Lesen, Verteilen oder Weiterleiten dieser E-Mail untersagt. Wir bitten, eine fehlgeleitete E-Mail unverzueglich vollstaendig zu loeschen und uns eine Nachricht zukommen zu lassen. This email may contain material that is confidential and for the sole use of the intended recipient. Any review, distribution by others or forwarding without express permission is strictly prohibited. If you are not the intended recipient, please contact the sender and delete all copies. Hauptsitz: Allee 8, D-47877 Willich, USt-IdNr.: DE 812 885 664 Kommunikation: Telefon +49 2154 9209-70, Telefax +49 2154 9209-900, www.xcom.de Handelsregister: Amtsgericht Krefeld, HRB 10340 Vorstand: Dirk Franzmeyer, Marco Marty, Dirk Werner, Sascha Bochartz Vorsitzender des Aufsichtsrates: Stefan H. Tarach

2 1

Defect in SVG viewer
by Timothy Reaves 30 Jun '15

30 Jun '15

I created an SVG document with - I believe - a version of oXygen in the 15.x series, about two years ago. I just opened it in oXygen to edit it, and it no longer renders correctly in oXygen. In the Mac Finder, Safari, and Firefox, it still does render correctly. Are there any known defects? If not, whom should I send the SVG to to create a defect report? Thanks.

2 1