- oXygen-user - www.oxygenxml.com

Announce: new hands-on oXygen training classes
by G. Ken Holman 09 Oct '11

09 Oct '11

Crane Softwrights Ltd. is pleased to announce that we just completed the inaugural delivery of our new 2-day "Developer Audience" configuration of our hands-on <oXygen/> class that may be of interest to you. I can travel to deliver the material or the material can be licensed for delivery by other trainers: Practical Use of <oXygen/> XML http://www.CraneSoftwrights.com/schedule.htm#puxx Please contact me off-list if you have any questions regarding our instructor-led training. In particular, if you are willing to host a publicly-subscribed training class hiring me to deliver to your audience (perhaps your own trainers in a train-the-trainers scenario), then please let me know. Thank you! . . . . . . . . . . . Ken cc: XML-Dev, Mulberry XSL, W3C XSL-FO, UBL-Dev, CLR-Dev, XML-L, Antenna House List, RenderX List, oXygen List -- Contact us for world-wide XML consulting and instructor-led training Crane Softwrights Ltd. http://www.CraneSoftwrights.com/x/ G. Ken Holman mailto:gkholman@CraneSoftwrights.com Google+ profile: https://plus.google.com/116832879756988317389/about Legal business disclaimers: http://www.CraneSoftwrights.com/legal

1 0

Announce: Crane's XML-related book freely available on "Try and Buy" convenant
by G. Ken Holman 09 Oct '11

09 Oct '11

Crane Softwrights Ltd. is pleased to announce that all four of its commercial PDF publications are now freely-downloadable based on a "Try and Buy" covenant: Practical Transformation Using XSLT and XPath http://www.CraneSoftwrights.com/training/#ptux Practical Formatting Using XSL-FO http://www.CraneSoftwrights.com/training/#pfux Practical Universal Business Language Deployment http://www.CraneSoftwrights.com/training/#publd Practical Code List Implementation in XML http://www.CraneSoftwrights.com/training/#pcli The "Try and Buy" policy asks you to acknowledge that if you find the book useful and want to keep using it, you will pay for a registered copy. If you decide you are not going to use the book, please delete it from your system. Please do not keep a copy around if you are not going to pay for it. http://www.CraneSoftwrights.com/training/#tryandbuy Registered book owners (including all who have already bought our books in the past) have free access to our book forums at http://books.CraneSoftwrights.com where questions about the content found in the books can be posted. Spam-avoidance procedures require book owners to create a forum login account and immediately forward the account name to me, otherwise the account may be inadvertently deleted (dozens of spam accounts are created every day). We are looking forward to this growing to be a useful resource for book owners as well as for myself as I look for ways to improve each publication based on the questions being asked. Each of the above four books is the basis of handout material for our four respective instructor-led training classes (of the same names). I can travel to deliver the material or the material can be licensed for delivery by other trainers: Practical Transformation Using XSLT and XPath http://www.CraneSoftwrights.com/schedule.htm#ptux Practical Formatting Using XSL-FO http://www.CraneSoftwrights.com/schedule.htm#pfux Practical Universal Business Language Deployment http://www.CraneSoftwrights.com/schedule.htm#publd Practical Code List Implementation in XML http://www.CraneSoftwrights.com/schedule.htm#pcli We have a long history of me teaching these materials around the world: http://www.CraneSoftwrights.com/training/pastsch.htm Please contact me off-list if you have any questions regarding our books or our instructor-led training. In particular, if you are willing to host a publicly-subscribed training class hiring me to deliver to your audience (perhaps your own trainers in a train-the-trainers scenario), then please let me know. Thank you! . . . . . . . . . . . . Ken cc: XML-Dev, Mulberry XSL, W3C XSL-FO, UBL-Dev, CLR-Dev, XML-L, Antenna House List, RenderX List, oXygen List -- Contact us for world-wide XML consulting and instructor-led training Crane Softwrights Ltd. http://www.CraneSoftwrights.com/x/ G. Ken Holman mailto:gkholman@CraneSoftwrights.com Google+ profile: https://plus.google.com/116832879756988317389/about Legal business disclaimers: http://www.CraneSoftwrights.com/legal

1 0

Validate and Validate with …
by Jens Østergaard Petersen 07 Oct '11

07 Oct '11

Hi, I am sure I am just missing something obvious, but here goes! I have a document like <http://kjc-fs2.kjc.uni-heidelberg.de:8600/exist/apps/tamboti/modules/search…> When I simply "Validate" this, that is click the red checkmark, I get SystemID: http://cluster-schemas.uni-hd.de/modsCluster.xsd Main validation file: /Users/jens/Desktop/Untitled1.xml Schema: http://cluster-schemas.uni-hd.de/modsCluster.xsd Engine name: Saxon-EE 9.3.0.5 Severity: fatal Description: The attributeGroup {simpleLink} is referenced, but has not been declared Start location: 1051:0 … The MODS schema in question references the XLink schema which declares the xlink:simpleLink attributeGroup, but the link to the XLink schema is obviously not de-referenced. However, when I choose "Validate with …" by clicking on the arrow to the right of the checkmark and feed the schemaLocation contained in the MODS document (namely, <http://cluster-schemas.uni-hd.de/modsCluster.xsd>), the document validates. In this case then, the XLink schema must be referenced. What explains this difference? When I open the schema at <http://cluster-schemas.uni-hd.de/modsCluster.xsd>, the XLink schema is also not de-referenced. Best, Jens oXygen 13.0 on Max OS X 10.6.8.

3 2

A Trivial Docbook to Epub Oxygen/Ant Transform doesn't produce valid epub files!
by Robert Nagle 05 Oct '11

05 Oct '11

Hi, I tried in XML Author to transform a small and simple docbook file using the included build.xml file. I used an example file already included with Oxygen. I added a chapter and removed the address element (for reasons explained below). *********************************** <?xml version="1.0" encoding="UTF-8"?> <?xml-model href="http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rng" schematypens="http://relaxng.org/ns/structure/1.0"?> <book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> <info> <title>Book Template Title</title> <author> <orgname>Organization Name</orgname> <email>user(a)example.com</email> </author> </info> <part> <title>First Part</title> <subtitle>Subtitle of First Part</subtitle> <chapter> <title>Chapter Title</title> <subtitle>Subtitle of Chapter</subtitle> <sect1> <title>Section1 Title</title> <subtitle>Subtitle of Section 1</subtitle> <para>Text hello this is robert </para> </sect1> </chapter> <chapter> <title>Second chapter</title> <para> This is the second chapter. </para> </chapter> </part> </book> ************************************** I used the ant script to transform this small xml file into epub. I did produce an epub file, but it did not validate with epubcheck. Here are the validation messages: SystemID: zip:file:/I:/My Documents/My Dropbox/xml/oxygen-mytest/out/dummy.epub!/content.opf Engine name: EpubCheck Severity: error Description: item with id 'd0e2' not found Start location: 1:0 SystemID: I:\My Documents\My Dropbox\xml\oxygen-mytest\out\dummy.epub Engine name: EpubCheck Severity: warning Description: item (index.html) exists in the zip file, but is not declared in the OPF file SystemID: zip:file:/I:/My Documents/My Dropbox/xml/oxygen-mytest/out/dummy.epub!/toc.ncx Engine name: EpubCheck Severity: error Description: 'index.html': referenced resource exists, but not declared in the OPF file Start location: 1:0 ********************** Here is the content.opf file. I put marks where there were problems <?xml version="1.0" encoding="utf-8"?> <package xmlns="http://www.idpf.org/2007/opf" version="2.0" unique-identifier="bookid"> <metadata> <dc:identifier xmlns:dc="http://purl.org/dc/elements/1.1/" id="bookid">_d0e2</dc:identifier> <dc:title xmlns:dc="http://purl.org/dc/elements/1.1/">Book Template Title</dc:title> <dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:opf="http://www.idpf.org/2007/opf" opf:file-as=""/> <dc:language xmlns:dc="http://purl.org/dc/elements/1.1/">en</dc:language> </metadata> <manifest> <item id="ncxtoc" media-type="application/x-dtbncx+xml" href="toc.ncx"/> <item id="htmltoc" media-type="application/xhtml+xml" href="bk01-toc.html"/> <item id="d0e11" href="pt01.html" media-type="application/xhtml+xml"/> <item id="d0e16" href="ch01.html" media-type="application/xhtml+xml"/> <item id="d0e28" href="ch02.html" media-type="application/xhtml+xml"/> </manifest> <spine toc="ncxtoc"> <itemref idref="htmltoc" linear="yes"/> <itemref idref="d0e2"/> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX <itemref idref="d0e11"/> <itemref idref="d0e16"/> <itemref idref="d0e28"/> </spine> <guide> <reference href="bk01-toc.html" type="toc" title="Table of Contents"/> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX NO INDEX.HTML reference </guide> </package> ******************************************************************** The ant log is below. Please note that I later ran the db2epub.py script via command line with no customization layer using docbook-xsl-1.76.1 and produced an epub file validated by epubcheck. The index.html file was correctly referenced. A few other notes. First, db2epub.py did produce a kind of html output error with the address containing a single invalid p tag. I don't know what's going on with that, but that could be a docbook xsl bug. Second, I seem to recall that when my customization layer referenced the namespaced version of the epub docbook xsl that occasionally it produced extra references in content.opf. Keith Fahlgren basically said it was related to using the namespaced XSL when making epub transforms. I would appreciate any insight you can shed on this. Thanks. Robert Executing: "c:\program files (x86)\oxygen xml editor 13\jre/bin/java" -Xmx256m -classpath "C:\Program Files (x86)\Oxygen XML Editor 13/tools/ant/lib/ant-launcher.jar" "-Dant.home=C:\Program Files (x86)\Oxygen XML Editor 13/tools/ant" org.apache.tools.ant.launch.Launcher -lib "C:\Program Files (x86)\Oxygen XML Editor 13\classes" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\oxygen.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\oxygenAuthor.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\oxygenDeveloper.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\oxygenEclipse.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\oxygenAuthorEclipse.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\oxygenDeveloperEclipse.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\resolver.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\xercesImpl.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\saxon.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\xml-apis-xpath.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\xml-apis-ext.jar" -lib "C:\Program Files (x86)\Oxygen XML Editor 13\lib\log4j.jar" -f "C:\Program Files (x86)\Oxygen XML Editor 13\frameworks/docbook/xsl/epub/bin/build.xml" "-Dchunker.output.encoding=UTF-8" "-DoutputFile=I:\My Documents\My Dropbox\xml\oxygen-mytest/out/dummy.epub" "-DxmlFile=I:\My Documents\My Dropbox\xml\oxygen-mytest\dummy.xml" Buildfile: C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\bin\build.xml dist: [delete] Deleting directory I:\My Documents\My Dropbox\xml\oxygen-mytest\out [mkdir] Created dir: I:\My Documents\My Dropbox\xml\oxygen-mytest\out [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\dummy.xml to I:\My Documents\My Dropbox\xml\oxygen-mytest\out\xincluded-profiled.xml [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\profiling\profile.xsl [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\xincluded-profiled.xml to I:\My Documents\My Dropbox\xml\oxygen-mytest\out\dummy.xml [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\docbook.xsl [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/bk01-toc.html for book [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/ch01.html for chapter [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/ch02.html for chapter [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/pt01.html for part [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/index.html for book [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/toc.ncx [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/content.opf [xslt] Writing I:\My Documents\My Dropbox\xml\oxygen-mytest\out/META-INF/container.xml [delete] Deleting: I:\My Documents\My Dropbox\xml\oxygen-mytest\out\dummy.xml [delete] Deleting: I:\My Documents\My Dropbox\xml\oxygen-mytest\out\xincluded-profiled.xml [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\content.opf to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\content.opf [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\removeImagesContentOpf.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out images: [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\bk01-toc.html to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\bk01-toc.html [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\images.xsl [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\content.opf to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\content.opf [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\addImagesContentOpf.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out images: [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\ch01.html to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\ch01.html [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\images.xsl [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\content.opf to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\content.opf [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\addImagesContentOpf.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out images: [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\ch02.html to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\ch02.html [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\images.xsl [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\content.opf to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\content.opf [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\addImagesContentOpf.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out images: [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\index.html to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\index.html [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\images.xsl [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\content.opf to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\content.opf [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\addImagesContentOpf.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out images: [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\pt01.html to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\pt01.html [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\images.xsl [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\content.opf to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\content.opf [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\addImagesContentOpf.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out [copy] Copying 5 files to I:\My Documents\My Dropbox\xml\oxygen-mytest\out [delete] Deleting directory I:\My Documents\My Dropbox\xml\oxygen-mytest\temp [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\toc.ncx to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\toc.ncx [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\copy.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out [xslt] Processing I:\My Documents\My Dropbox\xml\oxygen-mytest\out\META-INF\container.xml to I:\My Documents\My Dropbox\xml\oxygen-mytest\temp\container.xml [xslt] Loading stylesheet C:\Program Files (x86)\Oxygen XML Editor 13\frameworks\docbook\xsl\epub\copy.xsl [copy] Copying 1 file to I:\My Documents\My Dropbox\xml\oxygen-mytest\out\META-INF [zip] Building zip: I:\My Documents\My Dropbox\xml\oxygen-mytest\out\dummy.epub [zip] Updating zip: I:\My Documents\My Dropbox\xml\oxygen-mytest\out\dummy.epub BUILD SUCCESSFUL Total time: 3 seconds The process finished with exit code: 0 -- Robert Nagle 6121 Winsome Ln #56C, Houston TX 77057-5581 (H) 713 893 3424/ (W) 832-251-7522 Carbon Neutral Since Jan 2010 http://www.robertnagle.info

2 1

Configuration of profiling attributes and their values
by Jirka Kosek 04 Oct '11

04 Oct '11

Hi, would it be possible to move configuration of profiling attributes and their values into document type? I often create customized version of DocBook for my customer and part of this customization are also preconfigured values for profiling in schema. Schema and other necessary files are distributed as an oXygen framework so it makes sense to configure profiling attributes here then as a global/project options. Thanks, Jirka -- ------------------------------------------------------------------ Jirka Kosek e-mail: jirka(a)kosek.cz http://www.kosek.cz ------------------------------------------------------------------ Profesionální školení a poradenství v oblasti technologií XML. Podrobný přehled školení http://xmlguru.cz/skoleni/ ------------------------------------------------------------------ http://docbook.cz Stránky o dokumentačním formátu DocBook http://xmlguru.cz Blog mostly about XML for English readers ------------------------------------------------------------------

4 9

DITA: @audience with two diffent values in one map
by Theun Fleer 04 Oct '11

04 Oct '11

hi all, I made a DITA-map that refers twice to one and the same task. First with @audience = novice, secondly with @audience = expert. The topic has several elements (substeps) that are only applicable for "novice". map | |--topic topicref="topic.dita" audience="novice" | |--topic topicref="topic.dita" audience="expert" I want the topic to appear twice in the publication: the first occurence for novice, the second for expert. When I use DITA-OT with the settings above, I get the same topic twice, both instances showing no conditions at all, so both showing all elements. What am I doing wrong? Can DITA+OT do what I want? regards, Theun Fleer

2 1

DITA: @audience with two diffent values in one map
by Theun Fleer 04 Oct '11

04 Oct '11

hi all I made a DITA-map that refers twice to one and the same task. First with @audience = novice, secondly with @audience = expert. The topic has several elements (substeps) that are only applicable for "novice". map | |--topic topicref="topic.dita" audience="novice" | |--topic topicref="topic.dita" audience="expert" I want the topic to appear twice in the publication: the first occurence for novice, the second for expert. When I use DITA-OT with the settings above, I get the same topic twice, both instances showing no conditionas at all, so with the smanaSLabvfk'lj ps;vknfjv b

1 0

Are there scripting capabilities in Oxygen, e.g., to process multiple files?
by Bob Futrelle 30 Sep '11

30 Sep '11

Scripting may be in the Oxygen Editor, but I haven't been able to find it. - Bob Futrelle

2 1

Validating entities?
by Espen S. Ore 29 Sep '11

29 Sep '11

This is possibly a silly question, please forgive me if that is the case: We have text files and RelaxNG schemas for them. In addition we point to DTD-fragments for defining entities. It seems that validation in Oxygen (both 12.x and 13) out-of-the-box does not check to see if entities used in the text file are declared or not, that the files are considered valid even if they use entity-names that are not used. A typical start-of-textfile may look like this: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE TEI [ <!ENTITY % HIS_entiteter SYSTEM 'http://www.edd.uio.no/ibsen/schema/ibsen-charent.dtd' > %HIS_entiteter; ]> <?xml-model href="http://www.edd.uio.no/ibsen/schema/tei_his.rnc" type="application/relax-ng-compact-syntax"?> <TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:HIS="http://www.example.org/ns/HIS"> <teiHeader xml:lang="nob"> <fileDesc> <titleStmt> <title level="s" type="main">Henrik Ibsens skrifter</title> <title level="s" type="sub">Diplomatarisk tekstarkiv</title> <title level="a" type="main">Peer Gynt</title> <title level="a" type="sub">NBO Ms.8° 894 (trykt eksemplar med rettelser)</title> <title level="a" type="origYear">[1874]</title> What can we do to have an error flagged if [ is not declared? Best regards, Espen Ore University of Oslo

4 4

Enhancement Request: Make keyref dialog wider
by Eliot Kimber 28 Sep '11

28 Sep '11

Good practice for DITA key names is to use a distinguishing prefix so that related keys sort together alphabetically. I'm finding that the default width of the Insert Content Key Reference dialog is too narrow so that the keys are truncated before even the complete prefix is display. E.g., my keys are "action-handler-foo-bar" where "action-handler-" is the common prefix. Suggest making the default width for the dialog at least twice the current default. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

2 3