Re: [docbook] Simplifying image markup
On 7.8.2013 22:07, Norman Walsh wrote: Should we consider allowing bare imagedata/audiodata/videodata elements in DocBook? I suppose they'd be both inline and block elements. You mean introducing graphic element back? http://www.docbook.org/tdg/en/html/graphic.html :-) Certainly we can revisit design and offer something simpler. At that time we should check whether we are aligned with what HTML5's audio/video elements offer. Also approach for delivering one image in multiple resolutions is now being developed for HTML so if we are going to simplify something we should be prepared for upcoming changes. Jirka -- -- Jirka Kosek e-mail: ji...@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 rep. -- Bringing you XML Prague conferencehttp://xmlprague.cz -- signature.asc Description: OpenPGP digital signature
[docbook] Re: Simplifying image markup
You mean introducing graphic element back? http://www.docbook.org/tdg/en/html/graphic.html Well, not *exactly*. :-) :-) Certainly we can revisit design and offer something simpler. At that time we should check whether we are aligned with what HTML5's audio/video elements offer. I believe we did that for DocBook 5. Also approach for delivering one image in multiple resolutions is now being developed for HTML so if we are going to simplify something we should be prepared for upcoming changes. Yes. Any pointers? Be seeing you, norm -- Norman Walsh n...@nwalsh.com | Nearly all men can stand http://www.oasis-open.org/docbook/ | adversity, but if you want to test Chair, DocBook Technical Committee | a man's character, give him | power.--Abraham Lincoln signature.asc Description: PGP signature
[docbook] Re: Linking to an Unknown Amount of Targets (1:n relationships)?
Bob Stayton b...@sagehill.net writes: I know the issue in the past with adding it to the stylesheet was: How do you render a multi-link? We assumed it required a dynamic presentation, so when the user clicked on the link they got a list of targets to choose from. In HTML, you could generate a pop-up list, but in PDF? My plan is to do something along the lines Eric proposed: http://www.balisage.net/Proceedings/vol7/html/Vlist01/BalisageVol7-Vlist01.html Be seeing you, norm -- Norman Walsh n...@nwalsh.com | To think is not enough; you must http://www.oasis-open.org/docbook/ | think of something.--Jules Renard Chair, DocBook Technical Committee | signature.asc Description: PGP signature
Re: [docbook] Re: Linking to an Unknown Amount of Targets (1:n relationships)?
On 09/08/13 13:49, Norman Walsh wrote: Bob Stayton b...@sagehill.net writes: I know the issue in the past with adding it to the stylesheet was: How do you render a multi-link? We assumed it required a dynamic presentation, so when the user clicked on the link they got a list of targets to choose from. In HTML, you could generate a pop-up list, but in PDF? My plan is to do something along the lines Eric proposed: http://www.balisage.net/Proceedings/vol7/html/Vlist01/BalisageVol7-Vlist01.html KISS principle - his figure 5 (admitted less pretty) seems much more usable? A simple series of links, each with its own hot text. regards -- Dave Pawson XSLT XSL-FO FAQ. http://www.dpawson.co.uk - To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org
[docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)
I'm trying to get DocBook WebHelp building working. Although I do already have a working Ant build file based on the one from the DocBook stylesheet distribution I would like to use Catalogs for resolving my stylesheet locations, which the one provided doesn't. For my other target formats I'm using Saxon 6, via an Ant Java task. I have catalogs working for these as that's taken care of by parameters passed to Saxon. For WebHelp I'm using the Xslt task - that's how the one in the stylesheet distribution is written, and it uses attributes like if and expression in its param elements, and I don't know how to convert these to Java/Saxon. I've tried to follow Ant's documentation regarding the xmlcatalog element but I can't get it to work. (I am finding the Ant documentation in this area extremely hard to follow) By can't get it to work I mean it doesn't find the files I'm trying to reference via the catalog. It doesn't show any messages indicating whether or not it is using the resolver, so I presume it isn't finding it. Does anyone have any complete example of this working. Ie one that includes a reference to the resolver jar, and the classpath, and the catalog file and/or catalogManager.properties. Alternatively - I think the only thing that blocked me from using Saxon was not knowing how to implement @expression and @if, so if anyone can indicate how to do that for Java/Saxon I may revert to that option. Appreciatively, Richard. Richard Kerry BNCS Engineer, SI SOL Telco Media Vertical Practice T: +44 (0)20 822 59063 (for the moment) M: +44 (0)7812 325518 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ (for the moment) richard.ke...@atos.netmailto:richard.ke...@atos.net inline: Picture (Device Independent Bitmap) 1.jpginline: Picture (Device Independent Bitmap) 2.jpg
[docbook-apps] Using the Maven example project - goals to run customisation
Hi there, I was wondering if anyone could explain how to use the example Maven project located here: http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/maven/docbook-sample/ From the look of the POM file, the project is capable of doing the following during a build: * downloading the latest version of the standard DocBook stylesheets and their NS equivalents using the Maven dependency plugin * Unpacking the stylesheets to a temporary directory inside 'target/generated-resources' * Transforming a document (in the sample project, sample.xml) using the downloaded stylesheets This is exactly the workflow I'd like to replicate. What I'm confused about is which goals/targets to run to get it to actually do all this stuff. I've tried things like 'xml:transform', 'site' and so on, but it always seems to fail to actually download the stylesheets or transform the source files. Can anyone enlighten me? Thanks in advance for any assistance. Graeme - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)
Hi Kerry, We use the xslt task in ant with catalogs. The FO transformation consists of the following xslt task xslt in=${outputLocation}/${docName}-profiled.xml style=${env.BUILD_TOOLS_DOCBOOK_DIR}/pdf-ns.xsl out=${outputLocation}/${docName}.fo scanincludeddirectories=false sysproperty key=org.apache.xerces.xni.parser.XMLParserConfiguration value=org.apache.xerces.parsers.XIncludeParserConfiguration/ xmlcatalog refid=DOCBOOK_XML_CATALOG/ /xslt Where, as you see we reference the DOCBOOK_XML_CATALOG defined as xmlcatalog id=DOCBOOK_XML_CATALOG catalogpath fileset dir=${env.XML_CATALOG_DIR}/frameworks includes=**/*catalog.xml/ /catalogpath /xmlcatalog Note that the manual dtd tags are for backward compliance with some of our legacy systems. The catalog files follow the default Oasis catalog structure. As the good eye will see our structure is inspired by how Oxygen lays out the catalog. :: Morten From: Kerry, Richard [mailto:richard.ke...@atos.net] Sent: 9. august 2013 12:20 To: docbook-apps@lists.oasis-open.org Subject: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp) I'm trying to get DocBook WebHelp building working. Although I do already have a working Ant build file based on the one from the DocBook stylesheet distribution I would like to use Catalogs for resolving my stylesheet locations, which the one provided doesn't. For my other target formats I'm using Saxon 6, via an Ant Java task. I have catalogs working for these as that's taken care of by parameters passed to Saxon. For WebHelp I'm using the Xslt task - that's how the one in the stylesheet distribution is written, and it uses attributes like if and expression in its param elements, and I don't know how to convert these to Java/Saxon. I've tried to follow Ant's documentation regarding the xmlcatalog element but I can't get it to work. (I am finding the Ant documentation in this area extremely hard to follow) By can't get it to work I mean it doesn't find the files I'm trying to reference via the catalog. It doesn't show any messages indicating whether or not it is using the resolver, so I presume it isn't finding it. Does anyone have any complete example of this working. Ie one that includes a reference to the resolver jar, and the classpath, and the catalog file and/or catalogManager.properties. Alternatively - I think the only thing that blocked me from using Saxon was not knowing how to implement @expression and @if, so if anyone can indicate how to do that for Java/Saxon I may revert to that option. Appreciatively, Richard. Richard Kerry BNCS Engineer, SI SOL Telco Media Vertical Practice T: +44 (0)20 822 59063 (for the moment) M: +44 (0)7812 325518 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ (for the moment) richard.ke...@atos.netmailto:richard.ke...@atos.net [cid:image002.jpg@01CE950E.7C3C9930] inline: image001.jpginline: image002.jpg
[docbook-apps] RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)
Morten, I'm not convinced you're doing what I want to do. Your @style attribute includes a property which looks likely to be a directory name. This suggests you aren't using the catalog to get the xsl file's location. You don't show any reference to catalogManager.properties. There is a comment in the Ant documentation about getting resolver.jar accessed via the classpath (or the path). You show nothing which addresses that. I suspect I'm not seeing any relevant behaviour in my system as I haven't done that successfully. In continue to get the error stylesheet name of my stylesheet doesn't exist and no mention of catalog or resolver in the log (ie they are mentioned in that I'm assigning properties with them in the names, but there is no message to say they are or are not being found, or used. Uncertainly, Richard. From: Olsen, Morten Engelhardt [mailto:morten_engelhardt.ol...@atmel.com] Sent: Friday, August 09, 2013 1:43 PM To: Kerry, Richard; docbook-apps@lists.oasis-open.org Subject: RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp) Hi Kerry, We use the xslt task in ant with catalogs. The FO transformation consists of the following xslt task xslt in=${outputLocation}/${docName}-profiled.xml style=${env.BUILD_TOOLS_DOCBOOK_DIR}/pdf-ns.xsl out=${outputLocation}/${docName}.fo scanincludeddirectories=false sysproperty key=org.apache.xerces.xni.parser.XMLParserConfiguration value=org.apache.xerces.parsers.XIncludeParserConfiguration/ xmlcatalog refid=DOCBOOK_XML_CATALOG/ /xslt Where, as you see we reference the DOCBOOK_XML_CATALOG defined as xmlcatalog id=DOCBOOK_XML_CATALOG catalogpath fileset dir=${env.XML_CATALOG_DIR}/frameworks includes=**/*catalog.xml/ /catalogpath /xmlcatalog Note that the manual dtd tags are for backward compliance with some of our legacy systems. The catalog files follow the default Oasis catalog structure. As the good eye will see our structure is inspired by how Oxygen lays out the catalog. :: Morten From: Kerry, Richard [mailto:richard.ke...@atos.net] Sent: 9. august 2013 12:20 To: docbook-apps@lists.oasis-open.orgmailto:docbook-apps@lists.oasis-open.org Subject: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp) I'm trying to get DocBook WebHelp building working. Although I do already have a working Ant build file based on the one from the DocBook stylesheet distribution I would like to use Catalogs for resolving my stylesheet locations, which the one provided doesn't. For my other target formats I'm using Saxon 6, via an Ant Java task. I have catalogs working for these as that's taken care of by parameters passed to Saxon. For WebHelp I'm using the Xslt task - that's how the one in the stylesheet distribution is written, and it uses attributes like if and expression in its param elements, and I don't know how to convert these to Java/Saxon. I've tried to follow Ant's documentation regarding the xmlcatalog element but I can't get it to work. (I am finding the Ant documentation in this area extremely hard to follow) By can't get it to work I mean it doesn't find the files I'm trying to reference via the catalog. It doesn't show any messages indicating whether or not it is using the resolver, so I presume it isn't finding it. Does anyone have any complete example of this working. Ie one that includes a reference to the resolver jar, and the classpath, and the catalog file and/or catalogManager.properties. Alternatively - I think the only thing that blocked me from using Saxon was not knowing how to implement @expression and @if, so if anyone can indicate how to do that for Java/Saxon I may revert to that option. Appreciatively, Richard. Richard Kerry BNCS Engineer, SI SOL Telco Media Vertical Practice T: +44 (0)20 822 59063 (for the moment) M: +44 (0)7812 325518 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ (for the moment) richard.ke...@atos.netmailto:richard.ke...@atos.net [cid:image002.jpg@01CE9513.C7E7FD70] inline: image001.jpginline: image002.jpg
[docbook-apps] RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)
Ah, me not reading properly. No, the catalog is used for offline caching of files etc in the docbook source. To clearify, you want to invoke the xslt task with a @style pointing to some URI, that the catalog would rewrite to some local file? :: Morten Engelhardt Olsen From: Kerry, Richard [richard.ke...@atos.net] Sent: Friday, August 09, 2013 16:23 To: docbook-apps@lists.oasis-open.org Subject: [docbook-apps] RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp) Morten, I’m not convinced you’re doing what I want to do. Your @style attribute includes a property which looks likely to be a directory name. This suggests you aren’t using the catalog to get the xsl file’s location. You don’t show any reference to catalogManager.properties. There is a comment in the Ant documentation about getting resolver.jar accessed via the classpath (or the path). You show nothing which addresses that. I suspect I’m not seeing any relevant behaviour in my system as I haven’t done that successfully. In continue to get the error “stylesheet name of my stylesheet doesn’t exist” and no mention of catalog or resolver in the log (ie they are mentioned in that I’m assigning properties with them in the names, but there is no message to say they are or are not being found, or used. Uncertainly, Richard. From: Olsen, Morten Engelhardt [mailto:morten_engelhardt.ol...@atmel.com] Sent: Friday, August 09, 2013 1:43 PM To: Kerry, Richard; docbook-apps@lists.oasis-open.org Subject: RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp) Hi Kerry, We use the xslt task in ant with catalogs. The FO transformation consists of the following xslt task xslt in=${outputLocation}/${docName}-profiled.xml style=${env.BUILD_TOOLS_DOCBOOK_DIR}/pdf-ns.xsl out=${outputLocation}/${docName}.fo scanincludeddirectories=false sysproperty key=org.apache.xerces.xni.parser.XMLParserConfiguration value=org.apache.xerces.parsers.XIncludeParserConfiguration/ xmlcatalog refid=DOCBOOK_XML_CATALOG/ /xslt Where, as you see we reference the DOCBOOK_XML_CATALOG defined as xmlcatalog id=DOCBOOK_XML_CATALOG catalogpath fileset dir=${env.XML_CATALOG_DIR}/frameworks includes=**/*catalog.xml/ /catalogpath /xmlcatalog Note that the manual dtd tags are for backward compliance with some of our legacy systems. The catalog files follow the default Oasis catalog structure. As the good eye will see our structure is inspired by how Oxygen lays out the catalog. :: Morten From: Kerry, Richard [mailto:richard.ke...@atos.net] Sent: 9. august 2013 12:20 To: docbook-apps@lists.oasis-open.orgmailto:docbook-apps@lists.oasis-open.org Subject: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp) I’m trying to get DocBook WebHelp building working. Although I do already have a working Ant build file based on the one from the DocBook stylesheet distribution I would like to use Catalogs for resolving my stylesheet locations, which the one provided doesn’t. For my other target formats I’m using Saxon 6, via an Ant Java task. I have catalogs working for these as that’s taken care of by parameters passed to Saxon. For WebHelp I’m using the Xslt task – that’s how the one in the stylesheet distribution is written, and it uses attributes like “if” and “expression” in its “param” elements, and I don’t know how to convert these to Java/Saxon. I’ve tried to follow Ant’s documentation regarding the xmlcatalog element but I can’t get it to work. (I am finding the Ant documentation in this area extremely hard to follow) By “can’t get it to work” I mean it doesn’t find the files I’m trying to reference via the catalog. It doesn’t show any messages indicating whether or not it is using the resolver, so I presume it isn’t finding it. Does anyone have any complete example of this working. Ie one that includes a reference to the resolver jar, and the classpath, and the catalog file and/or catalogManager.properties. Alternatively – I think the only thing that blocked me from using Saxon was not knowing how to implement @expression and @if, so if anyone can indicate how to do that for Java/Saxon I may revert to that option. Appreciatively, Richard. Richard Kerry BNCS Engineer, SI SOL Telco Media Vertical Practice T: +44 (0)20 822 59063 (for the moment) M: +44 (0)7812 325518 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ (for the moment) richard.ke...@atos.netmailto:richard.ke...@atos.net [cid:image002.jpg@01CE9513.C7E7FD70] inline: image001.jpginline: image002.jpg
Re: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)
On 08/09/2013 05:19 AM, Kerry, Richard wrote: For my other target formats I’m using Saxon 6, via an Ant Java task. I have catalogs working for these as that’s taken care of by parameters passed to Saxon. For WebHelp I’m using the Xslt task – that’s how the one in the stylesheet distribution is written, and it uses attributes like “if” and “expression” in its “param” elements, and I don’t know how to convert these to Java/Saxon. Yeah, it would be tough to convert those to use java. The benefit of the xslt task in this respect is that it doesn't pass in the param if the variable in the if attr is not set. That way you get to use the defaults set in the xslt. But you could just most of the params when converting to a java task and only pass in the params you care about/intend to set. David - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Using the Maven example project - goals to run customisation
On 08/09/2013 05:23 AM, gra...@heliocentrik.net wrote: This is exactly the workflow I'd like to replicate. What I'm confused about is which goals/targets to run to get it to actually do all this stuff. I've tried things like 'xml:transform', 'site' and so on, but it always seems to fail to actually download the stylesheets or transform the source files. Try: mvn clean generate-resources But as an alternative also see: http://docs.codehaus.org/display/MAVENUSER/Docbkx+Maven+Plugin David - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Using the Maven example project - goals to run customisation
On Fri, Aug 9, 2013, at 16:52, David Cramer wrote: On 08/09/2013 05:23 AM, gra...@heliocentrik.net wrote: This is exactly the workflow I'd like to replicate. What I'm confused about is which goals/targets to run to get it to actually do all this stuff. I've tried things like 'xml:transform', 'site' and so on, but it always seems to fail to actually download the stylesheets or transform the source files. Try: mvn clean generate-resources But as an alternative also see: http://docs.codehaus.org/display/MAVENUSER/Docbkx+Maven+Plugin David Thanks David, that works great. Graeme - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)
On Fri, August 9, 2013 11:19 am, Kerry, Richard wrote: ... I've tried to follow Ant's documentation regarding the xmlcatalog element but I can't get it to work. (I am finding the Ant documentation in this area extremely hard to follow) By can't get it to work I mean it doesn't find the files I'm trying to reference via the catalog. It doesn't show any messages indicating whether or not it is using the resolver, so I presume it isn't finding it. You should presume it is finding it: it gives a warning if you're using an external catalog and it can't find a resolver. Does anyone have any complete example of this working. Ie one that includes a reference to the resolver jar, and the classpath, and the catalog file and/or catalogManager.properties. When finding the resolver.jar fails when resolver.jar is referred to in xslt/@classpath, I usually just give up and put resolver.jar in Ant's own 'lib' directory. Regards, Tony Graham tgra...@mentea.net Consultant http://www.mentea.net Mentea 13 Kelly's Bay Beach, Skerries, Co. Dublin, Ireland -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- XML, XSL-FO and XSLT consulting, training and programming - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org