June 2009 - oXygen-user - www.oxygenxml.com

importing a custom docbook epub stylesheet
by Robert Nagle 29 Jun '09

29 Jun '09

Hi, I noticed there is a good web demo of how to customize a docbook stylesheet. http://www.oxygenxml.com/demo/DocbookCustomization/docbookCustomization.html Basically you create a customization layer which imports the standard docbook stylesheet. Then you edit that customization layer. I noticed something strange. Oxygen validates the imported stylesheet when XSLT version is 1.0, but if you change it to 2.0, I get 19 errors. ********************** this is fine <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/epub/docbook.xsl"/> </xsl:stylesheet> ****************** this produces saxon errors <?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" exclude-result-prefixes="xs" version="2.0"> <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/epub/docbook.xsl"/> </xsl:stylesheet> *********************************** here's a screenshot of the error messages http://www.flickr.com/photos/rjnagle/3664940578/ What it looks like is going on is that Oxygen is recognizing that the XSL being imported is from docbook and therefore it uses a local copy of the file. And it's seeing a mismatch between the latest version online with the local xsl it is references. So I changed it to this and got a smaller number of errors: <?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" exclude-result-prefixes="xs" version="2.0"> <xsl:import href="http://docbook.sourceforge.net/release/xsl/1.75.1/epub/docbook.xsl"/> </xsl:stylesheet> -- SystemID: I:\My Documents\xml\rj2\test99ertest\2rjcustom.xsl Engine name: Saxon-B 9.1.0.6 Severity: error Description: Failed to compile stylesheet. 1 error detected. SystemID: http://docbook.sourceforge.net/release/xsl/1.75.1/epub/docbook.xsl Engine name: Saxon-B 9.1.0.6 Severity: fatal Description: The priority attribute must be absent if the match attribute is absent Start location: 1308:30 URL: http://www.w3.org/TR/xslt20/#err-XTSE0500 SystemID: http://docbook.sourceforge.net/release/xsl/1.75.1/common/stripns.xsl Engine name: Saxon-B 9.1.0.6 Severity: warning Description: The attribute axis starting at a document node will never select anything Start location: 282:0 I have some meta questions with regard to the general process of debugging here. 1. I assume that xslt v2 is better because it's a bigger number (and I've glanced over the differences in syntax, etc). Can you think of a reason why something would fail when version 2 is specified which would not be the case if version 1 is specified? Is best practice just to play it safe and go with version 1, or should I generally use 2 unless otherwise specified? 2. I'm guessing that it's easier to debug a local copy of a xsl file than a remote one (in this case version 1.7.5.1 of the epub-xsl transform. which is different from the local version (which is 1.7.4 that came with 10.2). Is there a way that Oxygen knows to associate the URL in the xsl import command with a local file or files on my Windows machine? I don't know how to do this. 3. (Now for my really naive question). What's the best way to debug XSLT messages. Should I start at the source xsl of the file(s) being imported here. Or should I be looking up references in Saxon parser or using some Oxygen debugging view. I realize that the answer is probably "it depends", but where does one start first? Thanks. Robert 3) Robert Nagle 12777 Ashford Point Dr #1417 Houston, Texas 77082 713 893 3424 htpt://www.robertnagle.info

2 1

(Windows) opening up a file in different instances?
by Robert Nagle 29 Jun '09

29 Jun '09

In Windows vista 64 , when I right click an xml/xsl file, a new and separate instance of Oxygen will open up. Is there any easy way to instruct Oxygen to open the file in the previously opened Oyxgen instance rather than to open up a new instance each time? -- Robert Nagle 12777 Ashford Point Dr #1417 Houston, Texas 77082 713 893 3424 htpt://www.robertnagle.info

2 1

Problem with Idiom FO transform
by Loreti, Wendy 26 Jun '09

26 Jun '09

Hello, I'm new here. I have a question: When I use the DITA OT transformation, the pdf is successfully created, but when I try to use the Idiom FO transformation, it chugs along, then stops and hangs with this in the log: 1071 ERROR [ main ] org.apache.fop.datatypes.LengthBase - getBaseLength called without context Does anyone know what that's about? Also, will this Idiom transformation create an index? The DITA one won't. Wendy Loreti Senior Technical Writer Vocollect, Inc. 703 Rodi Rd. Pittsburgh, PA 15235 www.vocollect.com <http://www.vocollect.com/> CONFIDENTIALITY NOTICE This message, together with any attachments, may be legally privileged and is confidential information intended only for the use of the individual or entity to which it is addressed. It is exempt from disclosure under applicable law including court orders. If you are not the intended recipient, you are hereby notified that any use, dissemination, distribution or copy of this message, or any attachment, is strictly prohibited. If you have received this message in error, please notify the original sender and delete this message, along with any attachments, from your computer.

2 1

xsl recursive condition
by ivanmacculi＠libero.it 26 Jun '09

26 Jun '09

Hi all, I've problem to select a value to one attribute: i need to change the content of one element and to select the value by the attribute of another element. Is it easy? sure, but problem is that i need to select the right element within all equal elements. Output is .xml It's like this: <bookstore> <books> <book ID=1>History of Italy</book> <book ID=2>History of Spain</book> <book ID=2/>Tales from China</book> </books> <other XML section> <hand IDM=1 title=Italy/> <hand IDM=2 title=Spain/> <hand IDM=3 title=China/> </other XML section> </bookstore> it will be like this: <bookstore> <books> <book ID=1>Italy</book> <book ID=2>Spain</book> <book ID=2/>China</book> </books> <other XML section> <hand IDM=1 title=Italy/> <hand IDM=2 title=Spain/> <hand IDM=3 title=China/> </other XML section> </bookstore> How can i get it? Thanks everyone for help.

2 1

(no subject)
by ivanmacculi＠libero.it 26 Jun '09

26 Jun '09

Hi all, I've problem to select a value to one attribute: i need to change the content of one element and to select the value by the attribute of another element. Is it easy? sure, but problem is that i need to select the right element within all equal elements. Output is .xml It's like this: <bookstore> <books> <book ID=1>History of Italy</book> <book ID=2>History of Spain</book> <book ID=2/>Tales from China</book> </books> <other XML section> <hand IDM=1 title=Italy/> <hand IDM=2 title=Spain/> <hand IDM=3 title=China/> </other XML section> </bookstore> it will be like this: <bookstore> <books> <book ID=1>Italy</book> <book ID=2>Spain</book> <book ID=2/>China</book> </books> <other XML section> <hand IDM=1 title=Italy/> <hand IDM=2 title=Spain/> <hand IDM=3 title=China/> </other XML section> </bookstore> How can i get it? Thanks everyone for help.

1 0

xsl:result-document and Saxon-SA gives "Cannot write to a URI that has already been read"
by Andrew Welch 25 Jun '09

25 Jun '09

Hi, Using oXygen 10.2, this stylesheet runs as expected with Saxon B 9.1.0.6 (the output is <foo/>) <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" exclude-result-prefixes="xs" version="2.0"> <xsl:template match="/"> <xsl:result-document> <foo/> </xsl:result-document> </xsl:template> </xsl:stylesheet> However if you change the transform engine to Saxon SA, it fails with: "Cannot write to a URI that has already been read: ....." cheers -- Andrew Welch http://andrewjwelch.com Kernow: http://kernowforsaxon.sf.net/

3 6

CSS to Indicate Element References a Graphic?
by Eliot Kimber 22 Jun '09

22 Jun '09

For using CSS in Author mode for arbitrary doctypes (in my case, an XSD schema), is there a way to indicate via CSS that a given element is a reference to a graphic? I didn't see anything in the Oxygen help under CSS. Cheers, E. ---- Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc. email: ekimber(a)reallysi.com <mailto:ekimber@reallysi.com> office: 610.631.6770 | cell: 512.554.9368 2570 Boulevard of the Generals | Suite 213 | Audubon, PA 19403 www.reallysi.com <http://www.reallysi.com> | http://blog.reallysi.com <http://blog.reallysi.com> | www.rsuitecms.com <http://www.rsuitecms.com>

2 2

Re: [oXygen-user] parameters, catalogs, docbook, etc
by Robert Nagle 16 Jun '09

16 Jun '09

First, Sorin, Good to hear that you are considering an epub transformation for a future release. I'll be sure to make an announcement at www.teleread.org when that happens. There is a dearth of good tools to produce .epub files from source. So here is my understanding based on what you said: When the files are in a project, the xpr project file is an xml file containing the customizations specific to your project. That includes names of files, and the specifics of any customized transformation which you have added for the specific project. So you could find your customizations here. so docbook5.framework stores all the scenarios which will show up for the docbook5 global scenarios list? My main concerns here are 1)being able to find the xslt customizations after I make them (in the event that i need to run them via command line or use another application), 2)being able to use the same xslt customizations for a second project if I create another docbook project and 3))not accidentally deleting or altering the default transforms. I guess the general solution is to use projects as much as possible. I'm looking here http://www.oxygenxml.com/doc/ug-oxygen/preferences-sharing.html I'm not quite sure what you are doing when you go to Configure Transformation Scenario and switch from GLOBAL SCENARIOS to PROJECT SCENARIOS and vice versa. Regardless of whether I select GLOBAL or PROJECT, they both show the same scenarios (the read-only scenarios indicated by a key icon and a customized scenario I have created myself). Is this normal? (My guess: I originally created them with GLOBAL SCENARIOS checked, and so that means they appear in the PROJECT SCENARIOS tab as well. But the rev). If I try to delete a custom scenario from either Project Scenarios or Global Scenarios and press ok, I see that the scenario i have tried to delete has not been deleted. What do I need to do to accomplish this? Reading through the archives, I see that you are trying to rework the UI for the transformations dialog. That would probably be a good thing. The thing that confuses me is why the same scenarios appear when you have PROJECT SCENARIOS checked as when would have GLOBAL SCENARIOS. Robert ****************************************** > Hello, > > If you store the scenarios at global level (the default setting) they > are stored in the user preferences in a subfolder of the user home > folder. If you want to share the scenario with other users you should > store it at project level or at document type level. > > If you work on a common project that you load in the Project view and > you share with other users you can store the transformation scenarios at > project level with the radio button Project Scenarios in the dialog > Configure Transformation Scenario that is opened by the action with the > same name on the toolbar Transformation and on the menu Document -> > Transformation. In this case you share the .xpr project file with other > users. > > You have a DocBook XML document so it matches one of the two predefined > DocBook document types (DocBook 4 and DocBook 5). If you store the > scenario at document type level it is saved in the .framework file of > that document type so you have to share the .framework file with other > users, that is frameworks/docbook/docbook4.framework or > frameworks/docbook/docbook5.framework. > > The epub transformation needs a zip application and a Ruby runtime so > the Oxygen installer should include them which means a bigger installer > file. We will consider a default epub transformation for a future version. > > > Regards, -- Robert Nagle 12777 Ashford Point Dr #1417 Houston, Texas 77082 713 893 3424 htpt://www.robertnagle.info

2 1

Using cref, oxygen, and transforms
by Steve Matlock 15 Jun '09

15 Jun '09

I have two files, one with a topic and one with definitions: * TOPIC* <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "Topic.dtd"> <topic id="CREF_TOPIC"> <title>Topic with crossref</title> <body> The best thing since sliced bread is <ph conref="cfs.dita#cfs/mpm"/>. </body> </topic> *DEFINITIONS* <?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Composite//EN" "Topic.dtd"> <topic id="cfs"> <title>Cross References</title> <body> <ph id="mpm">My Payment Method</ph> <ph id="stx">SuperTransactions</ph> </body> </topic> If I set this up & view in Oxygen 10.2, the first tile (TOPIC) displays the cref values just fine. When I run any of the default transforms in Oxygen (to PDF, HTML, etc.), the cref value is blank. I'm not getting an error in the transform - says it transformed fine. But cref isn't working. Clues on how to debug this? The cref is a major component of my documentation plans - I want to have pre-defined values that I can use in documentation so I don't need to update product names, release dates, and so on, inside the final documents.

2 2

Author : copy/past - problem with the code U+0000
by Rogie Isabelle 15 Jun '09

15 Jun '09

Hello, When I copy/paste a text from Xpress in an xml element, I have this message: F [Xerces] An invalid XML character (Unicode: 0x0) was found in the element content of the document. Is there a solution to avoid this problem? I use Author version 10.2 on Mac OS X. Best Regards, _______________________________________ Isabelle Rogie Database Chief Project Wolters Kluwer France

2 1