May 2012 - oXygen-user - www.oxygenxml.com

[ann] [beta] oXygen XML Editor version 14 beta is available for testing
by George Cristian Bina 29 May '12

29 May '12

Dear oXygen users, We are happy to announce that version 14 of oXygen XML Editor is almost ready for release. Because the new version introduces many new features, we decided to release this beta version and thus have the chance to receive your early feedback before the final release. Some of these new features will be presented at the oXygen Users Meetup in Paris, June 11: http://www.oxygenxml.com/oXygen-user-meetup-Paris2012.html Please see below for: * oXygen 14 beta download information * a license key for testing * a summary of the most important additions/new features in version 14 = Download = You can download version 14 beta for your platform from http://www.oxygenxml.com/download-beta.html Please install this side by side with your current oXygen installation. = License key = License key for version 14 beta ------START-LICENSE-KEY------ Registration_Name=oxygen 14 beta user Company= Category=Enterprise Component=XML-Editor, XSLT-Debugger, Saxon-SA Version=14 Number_of_Licenses=1 Date=05-17-2012 Trial=31 SGN=MCwCFAkZnxOqlYndXSHLSIhrGOC0I2/+AhQ0tEWVN8L4ToTKODltVOhFh7BvPg\=\= -------END-LICENSE-KEY------- = Main additions/new features in version 14 = *General* *Support for plugin and framework repositories* *Updates on Transformation and Validation scenarios* *EPUB 3.0* *Development* *Master files* *XSLT Unit Test* *XSLT 3.0* *Improved support for MarkLogic* *CTRL/CMD + click navigation* *In-place rename* *XPath/XQuery builder* *Authoring* *Change tracking and comment callouts* *Improved table editing* *New feedback-enabled WebHelp output for DITA* *Discontinuous selection* *XPath filter for Find/Replace in Author mode* *Author mode used for selecting DITA conref target elements* *Others* *Find and replace improvements* *Search results highlighted in editors* *Improved JavaScript support* *Updated Saxon-EE to its latest version* = General = *Plugin and framework repositories* As a developer you will be able to distribute your plugins and frameworks to users by placing them in a repository and publish that on your website. When you update your plugins or frameworks the users will be notified that a new version is available and they will have the option to update automatically to that new version. As a user, you can easily install new plugins and frameworks by just pointing oXygen with a URL to a repository. You will be able to browse available plugins and frameworks and select the ones you want to install. *Updates on Transformation and Validation scenarios* - Added the possibility to associate and execute multiple scenarios - Redesigned the transformation scenarios view and transformation and validation scenarios dialogs - Improved the management of the global, project and document type scenarios - Import and export operations *EPUB 3.0* The EPUB support was updated to include validation for EPUB 3.0 files. = Development = *Master files* In version 14 oXygen introduces a new innovative concept called "Master files" which simplifies the configuration and development of XML projects. The Master Files are defined at project level and are automatically used by oXygen to determine the context for operations such as validation, content-completion, refactoring or search for XSD, XSL and RNG modules. A "Master" file generally means the root of an import/include tree of modules. * Benefits: - When a module is validated oXygen will automatically identify the master files which include that module and it validates all of them, thus the module will be validated in the context it is used from. You will see from this how a change in that module affects your whole project. - When you edit a module the Outline view and the content completion will present all the components collected starting from the Master files which include that module, thus you get to see all the referable components even if they are defined in the main file or in other modules. - Search and refactoring actions, like search references or rename components operate by default on the scope defined by the Master Files * How to define the Master Files: - Drop files in the "Master Files" logical folder in the project - Use the "Add to Master Files" contextual menu action on a file that you want to mark as Master file - Use the "Add Files" contextual menu action available on the "Master File" logical folder * Best practices defining Master Files: - Add only the top level files, the ones which are the roots of the include/import graph - Keep the file set to a minimum. Do not add standalone files (the ones which do not import or include other files). Adding too many files may affect performance *XSLT Unit Test* oXygen 14 comes with XSpec to provide XSLT Unit Test support. You can easily create a test for an XSLT stylesheet by triggering the New -> XSLT Unit Test action from the contextual menu of the Project View when the selection is an XSLT stylesheet that you want to test. This will automatically generate an XSpec stub with the templates and functions from that stylesheet that you want to test. The editing of the XSpec is then assisted with content completion and a default transformation scenario is set on XSpec files which run the tests, generating as output the test report, so all you need to do to run your tests is to click on the "Apply transformation" button. *XSLT 3.0* If an XSLT stylesheet has the version attribute set to 3.0 then the XSLT 3.0 support will be enabled automatically providing - content completion for XSLT 3.0 - transformations and XSLT validation - updated Outline view and the search and refactoring actions to handle 3.0 additions *Improved support for MarkLogic* The support for developing XML and XQuery applications with MarkLogic was improved in many areas. - Remote debugging support - Remote editing - Improved XQuery validation *CTRL/CMD + click navigation* By pressing CTRL (CMD on Mac) in an XSL/XSD/RNG editor the components will become links where you can easily navigate to that component's definition by clicking on that link. *In-place rename* The rename action on components in the current file will perform an in-place rename. There is no additional dialog, the component is highlighted in the editor to mark that you are in rename mode and the rename is performed as you type. *XPath/XQuery builder* The XPath builder view was redesigned and it was extended to provide also XQuery support resulting in the new XPath/XQuery Builder. Some of the new additions are - history and favorites - evaluate as you type - expression error checking = Authoring = *Change tracking and comment callouts* The annotations/comments are presented in callouts next to the editing area, thus making it easy to collaborate on document editing and review. The callouts can be configured to present changes (insertions or deletions) as well as additional information e.g. the changed content or the date when that change or comment was created. *Improved table editing* Support for selecting columns and rows and moving them with drag and drop or cut/copy/paste actions. Delete on table selection removes only the values, the structure should be modified using the table specific actions, delete row, column, etc. *New feedback-enabled WebHelp output for DITA* By configuring a couple of parameters you can generate feedback-enabled webhelp. A sample feedback-enabled webhelp is available on our website: http://www.oxygenxml.com/doc/demo_webhelp/ *Discontinuous selection* It is possible to select multiple text ranges (discontinuous selection) or multiple elements in the Author page and cut/copy/paste them. *XPath filter for Find/Replace in Author mode* The XPath filter which was available only in Text mode is now available in the visual editing (Author) mode. *Author mode used for selecting conref target elements* The insertion of a DITA conref is easier as oXygen presents the target elements rendered through its Author mode, not the XML source, so you can preview the content you conref to as you create that conref. = Other = *Find and replace improvements* - Preview for "Replace all in Files" - Multi line support for "Find Replace in Files" *Search results highlighted in editors* The results of the XPath, Find, Search References/Declarations operations are highlighted in the editor and marked in the side bar, in both author and text mode. *Improved JavaScript support* Content Completion, Outliner and Validation for the JS script files. *Updated Saxon-EE to its latest version* oXygen is shipped with the latest Saxon Enterprise Edition, version 9.4.0.3. Best Regards, George -- George Cristian Bina <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com

6 6

XML DIff algorithms
by Peter West 28 May '12

28 May '12

I notice from the SDK that XML Diff uses an algorithm "based on Sasha and Zhang" for its XML_ACCURATE diff. Do you know of any implementations based on DocTreeDiff? http://www.techfak.uni-bielefeld.de/ags/pi/lehre/PatTreesWS11/change_contro… There is a lot of information out there on this topic; most of it seems to be from Springer; and none of that is freely available. See http://www.springerlink.com/content/720344g11375g004/ The ability to derive accurate deltas is essential for good version control of ODF and OOXML documents, of course. I'm looking at the Oxygen diff sdk for ways to provide diffs for mercurial or git. Peter West "Did not our hearts burn within us while he talked to us on the road...?"

3 2

[Ann] New maintenance build available for oXygen 13.2 (2012052412)
by Adrian Buza 28 May '12

28 May '12

Dear oXygen users, We announce the release of a new maintenance build (2012052412) for oXygen 13.2 (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#2012052412 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

Bug in the Ant schema
by Florent Georges 24 May '12

24 May '12

Hi, With oXygen 13.2, when opening an existing Ant build script (or when creating a new one from scratch), if in a target we have an 'ant' task with some property: <project basedir="." default="dist" name="prj"> <target name="dist"> <ant> <property name="n" value="v"/> </ant> </target> </project> then oXygen complains that: E [Xerces] The content of element type "ant" must match "EMPTY". Even though this is an important feature when using DITA-OT ;-) This might be a good idea to amend the schema? Regards, -- Florent Georges http://fgeorges.org/ http://h2oconsulting.be/

8 10

Catalogs are sometimes not working for resources referenced from RNC schema
by Jirka Kosek 24 May '12

24 May '12

Hi, I have just realized that references inside RELAX NG compact schema are not dereferenced using XML catalogs in some situations. How to reproduce problem: mydocbook.rnc: include "http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rnc" start |= db.qandaentry sample.xml <?xml-model href="mydocbook.rnc" type="application/relax-ng-compact-syntax"?> <qandaentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="cs"> ... </qandaentry> Content completition is not working now. The reason is that http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rnc is not loaded through catalog (there is local copy in oXygen) and as this file is not available at OASIS site at this moment, oXygen (or Jing) is silent but schema is probably not loaded as completition doesn't work. What's really strange is that validation works and schema is loaded, probably using XML catalog. Any clue how to make this work? It works with schemas in XML syntax. And also it works if I use schema from http://docbook.org/xml/5.0/rng/docbookxi.rnc but there is visible lag as schema is fetched over Internet not from local copy using catalog. Thanks in advance, Jirka -- ------------------------------------------------------------------ Jirka Kosek e-mail: jirka(a)kosek.cz http://xmlguru.cz ------------------------------------------------------------------ Professional XML consulting and training services DocBook customization, custom XSLT/XSL-FO document processing ------------------------------------------------------------------ OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member ------------------------------------------------------------------

2 3

parallel installation of different oxygen versions
by Jakob Fix 23 May '12

23 May '12

Hi, I’m really curious to check out the beta version 14, but I have one question: What is the preferred/best way to install two different versions of OxygenXML, is it enough to simply install it in a different directory? How about on a Mac? Will I keep my preferences (indentation for each document type), my database connections, etc.? Thanks, Jakob.

3 3

css count elements
by Roderik Dernison 23 May '12

23 May '12

Hi, I'm trying to count elements with css to place dashes between elements and to show indexes (like a,b,c). This works well in firefox and chrome, but oXygen shows an error: Dita: <options> <option judgement="* unacceptable"> <word>loopt</word> </option> <option> <word>ziet</word> </option> </options> Css: option:nth-child(n+2):before { content: "/"; } results in the error: System ID: D:\oxygen-13.2\frameworks\dita\css_classed\ling.css Severity: error Description: [CSS]:encountered "+". Was expecting one of: ")" Start location: 330:19 Where I expected: Jan loopt/ziet Can this be done in oXygen? Kind regards, Roderik Dernison ________________________________ ---------------------------------------------------------- Aan dit bericht kunnen geen rechten worden ontleend. Het bericht is alleen bestemd voor de geadresseerde. Indien het bericht niet voor u is bestemd, verzoeken wij u dit aan ons te melden en het bericht te verwijderen. This message shall not constitute any obligations. This message is intended solely for the addressee. If you have received this message in error, please inform us and delete the message. ----------------------------------------------------------

2 1

count elements part 2
by Roderik Dernison 23 May '12

23 May '12

Hi, As a follow-up of my previous question: is it possible to let css generate indexes for items? I.e. <examples> <example> <title>This is the first example</title> </example> <example> <title>This is the second example</title> </example> </examples> With something like: example:nth-child(n):before { content: n; } To show: 1. This is the first example 2. This is the second example Kind regards, Roderik Dernison ________________________________ ---------------------------------------------------------- Aan dit bericht kunnen geen rechten worden ontleend. Het bericht is alleen bestemd voor de geadresseerde. Indien het bericht niet voor u is bestemd, verzoeken wij u dit aan ons te melden en het bericht te verwijderen. This message shall not constitute any obligations. This message is intended solely for the addressee. If you have received this message in error, please inform us and delete the message. ----------------------------------------------------------

2 1

XSLT issue
by Reaves, Timothy 23 May '12

23 May '12

I have a stlyesheet I use to clean up SVG files. I have a transofrmation scenario created that uses Saxon 9EE (I have a license for Saxon as well). The transform runs in oXygen and produces the expected output. However, when I run Saxon from the command line, all I get in the output is the XML header. What would cause the command line execution to produce different results to the in-application transformation?

2 1

[Ann] New maintenance builds available for oXygen 13.2 (2012040515) and 11.2, 12.2 (Mac only)
by Adrian Buza 22 May '12

22 May '12

Dear oXygen users, We announce the release of a new maintenance build (2012040515) for oXygen 13.2 (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#2012040515 You can follow our oXygen release/build RSS feed here: http://www.oxygenxml.com/rssBuildID.xml New Mac OS X builds have also been released for oXygen 11.2 (2012040616) and 12.2 (2012040613). These new builds fix a compatibility problem of the SVN Client with Java Update 1.6.0_31 (Mac only). The latest maintenance builds for oXygen 11.2 and 12.2 are available in the software archive section of our website: http://www.oxygenxml.com/software_archive.html Please let us know if you encounter any problems with any of the new builds. 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

2 2