RE: [docbook-apps] Separated indices for webhelp & epub3 output

[Kerry, Richard]

When you asked "could someone customize", did you mean:

"will someone write this customization for me?"

Or did you mean

"is it possible to customize, and could someone advise how I might go about 
doing it?".

If it's the former case, then you should expect to have to pay someone.
If it's the latter, please clarify, and then someone might be able to advise 
you.


Regards,
Richard.


-Original Message-
From: Thomas Schmiedl  
Sent: 03 March 2021 17:53
To: Dave Pawson 
Cc: docbook-apps 
Subject: Re: [docbook-apps] Separated indices for webhelp & epub3 output

Caution! External email. Do not open attachments or click links, unless this 
email comes from a known sender and you know the content is safe.

I have no budget for this private project sorry.

Am 03.03.2021 um 17:53 schrieb Dave Pawson:
> What would you pay for this service Thomas?
>
> regards
>
> On Wed, 3 Mar 2021 at 16:52, Thomas Schmiedl  wrote:
>>
>> Hello,
>>
>> could someone customize the docbook-xsl stylesheets to support 
>> "index.on.type" (separated indices) for webhelp and epub3 output? I 
>> need it for a private project and I have very few xslt knowledge.
>>
>> Thanks for help,
>> Thomas
>>
>> -
>> To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
>> For additional commands, e-mail: 
>> docbook-apps-h...@lists.oasis-open.org
>>
>
>

-
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] Regarding URLs for NS and non-NS DocBook Stylesheets

[Kerry, Richard]

Please could the preceding message, from "Ron" be sent to the list, so 
subscribers can see what's being responded to here.

Regards,
Richard.


Richard Kerry
BNCS Engineer, SI SOL Telco & Media Vertical Practice

T: +44 (0)20 3618 2669
M: +44 (0)7812 325518
Lync: +44 (0) 20 3618 0778
Room G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.net




> -Original Message-
> From: Thomas Schraitle [mailto:tom_s...@web.de]
> Sent: Sunday, November 19, 2017 4:08 PM
> To: docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] Regarding URLs for NS and non-NS DocBook
> Stylesheets
>
> Hi Ron,
>
> Am Sonntag, 19. November 2017, 16:57:25 CET schrieben Sie:
> >
> > At the last chnage you get the namespace aware without the -ns bit.
> > as i remember you need something like -nons to get the no namespace
> > version [...]
>
> Oh right! :)
>
> So the meaning has been switched: in the SF case, the default was the non-
> NS version and you need the "xsl-ns" to get the NS variant.
>
> With the new CDN URL, it's just the opposite: the default is the NS variant
> and you need the "xsl-nons". That works:
>
>   http://cdn.docbook.org/release/xsl-nons/
>
> Great, thanks Ron!
>
>
> --
> Gruß/Regards
>   Thomas Schraitle
>
>
> -
> To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Atos, Atos Consulting, Worldline and Canopy The Open Cloud Company are trading 
names used by the Atos group. The following trading entities are registered in 
England and Wales: Atos IT Services UK Limited (registered number 01245534), 
Atos Consulting Limited (registered number 04312380), Atos Worldline UK Limited 
(registered number 08514184) and Canopy The Open Cloud Company Limited 
(registration number 08011902). The registered office for each is at 4 Triton 
Square, Regent’s Place, London, NW1 3HG.The VAT No. for each is: GB232327983.

This e-mail and the documents attached are confidential and intended solely for 
the addressee, and may contain confidential or privileged information. If you 
receive this e-mail in error, you are not authorised to copy, disclose, use or 
retain it. Please notify the sender immediately and delete this email from your 
systems. As emails may be intercepted, amended or lost, they are not secure. 
Atos therefore can accept no liability for any errors or their content. 
Although Atos endeavours to maintain a virus-free network, we do not warrant 
that this transmission is virus-free and can accept no liability for any 
damages resulting from any virus transmitted. The risks are deemed to be 
accepted by everyone who communicates with Atos by email.

-
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] Gradle build cross-platform - trouble with Saxon 6.5.5 params under Windows

[Kerry, Richard]

That’s exactly what I was going to suggest.  (ie passing the “-o” and the 
file-name as separate parameters).
Some time ago when I got Saxon 6.5.5 working from Ant that’s exactly what I had 
to do.
Saxon 9 takes “-o:file-name”, ie the colon means that it is a single keyword, 
where Saxon 6 makes it two “-o file-name”.

Regards,
Richard.



Richard Kerry
BNCS Engineer, SI SOL Telco & Media Vertical Practice

T: +44 (0)20 3618 2669
M: +44 (0)7812 325518
Lync: +44 (0) 20 3618 0778
Room G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.net

[cid:image002.png@01D311C2.D8BE3CB0]


From: Dominik Psenner [mailto:dpsen...@gmail.com]
Sent: Thursday, August 10, 2017 9:13 AM
To: DocBook Apps 
Subject: Re: [docbook-apps] Gradle build cross-platform - trouble with Saxon 
6.5.5 params under Windows



2017-08-10 8:30 GMT+02:00 Dave Pawson 
>:
Worth asking on the docbook-apps list Peter?

This is the docbooks-apps list, isn't it?

I use 2 for other parts, but for my main (quite large) docbook build I use 1.
  I use ant.
HTH

Peter, you could try giving "-o" and "myoutputfile.xml" as separate arguments. 
If you would build this with Go-Cd, it would require you to configure the build 
task arguments like this:

```
--some-other-arg
-o
myoutputfile.xml
```

and thus treating every line as a separate argument. Writing it like this would 
not work:

```
--some-other-arg
-o myoutputfile.xml
```

You could also try wrapping `myoutputfile.xml` in quotes.


On 10 August 2017 at 05:14, Peter Desjardins
> wrote:
> Hi! I have a working Gradle build system that transforms DocBook 5.1
> (using an assembly) to a few output mediums. I'm using Saxon 6.5.5 and
> the DocBook XSLT 1.0 stylesheets (latest version). When a new writer
> chose to use Windows, the Gradle build broke when she ran it locally.
>
> Problem #1 is that the Gradle exec task that assembles the DocBook
> assembly using Saxon 6.5.5 won't work under Windows. Saxon complains
> that there's "no output file name." Gradle has a terrible problem
> consuming the "-o myoutputfile.xml" argument.  If I present the "-o"
> argument separately, Saxon claims that the output file name is
> missing. If I present a "-o myoutputfile.xml" argument, Saxon
> complains that  "-o myoutputfile.xml" isn't a recognized argument. Has
> anyone built a Gradle Exec task that runs Saxon 6.5.5 on Windows? It
> works just fine on Linux and MacOS.
>
> Question #2 is: Has anyone had trouble using Saxon9HE with the DocBook
> XSLT v1.0 stylesheets? The way the arguments for the later version of
> Saxon are structured work much better with Gradle.
> (-o:myoutputfile.xml.)
>
> I'm considering switching to the DocBook XSLT 2.0 stylesheets to work
> around this problem. That avoids mixing Saxon9HE with the DocBook XSLT
> 1.0 stylesheets. Has anyone had any trouble migrating to XSLT 2.0?
>
> Thanks for your help!
>
> Peter
>
> -
> To unsubscribe, e-mail: 
> docbook-apps-unsubscr...@lists.oasis-open.org
> For additional commands, e-mail: 
> docbook-apps-h...@lists.oasis-open.org
>


--
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: 
docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: 
docbook-apps-h...@lists.oasis-open.org



--
Dominik Psenner
Atos, Atos Consulting, Worldline and Canopy The Open Cloud Company are trading 
names used by the Atos group. The following trading entities are registered in 
England and Wales: Atos IT Services UK Limited (registered number 01245534), 
Atos Consulting Limited (registered number 04312380), Atos Worldline UK Limited 
(registered number 08514184) and Canopy The Open Cloud Company Limited 
(registration number 08011902). The registered office for each is at 4 Triton 
Square, Regent’s Place, London, NW1 3HG.The VAT No. for each is: GB232327983.

This e-mail and the documents attached are confidential and intended solely for 
the addressee, and may contain confidential or privileged information. If you 
receive this e-mail in error, you are not authorised to copy, disclose, use or 
retain it. Please notify the sender immediately and delete this email from your 
systems. As emails may be intercepted, amended or lost, they are not secure. 
Atos therefore can accept no liability for any errors or their content. 
Although Atos endeavours to maintain a virus-free network, we do not warrant 
that this transmission is virus-free and can accept no liability for any 
damages 

[docbook-apps] Epub3 - epubcheck failing becase Mimetype entry must not have an extra field in its ZIP header

[Kerry, Richard]

It's quite a long time since I last tried out my docbook epub3 generation and 
on doing so now I am getting an error Mimetype entry must not have an extra 
field in its ZIP header from epubcheck (3.0.1).  Does anyone know how to get 
rid of it ?



I am using Ant (1.9.4) to do the processing, using its built-in zip task for 
the zipping (including Tony Graham's method [1] for ensuring the first item 
(only) is not compressed).  However it now appears that epubcheck is failing 
because there is some extra header information included that it doesn't want.



Can anyone advise how to tell Ant's zip task to get this data right (ie absent) 
?



Regards,

Richard.



PS

epubcheck 3.0b5 said Extra field length for first filename must be 0, but was 
20



[1]http://inasmuch.as/2010/12/10/ant-for-epub/



[Blue line]
Richard Kerry
BNCS Engineer, SI SOL Telco  Media Vertical Practice
T: +44 (0)20 3618 2669
M: +44 (0)7812 325518
G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net

[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitt


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] I have a title page - how about a back page ?

[Kerry, Richard]

Bo, Richard,
Thank you both for your suggestions.

I hadn't noticed back.cover but I think that sounds like the better option.  As 
Bob suggests it is boiler-plate with no differences between documents.
I think colophon requires docbook source so I'm not sure if I'd be able to 
force it in using a customization.

But  I've just seen Bob's last sentence - my document is an article so 
either I will need to make a boiler-plate colophon work, or somehow add 
back.cover to article.

I've got plenty of customization already.  I am working on a title page (or 
cover) which I am trying to get to mimic an existing design in Word.  Once I've 
got that settled I'll do a back page to look similar.

Appreciatively,
Richard.



Richard Kerry
BNCS Engineer, SI SOL Telco  Media Vertical Practice

T: +44 (0)20 3618 2669 
M: +44 (0)7812 325518
Lync: +44 (0) 20 3618 0778
Room G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.net
 



-Original Message-
From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: Saturday, June 07, 2014 1:00 AM
To: Richard Hamilton; Kerry, Richard
Cc: DocBook Apps Mailing List [docbook-apps@lists.oasis-open.org]
Subject: Re: [docbook-apps] I have a title page - how about a back page ?

Another option is to use the placeholder template named 'back.cover'.
It is empty by default, and called by the book template after all the book's 
content. This option would be appropriate if the back page is boilerplate whose 
content is not necessarily in the document itself. 
The template could, of course, draw on parts of the content of the document 
using XPath.

If your document is an article and not a book, then colophon is the only 
choice, because the article template does not call the 'back.cover' 
template.

Bob Stayton
Sagehill Enterprises
b...@sagehill.net

On 6/6/2014 10:19 AM, Richard Hamilton wrote:
 Hi Richard,

 I'd use colophon. A colophon doesn't normally create a TOC entry, and 
 it is normally placed at the end of the book. You'll probably need to 
 do some customizing of the stylesheets to get it to look like you 
 want, but you'd need to do that regardless.

 Best regards, Dick Hamilton --- XML Press XML for Technical 
 Communicators http://xmlpress.net hamil...@xmlpress.net



 On Jun 6, 2014, at 6:43 AM, Kerry, Richard wrote:


 I can see from Bob's book that Docbook and the stylesheets provide a 
 mechanism I can use to get a decorated title page, but at the moment 
 my result PDF document ends straight after all the sections and the 
 appendix. I would like to have another page to finish off.
 It will be decorated a bit like my title page is, and have a little 
 company information.

 But, I can't see anything built in to docbook and the stylesheets 
 that looks like the way to get me a page at the end of the document.

 Can anyone advise me how I might do this ?



 Regards, Richard.



 Richard Kerry BNCS Engineer, SI SOL Telco  Media Vertical Practice 
 T: +44 (0)20 3618 2669 M: +44 (0)7812 325518 G300, Stadium House, 
 Wood Lane, London, W12 7TA richard.ke...@atos.net






 This e-mail and the documents attached are confidential and intended 
 solely for the addressee; it may also be privileged. If you receive 
 this e-mail in error, please notify the sender immediately and 
 destroy it. As its integrity cannot be secured on the Internet, the 
 Atos group liability cannot be triggered for the message content. 
 Although the sender endeavours to maintain a computer virus-free 
 network, the sender does not warrant that this transmission is 
 virus-free and will not be liable for any damages resulting from any 
 virus transmitt




 
 -


To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
 For additional commands, e-mail:
 docbook-apps-h...@lists.oasis-open.org





 -


To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
 For additional commands, e-mail:
 docbook-apps-h...@lists.oasis-open.org

-
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] I have a title page - how about a back page ?

[Kerry, Richard]

I can see from Bob's book that Docbook and the stylesheets provide a mechanism 
I can use to get a decorated title page, but at the moment my result PDF 
document ends straight after all the sections and the appendix.

I would like to have another page to finish off.  It will be decorated a bit 
like my title page is, and have a little company information.



But, I can't see anything built in to docbook and the stylesheets that looks 
like the way to get me a page at the end of the document.



Can anyone advise me how I might do this ?







Regards,

Richard.






[Blue line]
Richard Kerry
BNCS Engineer, SI SOL Telco  Media Vertical Practice
T: +44 (0)20 3618 
2669[cid:644C5B3-9FF9-41F22-98C2-E1A7E312F0@MimeCtl]thismessage:/Body.htm#
M: +44 (0)7812 
325518[cid:644C5B3-9FF9-41F22-98C2-E1A7E312F0@MimeCtl]thismessage:/Body.htm#
G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net

[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitt


attachment.ashx
Description: attachment.ashx


BsAt4ube4GblQIASUVORK5CYII=
Description: BsAt4ube4GblQIASUVORK5CYII=


attachment.ashx
Description: attachment.ashx

-
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] Docbook to epub - Extra field length for first filename must be 0, but was ..

[Kerry, Richard]

If I've understood correctly, you're having trouble getting the zip part of the 
process working.



I have the basic process for generating epub via Ant working fine.

An earlier query on this list (14/6/2013) was replied to by tony Graham, who 
pointed me at his article

http://inasmuch.as/2010/12/10/ant-for-epub/



The following target is from my Ant file.



  target name=zip-epub
description=Package up an EPUB
depends=image-list-copy

 !-- The 'mimetype' file is supposed to be uncompressed and the first thing in 
the .epub file so the file conforms to the (rather long) signature for EPUB 
files. --
 zip destfile=${output-dir}/${name-root}.mimetype
   compress=false
   encoding=UTF-8
   fileset dir=${output-dir}/${name-root} includes=mimetype /
 /zip
 !-- We'd really rather have the rest compressed, thank you. --
 zip destfile=${output-dir}/${name-root}.zip
   compress=true
   encoding=UTF-8
   level=9
   zipfileset dir=${output-dir}/${name-root}/META-INF prefix=META-INF/
   zipfileset dir=${output-dir}/${name-root}/OEBPS prefix=OEBPS/
 /zip
 !-- Putting them together this way is the best way so far found for getting 
only 'mimetype' uncompressed in the .epub. --
 zip destfile=${output-dir}/${name-root}.epub
   update=true
   keepcompression=true
   encoding=UTF-8
   zipfileset src=${output-dir}/${name-root}.mimetype /
   zipfileset src=${output-dir}/${name-root}.zip /
 /zip
  /target



Hope that helps, and apologies if I've misunderstood the fault you're seeing.

Regards,

Richard.





PS.

I said the basic process is working as I do still have a recurring fault, 
though I seem to recall it's actually just a warning.  I need to handle a 
selection of different date string formats for version histories, but epub 
wants one format (ISO I think) so I'll need to pass them into EXSLT to get them 
sorted.











Richard Kerry
BNCS Engineer, SI SOL Telco  Media Vertical Practice
T: +44 (0)20 3618 2669
M: +44 (0)7812 325518
G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.netmailto:richard.ke...@atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitt

From: cordb...@gmail.com [cordb...@gmail.com] on behalf of Nils Cordes 
[i...@nilscordes.de]
Sent: 18 February 2014 11:15
To: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Docbook to epub - Extra field length for first 
filename must be 0, but was ..

Hi,

I'm running Ant inside Eclipse and don't get the validation error.
Maybe the cause for the issue is the filesystem used to create the zip-file, 
because filesystems other than EFS add the additional metadata, which raises 
the validation error Extra field length for first filename must be 0, but was 
20.

Nils



2014-02-18 8:24 GMT+01:00 Michael Wiedmann 
m...@miwie.in-berlin.demailto:m...@miwie.in-berlin.de:
Lars Vogel wrote o 2014-02-17:
...
 I read in Bobs description for epub3 (
 http://sourceforge.net/projects/docbook/files/epub3/) that I need to
 specify -X for the Ant task to avoid this error. Is this something I can do
 with the Apache Ant task?

I could not find any way to use the ant zip task to generate a valid
epub file due to the missing -X option (if anybody knows how to do it
coorrect please let us know).

Workaround might be to use ant's exec task :-(

Michael



-
To unsubscribe, e-mail: 
docbook-apps-unsubscr...@lists.oasis-open.orgmailto:docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: 
docbook-apps-h...@lists.oasis-open.orgmailto:docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] Error processing DocBook assemblies with XProc (Calabash): There is no Saxon extension function with the local name node-set

[Kerry, Richard]

Saxon 6 is still available as an XSLT 1.0 processor.
It seems to work OK for me.


Regards,
Richard.




-Original Message-
From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: Wednesday, November 20, 2013 10:29 PM
To: gra...@heliocentrik.net; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Error processing DocBook assemblies with XProc 
(Calabash): There is no Saxon extension function with the local name node-set


Hi Graeme,
The DocBook XSL stylesheets are written for XSLT 1.0, and Saxon 9 (HE or
EE) is a XSLT 2.0 processor.  The 1.0 DocBook stylesheets do not work 
reliably with Saxon 9, even with the backwards compatibility mode.   All 
the XSLT 1.0 processors now support the EXSLT  functions, so that dependency 
has not generally been a problem.  There is a separate effort to develop 
DocBook stylesheets for XSLT 2.0, but I don't think it has stylesheets for 
assembly yet. Sorry.

-- 
Bob Stayton
Sagehill Enterprises
b...@sagehill.net


On 11/20/2013 9:02 AM, gra...@heliocentrik.net wrote:
 Sorry folks, one more detail: I also tried the XPL workflow in both
 calabash-1.0.15-95 and calabash-1.0.15-94 to see if the issue was caused
 by the version of Saxon I'm using.

 I read somewhere that Saxon HE doesn't support the EXSLT extension
 functions, so I tried to select EE by adding the '-P he' flag. That
 didn't make any difference.

 Do the DocBook stylesheets really require the EXSLT extension functions?
 If so, is there a workaround to be able to use them with Saxon-HE? I
 don't have EE and don't have an easy way of obtaining it.

 Thanks,

 Graeme

 On Wed, Nov 20, 2013, at 12:03, gra...@heliocentrik.net wrote:
 Hi there,
 I'm not quite sure whether this is a DocBook question or a
 Calabash/XProc one, but given that there's a substantial overlap between
 the developers and users of both, hopefully someone will be able to
 answer it here.

 I'm processing DocBook 5.1 assembly files with the DocBook namespace
 stylesheets version 1.78.0. Using Saxon 8.7 and the
 'assembly/assemble.xsl' stylesheet, I can turn my assemblies into
 'consolidated' DocBook articles, books (or whatever).

 However, when I apply the same XSLT transformation using Calabash XProc,
 I get the following error:

 calabash -D --input
 source=file:/Users/graeme/git/ncr/documentation/projects/project.xml
 doc-generate.xpl
 Nov 20, 2013 11:42:05 AM
 com.xmlcalabash.util.DefaultXProcMessageListener error
 SEVERE:
 file:/Users/graeme/git/ncr/documentation/target/generated-resources/docbook/assembly/assemble.xsl:552:err:XTDE1425:Cannot
 find a matching 1-argument function named
 {http://exslt.org/common}node-set(). There is no Saxon extension
 function with the local name node-set
 Nov 20, 2013 11:42:05 AM
 com.xmlcalabash.util.DefaultXProcMessageListener error
 SEVERE: Cannot find a matching 1-argument function named
 {http://exslt.org/common}node-set(). There is no Saxon extension
 function with the local name node-set
 Nov 20, 2013 11:42:05 AM com.xmlcalabash.drivers.Main error
 SEVERE: Pipeline failed: net.sf.saxon.s9api.SaxonApiException: Cannot
 find a matching 1-argument function named
 {http://exslt.org/common}node-set(). There is no Saxon extension
 function with the local name node-set
 Nov 20, 2013 11:42:05 AM com.xmlcalabash.drivers.Main error
 SEVERE: Underlying exception: net.sf.saxon.trans.XPathException: Cannot
 find a matching 1-argument function named
 {http://exslt.org/common}node-set(). There is no Saxon extension
 function with the local name node-set
 net.sf.saxon.s9api.SaxonApiException: Cannot find a matching 1-argument
 function named {http://exslt.org/common}node-set(). There is no Saxon
 extension function with the local name node-set
  at
  net.sf.saxon.s9api.XsltTransformer.transform(XsltTransformer.java:433)
  at com.xmlcalabash.library.XSLT.run(Unknown Source)
  at com.xmlcalabash.runtime.XAtomicStep.run(Unknown Source)
  at com.xmlcalabash.runtime.XForEach.run(Unknown Source)
  at com.xmlcalabash.runtime.XForEach.run(Unknown Source)
  at com.xmlcalabash.runtime.XPipeline.doRun(Unknown Source)
  at com.xmlcalabash.runtime.XPipeline.run(Unknown Source)
  at com.xmlcalabash.drivers.Main.run(Unknown Source)
  at com.xmlcalabash.drivers.Main.main(Unknown Source)
 Caused by: net.sf.saxon.trans.XPathException: Cannot find a matching
 1-argument function named {http://exslt.org/common}node-set(). There is
 no Saxon extension function with the local name node-set
  at
  net.sf.saxon.expr.ErrorExpression.evaluateItem(ErrorExpression.java:66)
  at
  net.sf.saxon.expr.ErrorExpression.iterate(ErrorExpression.java:80)
  at net.sf.saxon.expr.ItemChecker.iterate(ItemChecker.java:157)
  at
  net.sf.saxon.expr.SlashExpression.iterate(SlashExpression.java:700)
  at
  net.sf.saxon.expr.SlashExpression.iterate(SlashExpression.java:700)
  at
  net.sf.saxon.expr.sort.DocumentSorter.iterate(DocumentSorter.java:101)
  at 

RE: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)

[Kerry, Richard]

I'm still not getting this working.

Please can someone who's had it working tell me how to do the following :



1.  The syntax for the catalog spec.

Ive tried this :



  xmlcatalog id=docbook-catalog 
 catalogpath
   pathelement location=${catmanpath}/CatalogManager.properties/
 /catalogpath
  /xmlcatalog

and something similar with the Catalog.xml in the pathelement, though neither 
is sufficient to make it work.



2.  The syntax for specifying the stylesheet.

I'm currently using :



   style
  url url=file://profiling/profile.xsl /
   /style

This seems to make the processing take some time (8 to 10 seconds) where any 
other number of slashes makes it near-instantaneous, so I'm assuming that's at 
least trying to do something, even if it gets the result wrong.



3.  The Ant docs say resolver.jar needs to be in the system classpath.  I 
haven't consciously got one of those, but within the project I do have a 
path id=classpath (as copied from the version provided in the standard 
stylesheets).  Is that what's meant ?

I have also tried a classpath within the xslt, but the Ant docs say that's 
just used to look-up the xslt processor.  The build.xml from the standard 
stylesheets doesn't specify this for the profiling pass so I presume that makes 
it use its default.  But is this where I need also to tell it where the 
resolver lives ?



Uncertainly,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer, SI SOL Telco  Media Vertical Practice
T: +44 (0)20 82259063[X]thismessage:/Body.htm#
M: +44 (0)7812 325518[X]thismessage:/Body.htm#
G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net

[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitte

From: Kerry, Richard [richard.ke...@atos.net]
Sent: 14 August 2013 11:44
To: docbook-apps@lists.oasis-open.org
Subject: RE: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request 
for example (using for DocBook/WebHelp)



I've got that (though as a literal param rather than in ANT_OPTS), which is how 
I can say It doesn't show any messages .
Including absence of any reference to the resolver.


Uncertainly,
Richard.




-Original Message-
From: Olsen, Morten Engelhardt [mailto:morten_engelhardt.ol...@atmel.com]
Sent: Friday, August 09, 2013 9:37 PM
To: docbook-apps@lists.oasis-open.org
Subject: RE: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request 
for example (using for DocBook/WebHelp)


Also, running ant with the environment variable ANT_OPTS=-d would enable debug 
logging to the console. The resolver should then be possible to spot...

 :: Morten


-Original Message-
From: Tony Graham [mailto:tgra...@mentea.net]
Sent: 9. august 2013 18:04
To: docbook-apps@lists.oasis-open.org
Subject: 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.nethttp://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

RE: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)

[Kerry, Richard]

If I'm understanding the original post correctly, you want to use catalogs so 
that ANT will resolve the location of the stylesheet specified in ant's xslt/ 
task from the catalog

That's correct.



I don't know if ant can do that I only ever used ant+catalog files to 
resolve dtds and stylesheet locations specified in xsl:imports

Interesting point.

The Ant docs say This task supports the use of a nested xmlcatalog element 
which is used to perform Entity and URI resolution, which does not seem to 
explicitly include or exclude the use of the catalog to find the style file.

In Saxon I do a mixture.  The initial (ie customization) stylesheets are 
looked-up using a catalog, then the standard stylesheets are xsl:import'ed 
again via a catalog lookup.  Within those the file locations are relative paths.

My catalog has two group elements.  One is for the locations of the 
customization stylesheets; the other is for the standard stylesheets.



I'm seeking to do this as it's what my existing Saxon-based transformations do, 
so I assumed Ant would be able to do so too.  I have asked on the Ant 
mailing-list, and have just received a reply indicating that I may need to 
start delving into the Java code to sort out exactly what's going on.  As a C++ 
programmer Java looks quite familiar, but I have no experience of actually 
working on it.





Uncertainly,

Richard.



Richard Kerry
BNCS Engineer, SI SOL Telco  Media Vertical Practice
T: +44 (0)20 82259063 (to change shortly...)
M: +44 (0)7812 325518
G300, Stadium House, Wood Lane, London, W12 7TA
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitte

From: David Cramer [da...@thingbag.net]
Sent: 16 August 2013 14:16
To: Kerry, Richard
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request 
for example (using for DocBook/WebHelp)


On 08/16/2013 05:45 AM, Kerry, Richard wrote:
 I'm still not getting this working.

If I'm understanding the original post correctly, you want to use
catalogs so that ANT will resolve the location of the stylesheet
specified in ant's xslt/ task from the catalog. I don't know if ant
can do that, though I've never tried. I only ever used ant+catalog files
to resolve dtds and stylesheet locations specified in xsl:imports. It'd
be worth asking on an ant list or looking at the code for the xslt task
to see if it even supports that.

If you ever do get it working, be sure to let us know. It would be a
convenient thing to have.

Regards,
David

RE: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)

[Kerry, Richard]

I've got that (though as a literal param rather than in ANT_OPTS), which is how 
I can say It doesn't show any messages .
Including absence of any reference to the resolver.


Uncertainly,
Richard.




-Original Message-
From: Olsen, Morten Engelhardt [mailto:morten_engelhardt.ol...@atmel.com] 
Sent: Friday, August 09, 2013 9:37 PM
To: docbook-apps@lists.oasis-open.org
Subject: RE: [docbook-apps] Use of XML Catalog with Ant (xslt task) - request 
for example (using for DocBook/WebHelp)


Also, running ant with the environment variable ANT_OPTS=-d would enable debug 
logging to the console. The resolver should then be possible to spot...

 :: Morten


-Original Message-
From: Tony Graham [mailto:tgra...@mentea.net]
Sent: 9. august 2013 18:04
To: docbook-apps@lists.oasis-open.org
Subject: 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


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

-
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] Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)

[Kerry, Richard]

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] RE: Use of XML Catalog with Ant (xslt task) - request for example (using for DocBook/WebHelp)

[Kerry, Richard]

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] A Complex Title Page - which method to use ?

[Kerry, Richard]

Peter,

Thanks for responding.  Sorry not to respond sooner but I haven't had a chance 
to look at this until now.



It sounds like you're already customizing article.titlepage.recto to add your 
page break.  No I'm not - well, I suppose I am but I'm not doing so directly.  
I'm still using the titlepage customization system.  I've added the page break 
by adding fo:block break-after=page/ to t:titlepage-separator within the 
article titlepage template.



I haven't (yet) moved away from using the titlepage system.  What I'd like to 
find out is if I can insert fo:block elements while using the titlepage system. 
 Or whether that's the cue that it is time to change system and start 
generating the actual title-page directly.



Appreciatively,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063[X]thismessage:/Body.htm#
M: +44 (0)7812 325518[X]thismessage:/Body.htm#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Peter Desjardins [peter.desjardins...@gmail.com]
Sent: 14 June 2013 17:04
To: Kerry, Richard
Cc: DocBook Apps Mailing List [docbook-apps@lists.oasis-open.org]
Subject: Re: [docbook-apps] A Complex Title Page - which method to use ?

I'm using a slightly complex title page for a book right now. I'm customizing 
the book.titlepage.recto template and adding FO elements as needed.

It sounds like you're already customizing article.titlepage.recto to add your 
page break. Can you add more FO to get the decoration you need?

Here's what I'm doing to the book titlepage. I was just playing around with FO 
blocks and attributes until it looked right. I used 
http://www.w3schools.com/xslfo/xslfo_reference.asp and a few other FO 
references that I found.

  xsl:template name=book.titlepage.recto
xsl:element name=fo:block
xsl:attribute name=margin-top.5in/xsl:attribute
xsl:element name =fo:external-graphic
xsl:attribute name=content-height1in/xsl:attribute
xsl:attribute name=src
xsl:texturl(../mylogo.svg)/xsl:text
/xsl:attribute
/xsl:element
/xsl:element
xsl:element name=fo:block
xsl:attribute 
name=background-imageurl(../mygraphic.png)/xsl:attribute
xsl:attribute name=space-before2.25in/xsl:attribute
xsl:attribute name=margin-right-1in/xsl:attribute
xsl:attribute name=padding10pt/xsl:attribute
xsl:attribute name=colorwhite/xsl:attribute
xsl:attribute name=text-alignleft/xsl:attribute
xsl:attribute name=font-size20pt/xsl:attribute
xsl:attribute name=font-familyDINComp/xsl:attribute
xsl:attribute name=font-weight600/xsl:attribute
xsl:value-of select=//d:book/d:info/d:title /
!-- xsl:call-template name=stock.docbook.book.titlepage / --
xsl:element name=fo:block
xsl:attribute name=space-before4.1in/xsl:attribute
/xsl:element
/xsl:element
/xsl:template

Good luck!

Peter


On Fri, Jun 14, 2013 at 6:08 AM, Kerry, Richard 
richard.ke...@atos.netmailto:richard.ke...@atos.net wrote:



For my project I want to produce a title page that is a little more complex 
than I think I can achieve using the standard title page customization system 
(as descried in http://www.sagehill.net/docbookxsl/HTMLTitlePage.html).



I've used title page customization and set margins to put the main title in the 
middle of the page and add a page-break after the title-page (it's an article 
so doesn't get one by default).





Now I'd like to add a bit more decoration :

- A coloured block down the left side of the page

- A header area with an outline, and containing some text and a logo or two.



It should look a lot like this (sample title-page cover.png - if you don't 
get it appearing here it's attached):



[cid:5b5b102b-1c41-45ab-b401-5b64b5e24601]



I can see from Table 13.3 
http://www.sagehill.net/docbookxsl/TitlePagePrint.html#TitlePageCustomizationGuide
 that there may be a number of different ways of achieving this.

I'm not entirely

[docbook-apps] Epub3 - Use of Ant's zip task - ensuring file order follows the rules

[Kerry, Richard]

Does anyone have experience of building epub3 from Docbook using Ant ?

In particular the use of Ant's zip task.



One of the rules for epub3 is that the mimetype file comes first.  It appears 
that this can't be enforced using Ant's zip task.  Does anyone know if there is 
any way of making this work ?  Or do I need to call out to an external 
application ?  (ie infozip's zip.exe.  7-zip doesn't appear to do it either).





Regards,

Richard.









Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

[docbook-apps] A Complex Title Page - which method to use ?

[Kerry, Richard]

For my project I want to produce a title page that is a little more complex 
than I think I can achieve using the standard title page customization system 
(as descried in http://www.sagehill.net/docbookxsl/HTMLTitlePage.html).



I've used title page customization and set margins to put the main title in the 
middle of the page and add a page-break after the title-page (it's an article 
so doesn't get one by default).





Now I'd like to add a bit more decoration :

- A coloured block down the left side of the page

- A header area with an outline, and containing some text and a logo or two.



It should look a lot like this (sample title-page cover.png - if you don't 
get it appearing here it's attached):



[cid:5b5b102b-1c41-45ab-b401-5b64b5e24601]



I can see from Table 13.3 
http://www.sagehill.net/docbookxsl/TitlePagePrint.html#TitlePageCustomizationGuide
 that there may be a number of different ways of achieving this.

I'm not entirely clear which of these methods I need to follow.  I think it is 
too much to do with the titlepage customization system, but it is still a 
title page not a book cover.

Can anyone advise which direction I should be going in.  I can't spend too much 
time doing this so don't want to start off on the wrong track.











Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable
inline: sample title-page cover.pngattachment: sample title-page cover.png
-
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] Epub3 - Use of Ant's zip task - ensuring file order follows the rules

[Kerry, Richard]

Tony (and Morten),



Thanks for this.

I can now generate my epub from Ant.





Regards,

Richard.







Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Tony Graham [tgra...@mentea.net]
Sent: 14 June 2013 11:09
To: DocBook Apps Mailing List ý[docbook-apps@lists.oasis-open.org]ý
Subject: Re: [docbook-apps] Epub3 - Use of Ant's zip task - ensuring file order 
follows the rules


On Fri, June 14, 2013 11:00 am, Kerry, Richard wrote:
 Does anyone have experience of building epub3 from Docbook using Ant ?

 In particular the use of Ant's zip task.

 One of the rules for epub3 is that the mimetype file comes first.  It
 appears that this can't be enforced using Ant's zip task.  Does anyone
 know if there is any way of making this work ?  Or do I need to call out
 to an external application ?  (ie infozip's zip.exe.  7-zip doesn't appear
 to do it either).

Zip the mimetype file uncompressed, then add the other files to the Zip
file.  See http://inasmuch.as/2010/12/10/ant-for-epub/

Regards,


Tony Graham   tgra...@mentea.net
Consultant 
http://www.mentea.nethttp://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

RE: [docbook-apps] RE: HtmlHelp/CHM - Revision History+generate.revhistory.link - not visible in output

[Kerry, Richard]

I've now tried this and it is working as I would expect.

(I've copied the snapshot version of html/chunk-code.xsl to my 1.78 folder.)

A suitable entry is now being put into the hhp file and the resulting chm is 
showing the extra page as required.





Appreciatively,

Richard.





Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Kerry, Richard [richard.ke...@atos.net]
Sent: 29 May 2013 12:21
To: Jirka Kosek; DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎
Subject: RE: [docbook-apps] RE: HtmlHelp/CHM - Revision 
History+generate.revhistory.link - not visible in output



Jirka,

Thank you very much for looking at this.
I shall try it out when I am next working in the area.

How long does it take for the automatic build to happen and work to appear in 
the snapshots (roughly) ?


Regards,
Richard.



 -Original Message-
 From: Jirka Kosek [mailto:ji...@kosek.cz]
 Sent: 24 May 2013 14:44
 To: Kerry, Richard
 Cc: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
 Subject: Re: [docbook-apps] RE: HtmlHelp/CHM - Revision
 History+generate.revhistory.link - not visible in output

 On 24.5.2013 11:33, Kerry, Richard wrote:

  Looking in htmlhelp-common.xsl I can see the code that
 generates the [FILES] section.  Though I can't follow how it
 works in full.
 
  I would appreciate it if someone familiar with this process
 could explain how it works, and preferably provide a fix.

 I have fixed issue in sources, in a while change should be propagated
 into an automatic build and you can give it a try:

 http://snapshots.docbook.org/

 --
 --
   Jirka Kosek  e-mail: ji...@kosek.cz  
 http://xmlguru.czhttp://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 conference
 http://xmlprague.czhttp://xmlprague.cz/
 --


-
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: HtmlHelp/CHM - Revision History+generate.revhistory.link - not visible in output

[Kerry, Richard]

So I may be the only person using HtmlHelp and the generate.revhistory.link and 
seeking to customize the resulting revhistory html page .



And leaving aside the issue of exactly what the (very old and badly documented) 
MS Help Compiler is doing, and why it sort of works even if its input appears 
not to be correct .



There would appear to be a fault in the default stylesheets for html-help 
generation.  If generate.revhistory.link is set, although the rh-prefixed html 
file is generated, no reference to the generated revhistory html file is 
generated in the [FILES] section in the hhp file.



Looking in htmlhelp-common.xsl I can see the code that generates the [FILES] 
section.  Though I can't follow how it works in full.

I would appreciate it if someone familiar with this process could explain how 
it works, and preferably provide a fix.



Once the process is fixed I can resume customizing the html.





Regards,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063[X]thismessage:/Body.htm#
M: +44 (0)7812 325518[X]thismessage:/Body.htm#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Kerry, Richard [richard.ke...@atos.net]
Sent: 20 May 2013 14:22
To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: [docbook-apps] HtmlHelp/CHM - Revision 
History+generate.revhistory.link - not visible in output




I'm looking at the CHM/HtmlHelp output from my project.  (Using Saxon-6, 
Microsoft Html Help Compiler, and Ant to call them both)

I want to customize how the Revision History is displayed.  I would like to be 
able to show it linked from the title-page, using generate.revhistory.link.



If I copy the d:revhistory and d:revhistory/d:revision templates from 
html/block.xsl I can customize them with no problem.  However, that is relevant 
to in-line revision histories, ie within a section.  I would like to have 
the Revision History available linked from the title page, but in another page, 
which should be achievable using generate.revhistory.link.



However, if I copy the d:revhistory and d:revhistory/d:revision templates for 
mode=titlepage.mode from html/titlepage.xsl I start getting problems.  (Note 
that at this stage I've made no changes to those templates so that can't be 
what's causing the problem)



The first problem I noticed was that merely copying the relevant templates out 
of the default stylesheet file and into my customization stylesheet file would 
break the result.  The Revision History link is available on the title page, 
but clicking it gives me a page This program cannot display the webpage.  By 
looking at the html produced by the DocBook-Xsl transformation I know that a 
page with the Revision History has been generated, named rh-something.html.  
However, it is not referenced by the .hhp file, which should list all the html 
files, shouldn't it ?   (It does list all the other html files)

That was where I'd got to last week.  Today I sat down to look at it again and 
I am now even more puzzled.

The .hhp file never contains a reference to the rh file !

Whether or not the resulting chm works there is no rh-something.html file 
listed in the .hhp file that has been produced by the DocBook stylesheets.

If I manually add the rh file, as generated by the transform, to the list in 
the hhp file, it then works.

Unfortunately I can't find any reference documentation for the Html Help 
Compiler (which is very old, and twice superseded.) so I can't see whether 
it should contain some built-in rules for finding pages which aren't listed.



So, does anyone know :



1.  Why it works when not customized, despite the rh file not being listed in 
the hhp ?

2.  How the DocBook-XSL system is supposed to work for HtmlHelp; specifically 
the generation of the .hhp file and the writing of the reference for the 
rh-something file into the hhp.





Puzzledly,

Richard.







Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063[X]thismessage:/Body.htm#
M: +44 (0)7812 325518[X]thismessage:/Body.htm#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke

[docbook-apps] HtmlHelp/CHM - Revision History+generate.revhistory.link - not visible in output

[Kerry, Richard]

I'm looking at the CHM/HtmlHelp output from my project.  (Using Saxon-6, 
Microsoft Html Help Compiler, and Ant to call them both)

I want to customize how the Revision History is displayed.  I would like to be 
able to show it linked from the title-page, using generate.revhistory.link.



If I copy the d:revhistory and d:revhistory/d:revision templates from 
html/block.xsl I can customize them with no problem.  However, that is relevant 
to in-line revision histories, ie within a section.  I would like to have 
the Revision History available linked from the title page, but in another page, 
which should be achievable using generate.revhistory.link.



However, if I copy the d:revhistory and d:revhistory/d:revision templates for 
mode=titlepage.mode from html/titlepage.xsl I start getting problems.  (Note 
that at this stage I've made no changes to those templates so that can't be 
what's causing the problem)



The first problem I noticed was that merely copying the relevant templates out 
of the default stylesheet file and into my customization stylesheet file would 
break the result.  The Revision History link is available on the title page, 
but clicking it gives me a page This program cannot display the webpage.  By 
looking at the html produced by the DocBook-Xsl transformation I know that a 
page with the Revision History has been generated, named rh-something.html.  
However, it is not referenced by the .hhp file, which should list all the html 
files, shouldn't it ?   (It does list all the other html files)

That was where I'd got to last week.  Today I sat down to look at it again and 
I am now even more puzzled.

The .hhp file never contains a reference to the rh file !

Whether or not the resulting chm works there is no rh-something.html file 
listed in the .hhp file that has been produced by the DocBook stylesheets.

If I manually add the rh file, as generated by the transform, to the list in 
the hhp file, it then works.

Unfortunately I can't find any reference documentation for the Html Help 
Compiler (which is very old, and twice superseded.) so I can't see whether 
it should contain some built-in rules for finding pages which aren't listed.



So, does anyone know :



1.  Why it works when not customized, despite the rh file not being listed in 
the hhp ?

2.  How the DocBook-XSL system is supposed to work for HtmlHelp; specifically 
the generation of the .hhp file and the writing of the reference for the 
rh-something file into the hhp.





Puzzledly,

Richard.







Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

[docbook-apps] Box around the footer (re-post with images attached)

[Kerry, Richard]

Ok - retrying this.  The images may appear in-line but I've attached the files 
in case they don't.

And I've added descriptions in case they still don't appear.



I've managed to get a border around my document's footer, using foot.sep.rule.

However, it isn't spaced how I want it and I can't get it to change in the way 
I want.



I'm trying to get (word footer.png):



[X]


The image shows a number of text items in the footer.  There is a box around 
all of them.
There is a space of a few millimetres/pixels (Looks like about 1mm) between the 
top of the text and the top line.
There is a slightly wider space between the right and left edges of the text 
and their respective border lines.
There is a gap between the bottom of the text and the bottom border line of 
roughly the height of one line of text.


but I'm getting (pdf footer.png):


[X]


There is a space of a few millimetres/pixels (Looks like about 2mm this time) 
between the top of the text and the top border line.
There is no significant space between the right and left edges of the text and 
their respective border lines (less than 1mm).
There is a space of a few millimetres/pixels (Looks like about 2mm this time) 
between the bottom of the text and the bottom border line.

(don't they say a picture is worth a thousand words - I reckon I've written 
about 150 here)

Note the lack of spacing at both left and right edges. Also the requirement for 
roughly one text line below the text showing here (some documents will have 
some text there).

I seem to get some effect by customizing footer.content.properties - that's how 
I've got the text to be grey.
However I don't seem to get any useful effect from the padding attributes, 
which are the ones I'd expect to need to use for this.
If I set padding I seem to get some padding added at the left edge, but not 
the other three. Even if I set all four of padding-left/right/top/bottom I only 
get space added at the left.

Can anyone advise what I need to do to get padding at right, left and bottom ?

I'm doing DocBook - FO and then to PDF using FOP 1.1.

Regards,
Richard.
















[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable
attachment: pdf footer.pngattachment: word footer.png
-
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] Box around the footer

[Kerry, Richard]

I've managed to get a border around my document's footer, using foot.sep.rule.

However, it isn't spaced how I want it and I can't get it to change in the way 
I want.



I'm trying to get :



[https://webmail.siemens-it-solutions.com/OWA/attachment.ashx?id=RgDuafvq2wn5ToY5TFygcdi1BwAxjteD9W0ARqkWij6loXgaAQlZAABhxn3HMwi9SbLUtlBySA26AAAVOvmVAAAJattcnt=1attid0=EACLf%2bZZePPtSaIp6eKC8ubYattcid0=7716d0a4-6acd-4cd0-af75-6cdb428b6975]


but I'm getting :


[https://webmail.siemens-it-solutions.com/OWA/attachment.ashx?id=RgDuafvq2wn5ToY5TFygcdi1BwAxjteD9W0ARqkWij6loXgaAQlZAABhxn3HMwi9SbLUtlBySA26AAAVOvmVAAAJattcnt=1attid0=EAAuTDbeBlA9QYoLDLUMY1bpattcid0=a154a93e-4a37-4e49-b724-a60be5177ece]

Note the lack of spacing at both left and right edges. Also the requirement for 
roughly one text line below the text showing here (some documents will have 
some text there).

I seem to get some effect by customizing footer.content.properties - that's how 
I've got the text to be grey.
However I don't seem to get any useful effect from the padding attributes, 
which are the ones I'd expect to need to use for this.
If I set padding I seem to get some padding added at the left edge, but not 
the other three. Even if I set all four of padding-left/right/top/bottom I only 
get space added at the left.

Can anyone advise what I need to do to get padding at right, left and bottom ?

I'm doing DocBook - FO and then to PDF using FOP 1.1.

Regards,
Richard.





[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

[docbook-apps] RE: Box around the footer

[Kerry, Richard]

I don't know what everyone else is seeing in this message 

One one client (Outlook) I'm getting little red Xs telling me the image is not 
available.

On the other (webmail, using IE 9) I can see the images as I thought I was 
sending them.



If they haven't come through please let me know and I'll find some other way of 
sending them.





Uncertainly,

Richard.





Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Kerry, Richard [richard.ke...@atos.net]
Sent: 14 May 2013 17:12
To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: [docbook-apps] Box around the footer




I've managed to get a border around my document's footer, using foot.sep.rule.

However, it isn't spaced how I want it and I can't get it to change in the way 
I want.



I'm trying to get :



[X]


but I'm getting :


[X]

Note the lack of spacing at both left and right edges. Also the requirement for 
roughly one text line below the text showing here (some documents will have 
some text there).

I seem to get some effect by customizing footer.content.properties - that's how 
I've got the text to be grey.
However I don't seem to get any useful effect from the padding attributes, 
which are the ones I'd expect to need to use for this.
If I set padding I seem to get some padding added at the left edge, but not 
the other three. Even if I set all four of padding-left/right/top/bottom I only 
get space added at the left.

Can anyone advise what I need to do to get padding at right, left and bottom ?

I'm doing DocBook - FO and then to PDF using FOP 1.1.

Regards,
Richard.






Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

RE: [docbook-apps] Alignment / tabular formatting of ToC in FO

[Kerry, Richard]

I'm making some progress on this.

I've customized the toc.line template, replacing the fo:block by fo:list-block.

While I am now seeing the alignment I want I am not getting any indentation.  
The original form of toc.line does show indentation.

I haven't customized any mode=toc templates so the calling and use of 
set.toc.indent has not changed but the indentation is not working now the 
toc.lines are using list-blocks.



Does anyone have any idea what might be missing.





Regards,

Richard.





I'm using Fop-1.1 for th FO-PDF conversion.











Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Kerry, Richard [richard.ke...@atos.net]
Sent: 03 May 2013 17:23
To: docbook-apps@lists.oasis-open.org
Subject: RE: [docbook-apps] Alignment / tabular formatting of ToC in FO


Bob,



What you want isn't possible with just the existing attribute-sets.

That's what I thought.



If you want to pursue a customization, I can give some guidance.

That is very helpful of you, thank you.



I shall study your explanation and attempt some further customizations.





Appreciatively,

Richard.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 
82259063[cid:A7813E7-5425-4D355-99D4-A84DFEBCA0@MimeCtl]about:blank#
M: +44 (0)7812 
325518[cid:A7813E7-5425-4D355-99D4-A84DFEBCA0@MimeCtl]about:blank#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Bob Stayton [b...@sagehill.net]
Sent: 26 April 2013 22:19
To: Kerry, Richard; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Alignment / tabular formatting of ToC in FO

Hi Richard,
What you want isn't possible with just the existing attribute-sets.  If you 
want to pursue a customization, I can give some guidance.

There are two levels of formatting in the FO table of contents: mode=toc and 
toc.line.   The document hierarchy is processed in mode=toc, and there are 
templates matching on different hierarchical elements in that mode (all in 
fo/autotoc.xsl).  Each of those templates does the following:

1.  It calls the toc.line template to generate the text, leader, and page 
reference for the current element.

2.  If the element has TOC children, it also creates an fo:block, adds an 
indent by calling the template named 'set.toc.indent' (here 'set' is a verb, 
not a noun), and processes those children inside that indented block, in 
mode=toc.

If you have examined the toc.line template, you may have noticed that it starts 
with:

fo:block xsl:use-attribute-sets=toc.line.properties

So all the toc.lines use the same attribute set.  The differences occur in the 
outer container block for the group of children, where the indent for the whole 
set is added.

To accomplish the tabbed look you want, you can change the fo:block in 
toc.line to fo:list-block, which is like a two-column table.  You put the label 
in the fo:list-item-label, and the title, leader, and page reference in the 
fo:list-item-body.  This section in my book shows how to set up such an element:

http://www.sagehill.net/docbookxsl/SideBySide.html

The trick is to match the relative indent of the fo:list-item-body with the 
relative indent of any child elements.  That way, the children that follow have 
their section number (in their list-item-label) indented the same amount as the 
parent's title (in its list-item-body).

As Jan pointed out, one thing you have to be aware of is that those indents now 
have to be wide enough

RE: [docbook-apps] Alignment / tabular formatting of ToC in FO

[Kerry, Richard]

Bob,



What you want isn't possible with just the existing attribute-sets.

That's what I thought.



If you want to pursue a customization, I can give some guidance.

That is very helpful of you, thank you.



I shall study your explanation and attempt some further customizations.





Appreciatively,

Richard.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable

From: Bob Stayton [b...@sagehill.net]
Sent: 26 April 2013 22:19
To: Kerry, Richard; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Alignment / tabular formatting of ToC in FO

Hi Richard,
What you want isn't possible with just the existing attribute-sets.  If you 
want to pursue a customization, I can give some guidance.

There are two levels of formatting in the FO table of contents: mode=toc and 
toc.line.   The document hierarchy is processed in mode=toc, and there are 
templates matching on different hierarchical elements in that mode (all in 
fo/autotoc.xsl).  Each of those templates does the following:

1.  It calls the toc.line template to generate the text, leader, and page 
reference for the current element.

2.  If the element has TOC children, it also creates an fo:block, adds an 
indent by calling the template named 'set.toc.indent' (here 'set' is a verb, 
not a noun), and processes those children inside that indented block, in 
mode=toc.

If you have examined the toc.line template, you may have noticed that it starts 
with:

fo:block xsl:use-attribute-sets=toc.line.properties

So all the toc.lines use the same attribute set.  The differences occur in the 
outer container block for the group of children, where the indent for the whole 
set is added.

To accomplish the tabbed look you want, you can change the fo:block in 
toc.line to fo:list-block, which is like a two-column table.  You put the label 
in the fo:list-item-label, and the title, leader, and page reference in the 
fo:list-item-body.  This section in my book shows how to set up such an element:

http://www.sagehill.net/docbookxsl/SideBySide.html

The trick is to match the relative indent of the fo:list-item-body with the 
relative indent of any child elements.  That way, the children that follow have 
their section number (in their list-item-label) indented the same amount as the 
parent's title (in its list-item-body).

As Jan pointed out, one thing you have to be aware of is that those indents now 
have to be wide enough to accomodate the widest section number, or the widest 
ones will wrap badly.  Making the matching indents wider as you go deeper is 
possible by modifying the 'set.toc.indent' template to make it wider for 
greater depth.  And the mode=toc templates need to do the same thing.

To get different font styles for different levels, you could add a mode to 
generate attribute elements:

fo:list-block ...
  xsl:apply-templates select=. mode=toc.line.properties/
  fo:list-item

and then add templates for each element, specifying its own attribute elements:

xsl:template match=d:chapter mode=toc.line.properties
  xsl:attribute ...
  xsl:attribute ...
/xsl:template

Using a mode avoids the problem of conditionalizing attribute-sets, which is 
difficult.

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net

From: Kerry, Richardmailto:richard.ke...@atos.net
Sent: Friday, April 26, 2013 10:51 AM
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]‎
Subject: [docbook-apps] Alignment / tabular formatting of ToC in FO




I'm working on a docbook document which I am currently trying to process to PDF 
via FO.

The document is an article.



I'm generally copying the formatting of an existing set of Word documents.

In particular at the moment I'm looking at the appearance of the ToC pages.



In the standard stylesheets, each line of ToC is generated looking rather like 
this :



1. Overview 
..
 3

2. Description 
...
 3

3. Applicable Documents 
. 3

4. Configuration procedure

[docbook-apps] Alignment / tabular formatting of ToC in FO

[Kerry, Richard]

I'm working on a docbook document which I am currently trying to process to PDF 
via FO.

The document is an article.



I'm generally copying the formatting of an existing set of Word documents.

In particular at the moment I'm looking at the appearance of the ToC pages.



In the standard stylesheets, each line of ToC is generated looking rather like 
this :



1. Overview 
..
 3

2. Description 
...
 3

3. Applicable Documents 
. 3

4. Configuration procedure 
.. 3

5. Starting up 
...
 3

   5.1. Dependencies 
.. 3

   5.1.1. Level 3 Heading 
. 3

6. Features 
..
 3

  6.1. Diagnostics 
.. 4

  6.2. Test procedures 
... 4

7. Known Issues 
...
 5

8. Version History 
.
 5



ie the title string is immediately followed by the leader.  No difference in 
styling.

(the page numbers are aligned in the PDF document, even though they may not be 
here.



The apearance I am looking for is more like the following :



Contents 
.
 1about:blank#_Toc354480557

1 Overview. 

 4about:blank#_Toc354480558

1.1  Description. 
...
 4about:blank#_Toc354480559

1.2  Device firmware version. 
.. 
4about:blank#_Toc354480560

1.3  Configuration. 

 4about:blank#_Toc354480561

1.3.1   The v1/v2 Location 
.. 
4about:blank#_Toc354480562

1.3.2   The V3 Location 
 
5about:blank#_Toc354480563

1.3.3   The V4 Location 
 
5about:blank#_Toc354480564

1.4  Driver compatibility. 
 
5about:blank#_Toc354480565

1.5  Version. 
...
 5about:blank#_Toc354480566

1.5.1   Automatic Shutdown on Closing. 
 
5about:blank#_Toc354480567

1.6  Messaging System – If32.dll.  
. 
5about:blank#_Toc354480568





Again the page numbers should appear lined up.  Not sure if the rest of this 
will come through on this list.

The different section levels should have different styles.



The particular requirements here are :

1. Section numbers at each level are aligned.

2. Headings at each level are alligned.

3. Headings and section numbers at each level have different styles.



Can the styling can be done using existing attribute sets ?  I can see that 
such attibute sets exist for the actual section titles, but I can't see any for 
the titles as shown in the ToC.



I am not sure how I can do the alignment.

I was thinking it might be doable using an fo:table, but there are a number of 
separate alignment lines (columns) so that doesn't seem to me like a table.

I see that the default stylesheet does start each level at the same alignment.  
But that only applies to the section numbers.  The title text starts 
immediately after the number, where I want that text also to be on a per-level 
alignment.



Can anyone advise how I should approach this.



I believe the per-line formatting is done by template toc.line, from 
fo/autotoc.xsl.  But I'm not clear where the page is generated from.





Appreciatively,

Richard.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 
82259063[cid:A4FDD16-EA4B-4A5EE-A24E-984DDF44AF@MimeCtl]about:blank#
M: +44 (0)7812 
325518[cid:A4FDD16-EA4B-4A5EE-A24E-984DDF44AF@MimeCtl]about:blank#
Room EBX 301, BBC Television Centre, Wood 

RE: [docbook-apps] EPUB3: how to use base.dir ?

[Kerry, Richard]

 Not sure if we want break backward compatibility or not. I think the
 current implementation is confusing. IF we want to do that, 
 then better sooner than later. 

I would urge against the default = don't work option.
If that's what backward-compatibility would give then backward-compatibility 
should be lost.

default = it works should take precedence.


Definitely,
Richard.


 
-
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] epub3 - copying the images, using Ant

[Kerry, Richard]

This is really an Ant question but as I'm not on any Ant mailing list (yet - 
may need to soon ...) .



Is there anyone with experience of :

1.  Building epub3 output from DocBook.

and

2.  Doing so using Ant ?



How do you implement stage 2.  Copy any image files into the output 
directory. ?



Doing it using a batch-file I can use some XSL to extract the list of images in 
package.opf and write out a suitable batch file which I can then execute to do 
the copies.

Using Ant I can't see how to do this.  It looks like I can only do copies based 
on a list of files in the Ant build file.

Is there a way in Ant of doing a copy based on data which only becomes 
available during the build process ?





Appreciatilvely,

Richard.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 
82259063[cid:7881E1D-CA90-435AA-B0A9-2E7DA9C782@MimeCtl]about:blank#
M: +44 (0)7812 
325518[cid:7881E1D-CA90-435AA-B0A9-2E7DA9C782@MimeCtl]about:blank#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable


attachment.ashx
Description: attachment.ashx


BsAt4ube4GblQIASUVORK5CYII=
Description: BsAt4ube4GblQIASUVORK5CYII=


attachment.ashx
Description: attachment.ashx

-
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] epub3 - copying the images, using Ant

[Kerry, Richard]

Probably you have to this before you run 'ant'.

That's what i want to avoid.
It's the running of Ant that generates the list 


Richard.






From: Michael Wiedmann [m...@miwie.in-berlin.de]
Sent: 15 March 2013 12:35
To: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] epub3 - copying the images, using Ant


Kerry, Richard wrote:
...
 How do you implement stage 2.  Copy any image files into the output
 directory. ?
...
 Is there a way in Ant of doing a copy based on data which only becomes
 available during the build process ?

Try the following approach (untested):

- generate a file which contains filenames of your image files
  (one per line). Probably you have to this before you run 'ant'.
- use Ant's 'copy' task with a 'fileset' setting the 'includesfile
  attribute to your images filename.

Michael


-
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] epub3 - copying the images, using Ant

[Kerry, Richard]

A-ha, that might be the way to do it.



Thank you, I'll give it a try.







Richard.






From: Tony Graham [tgra...@mentea.net]
Sent: 15 March 2013 12:41
To: DocBook Apps Mailing List ý[docbook-apps@lists.oasis-open.org]ý
Subject: Re: [docbook-apps] epub3 - copying the images, using Ant


On Fri, March 15, 2013 12:10 pm, Kerry, Richard wrote:
...
 1.  Building epub3 output from DocBook.

...
 Is there a way in Ant of doing a copy based on data which only becomes
 available during the build process ?

Write the filename list, one line per filename, to a text file and use a
@includesfile to refer to that file.  E.g., from one of my projects:

copy
todir=${build.dir}/${epub}/OPS
  fileset dir=${notes.dir}
   includesfile=${build.dir}/${epub}-figurelist.txt /
/copy

Regards,


Tony Graham   tgra...@mentea.net
Consultant 
http://www.mentea.nethttp://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

RE: [docbook-apps] epub3 - copying the images, using Ant

[Kerry, Richard]

There is no reason why you should not be able to generate the list of
image filenames in a special target and use this filename later on in
another target ...



That's what I want to do. I'd expected there to be a version of copy which 
could work in this way, but I couldn't see how to do it; Tony's example has 
pointed me at it.

Appreciatively,



Richard.






From: Michael Wiedmann [m...@miwie.in-berlin.de]
Sent: 15 March 2013 13:57
To: Kerry, Richard
Subject: Re: [docbook-apps] epub3 - copying the images, using Ant


Kerry, Richard wrote:

 Probably you have to this before you run 'ant'.

 That's what i want to avoid.
 It's the running of Ant that generates the list 

There is no reason why you should not be able to generate the list of
image filenames in a special target and use this filename later on in
another target as value for the includesfile attribute.

Tony Graham's solution is the same as mine, but probably easier to
understand because of the example code.

Michael

[docbook-apps] epub3 - Should img.src.path be used when generating package.opf ?

[Kerry, Richard]

Should I expect to be able to use img.src.path when generating epub3 documents ?



Having set it ( to Images/, as I do with my other html-based outputs) it 
doesn't seem to have any effect on package.opf.  It does add Images/ to any 
image file names I use where they appear in the html output files, but 
package.opf doesn't show any sign of it.









Regards,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 
82259063[cid:3A429ED-7C8F-44822-A464-8312319E52@MimeCtl]about:blank#
M: +44 (0)7812 
325518[cid:3A429ED-7C8F-44822-A464-8312319E52@MimeCtl]about:blank#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable


attachment.ashx
Description: attachment.ashx


BsAt4ube4GblQIASUVORK5CYII=
Description: BsAt4ube4GblQIASUVORK5CYII=


attachment.ashx
Description: attachment.ashx

-
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] epub3 - Can I do a per-run configured copy within Ant ?

[Kerry, Richard]

I'm trying to automate section 2 - Copy Image files, from the epub3 README.

I've written some XSL to extract the list of image files from package.opf and 
generate a batch file to do the copies.

I am trying to move my builds from batch files to Ant and am wondering how to 
do this copy from Ant. Logically I should be able to write a file containing 
the list of files to be copied, but I can't (yet) see how to get Ant to do 
this.  If I knew the list of files in advance I could put them into the Ant 
build file, but the point here is that the list isn't known until the manifest 
in package.opf can be consulted.





Regards,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 
82259063[cid:80B027E-5AEC-4A811-9EA6-53D08D6ED4@MimeCtl]about:blank#
M: +44 (0)7812 
325518[cid:80B027E-5AEC-4A811-9EA6-53D08D6ED4@MimeCtl]about:blank#
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable


attachment.ashx
Description: attachment.ashx


BsAt4ube4GblQIASUVORK5CYII=
Description: BsAt4ube4GblQIASUVORK5CYII=


attachment.ashx
Description: attachment.ashx

-
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] Request to that DB stylesheets be able to use Saxon 9.

[Kerry, Richard]

It has come to my attention (see xslt list for details) that not only are the 
DocBook stylesheets still XSLT 1, but that, when being processed using Saxon, 
they use certain features that are specific to Saxon 6, and are not available 
in Saxon 9.  Specifically html/chunker.xsl uses saxon:output rather than 
result-document.

May I request that this be addressed as soon as possible, especially since 
there is currently progress toward 1.78.1.

Even without a full move of docbook from Xsl 1 to 2 I would appreciate being 
able to use one version of Saxon for all my xslt needs.


Michael Kay indicates that it may be achievable just by replacing saxon:output 
by result-document.  Though there are a couple of bits of fixing-up that may 
need doing - there are calls to element-available('saxon:output') and the 
saxon:output call has a parameter/attribute saxon:character-representation 
which doesn't appear to relate to any of result-document's parameters.


Appreciatively,
Richard.





[Blue line]
Richard Kerry
BNCS Engineer

T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

 [Atos logo]

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

inline: Atos_EmailBlueLine.gifinline: Atos_EmailLogo.gif

RE: [docbook-apps] Request to that DB stylesheets be able to use Saxon 9.

[Kerry, Richard]

As I've said, I don't mind that the stylesheets remain xsl1 - I just want to be 
able to use one processor for everything.

Having said that I suddenly wonder whether result-document is actually in xsl 1 




R.





From: Carlos Araya [mailto:carlos.ar...@gmail.com]
Sent: 04 February 2013 13:14
To: Kerry, Richard
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Request to that DB stylesheets be able to use Saxon 
9.

Richard:

Norm Walsh began working on salt 2 stylesheets. They are currently a separate 
project. You can find  a link to the distributions here:

Http://docbook.github.com/

Carlos

Sent from my iPad

On Feb 4, 2013, at 3:24 AM, Kerry, Richard 
richard.ke...@atos.netmailto:richard.ke...@atos.net wrote:


It has come to my attention (see xslt list for details) that not only are the 
DocBook stylesheets still XSLT 1, but that, when being processed using Saxon, 
they use certain features that are specific to Saxon 6, and are not available 
in Saxon 9.  Specifically html/chunker.xsl uses saxon:output rather than 
result-document.

May I request that this be addressed as soon as possible, especially since 
there is currently progress toward 1.78.1.

Even without a full move of docbook from Xsl 1 to 2 I would appreciate being 
able to use one version of Saxon for all my xslt needs.


Michael Kay indicates that it may be achievable just by replacing saxon:output 
by result-document.  Though there are a couple of bits of fixing-up that may 
need doing - there are calls to element-available('saxon:output') and the 
saxon:output call has a parameter/attribute saxon:character-representation 
which doesn't appear to relate to any of result-document's parameters.


Appreciatively,
Richard.





Atos_EmailBlueLine.gif
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

 Atos_EmailLogo.gif
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

RE: [docbook-apps] Request to that DB stylesheets be able to use Saxon 9.

[Kerry, Richard]

As I've said, I don't mind that the stylesheets remain xsl1  - I just want to 
be able to use one processor for everything.

Having said that I suddenly wonder whether result-document is actually in xsl 1 




R.



From: Carlos Araya [mailto:carlos.ar...@gmail.com]
Sent: 04 February 2013 13:14
To: Kerry, Richard
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Request to that DB stylesheets be able to use Saxon 
9.

Richard:

Norm Walsh began working on salt 2 stylesheets. They are currently a separate 
project. You can find  a link to the distributions here:

Http://docbook.github.com/

Carlos

Sent from my iPad

On Feb 4, 2013, at 3:24 AM, Kerry, Richard 
richard.ke...@atos.netmailto:richard.ke...@atos.net wrote:


It has come to my attention (see xslt list for details) that not only are the 
DocBook stylesheets still XSLT 1, but that, when being processed using Saxon, 
they use certain features that are specific to Saxon 6, and are not available 
in Saxon 9.  Specifically html/chunker.xsl uses saxon:output rather than 
result-document.

May I request that this be addressed as soon as possible, especially since 
there is currently progress toward 1.78.1.

Even without a full move of docbook from Xsl 1 to 2 I would appreciate being 
able to use one version of Saxon for all my xslt needs.


Michael Kay indicates that it may be achievable just by replacing saxon:output 
by result-document.  Though there are a couple of bits of fixing-up that may 
need doing - there are calls to element-available('saxon:output') and the 
saxon:output call has a parameter/attribute saxon:character-representation 
which doesn't appear to relate to any of result-document's parameters.


Appreciatively,
Richard.





Atos_EmailBlueLine.gif
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

 Atos_EmailLogo.gif
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

RE: [docbook-apps] How do you manage your catalogs ?

[Kerry, Richard]

When I eventually got back to looking at this I realized there was a rather 
fundamental question that I had assumed an answer for and not tested 





Can the Catalog be written using relative paths ?





For some reason I had believed the answer was No.  Possibly because that was in 
all the examples I'd seen.

Having thought to test the issue I find that the answer is actually Yes - A 
catalog may use relative paths.



This means that my original concern is void.  I can write one catalog and hold 
it in Version Control with the customizations.  When it is checked out it just 
needs pointing at and everything else works.







Eventually,

Richard.





Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.




 How do people manage their XML catalogs, when developing DocBook ?

 In particular when you're not working alone so need to share a catalog's
 contents but with individualized base paths. And even if 'not alone' just
 means there's a build server which needs a catalog of its own.



 Of course using a catalog gets away from individuals needing to customize
 their copies of XML files.

 But then you need to put your own location(s) in the catalog, which is
 otherwise the same as the ones your colleagues, and the build server, need.



 So do you :

 - insist all the files are in the same location on all computers ?

 - have an installation process which takes a common catalog with a place
 marker and inserts the individual's path at the appropriate place (xml:base
 attribute) ? (eg a simple xsl task)

 - use some feature of catalogs which I haven't noticed to make an external
 reference to an absolute path ?

 - expect all the users to hand-edit the catalog to put in their own
 locations ?

 - something else entirely ?









 Uncertainly,

 richard.



 BTW. My particular interest is in how to do this this under Windows.
 (Li|U)n(i|u)x may have different answers. Or may not.







 Richard Kerry

 BNCS Engineer

RE: [docbook-apps] RE: Creating a separate section/component for Revision History

[Kerry, Richard]

Bob,

Thanks for reminding me about validity.
I've just tried validating and you are correct - it gets rejected, citing 
section not allowed as only certain component types are allowed (presumably 
after at least one appendix).

It is an article.

At the moment I am concentrating on PDF (via Fo,and using FOP), though I will 
also want some html versions.  The first Html format I will want is CHM.  Then 
eventually epub3 and WebHelp.

I shall change the source to make it valid. 
Then :
- look again at how to place the result in the final document.
- look into using the attribute sets you list to get the formatting improved.


Appreciatively.
Richard.
 



 -Original Message-
 From: Bob Stayton [mailto:b...@sagehill.net] 
 Sent: 07 December 2012 20:03
 To: Kerry, Richard; docbook-apps@lists.oasis-open.org
 Subject: Re: [docbook-apps] RE: Creating a separate 
 section/component for Revision History
 
 
 I don't think putting a section after an appendix is valid 
 DocBook, for 
 either book or article.  The stylesheet does not take the 
 time to validate 
 the input, but they are written on the assumption that the 
 content is valid. 
 Because they are template driven, invalid content may work, 
 but it is risky.
 
 Is this a book or an article document?
 
 Also, is this for print or html output?
 
 For print output, there are three attribute-sets that can be 
 customized for 
 your purposes:
 
 revhistory.table.properties
 revhistory.title.properties
 revhistory.table.cell.properties
 
 Bob Stayton
 Sagehill Enterprises
 b...@sagehill.net
 
 
 From: Kerry, Richard
 Sent: Friday, December 07, 2012 10:17 AM
 To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
 Subject: [docbook-apps] RE: Creating a separate section/component for 
 Revision History
 
 
 
 Well, having done some more testing I can answer my own question..
 (partially if not totally)
 
 I'd assumed that the stylesheets automatically put any 
 appendices after all 
 sections.  I now find this is not so.  If I have a section 
 in my source 
 after the appendix then it gets rendered after the appendix.
 So if I put my Revision History (or two of them) into this 
 section it gets 
 rendered there.
 
 So that part of the question is answered.
 
 What I now need to do is work out how to control the 
 rendering.  I want it 
 to be a table with visible borders whereas the default has 
 the borders not 
 visible.  Also I'll want a coloured heading line (which I 
 will for other 
 tables in the document as well).
 
 Also the Appendix heading is indented compared to the 
 Section headings.
 
 
 Eventually,
 Richard.
 
 
 
 
 
 
 
 
 From: Kerry, Richard [richard.ke...@atos.net]
 Sent: 03 December 2012 16:42
 To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
 Subject: [docbook-apps] Creating a separate section/component 
 for Revision 
 History
 
 
 
 Team,
 
 I've successfully removed the Revision History from the 
 title-page of my 
 document (ie from the title-page of the FO transform) - that was 
 straightforward.
 I'd like to add it back as a separate section (*) later in the file - 
 probably between the appendix (which is rarely present) and 
 the index (which 
 is never present).
 
 Can anyone advise me where in the stylesheets I need to add 
 my new section ?
 I'm expecting to see somewhere the current main structure - 
 ie title-page, 
 ToC, section 1 ... section n, Appendices, Index.  I'd expect 
 to be adding 
 something in there.
 There will probably be a pile of other stuff needed to make this work.
 It may be that I just need to write a 'section' and mark it 
 for special 
 handling, then customize a version of the section template to 
 be called 
 between the appendix and the index.  This may be simpler.  
 But I still need 
 to find out where to get it called.
 Actually, since I'll generally need two revision histories, 
 writing it into 
 a separate Section page may also make it easier
 
 Appreciatively,
 Richard.
 
 
 (*) I've said 'section' here but that has a specific meaning. 
  I think what 
 I mean here is what is sometimes referred to as a 'component'.
 
 
 
 
 
 
 Richard Kerry
 BNCS Engineer
 T: +44 (0)20 82259063
 M: +44 (0)7812 325518
 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
 richard.ke...@atos.net
 uk.atos.net
 
 This e-mail and the documents attached are confidential and 
 intended solely 
 for the addressee; it may also be privileged. If you receive 
 this e-mail in 
 error, please notify the sender immediately and destroy it. 
 As its integrity 
 cannot be secured on the Internet, the Atos group liability cannot be 
 triggered for the message content. Although the sender endeavours to 
 maintain a computer virus-free network, the sender does not 
 warrant that 
 this transmission is virus-free and will not be liable for 
 any damages 
 resulting from any virus transmitted

RE: [docbook-apps] How do you manage your catalogs ?

[Kerry, Richard]

 
 That's right. I'm the only one who operates the publishing system.
 I've got a server running the Hudson continuous integration build
 manager. It checks our source code control system every night and if
 any writers have checked in changes, it launches a build. So the
 writers don't have to launch their own builds, they can just grab the
 finished output files from the server the next morning. Actually, they
 could launch their own builds if they went to the server and clicked
 build. But they don't seem to want to do that.

It's going to be hard enough persuading anyone to try this without having to 
say you can't get a proper version of the final doc without committing it and 
either waiting for an Overnight, or remote desktopping to the Build Server and 
kicking off a whole build ( 2 hours)  so I think I need to make it 
straightforward to do a doc build locally.


  Is this the common way DocBook authoring and publishing are done ?
 
 I'm not sure. I know it's very typical to use a centralized build
 system, especially for really big doc sets. But there are so many
 different ways to handle DocBook files, I don't think there's a common
 way at all.

Ours is unlikely to be what could be referred to as really big.

 
 It take a little bit of learning to get yourself to the point where
 you can set up DocBook publishing for different outputs. 

I'm doing that now (intermittently).  And I don't think I can expect any (or 
many) of my colleagues to be involved, at least until I can show how good the 
result is .

It might make
 sense to have a centralized system so that a subset of people could do
 the XML publishing setup and then everyone's documents would be
 available in all the required formats. 

That's sort of the plan, except that it'll just be me, for the moment at least.

If individuals don't need a
 given output format, they can ignore the files.

I'm envisaging a simple build application, which by default will build all the 
configured results, but can easily be switched to produce a reduced set.
This may just be a wrapper around Ant, though it may not.
It may just be a batch file.


  I know that recent Word can do its own export directly to 
 PDF but thus far
  I've been unable to get a script working to do this so 
 we're sticking with
  this method.
 
 We actually work in Word. Part of the publishing system is a custom
 XSLT transformation from the internal XML structure of Word files to
 DocBook XML. So our writers just check in their Word files and the
 system generates PDF and HTML directly from them.

Oh right.
That's a possibility, though I think I might prefer a one-off transformation 
from Word to DocBook, as I'd expect it'd need some fixing up.  And that would 
remove any possible expectation that what they've seen in Word would be exactly 
like what they'll get.


Uncertainly,
Richard.

-
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] How do you manage your catalogs ?

[Kerry, Richard]

 
 The easiest thing to do would be an editor as XMLMind's XXE 
 (as Stefan 
 Seefeld pointed out), or Oxygen XML Editor which my 
 department is using. 

That involves buying some editors as we don't currently have any; though I 
think XXE can be used for free so that might be a possibility for the moment.

 Creating common formats like HTML, XHTML, PDF, and EPUB is 
 pre-configured in Oxygen, so it's just a matter of a few clicks to 
 produce those formats.

Because we're used to seeing a particular style of results I'd need to 
customize this, which is what I'm doing with the stylesheets at the moment.
 
 We've set up a 
 make-based system that works the exact same way on the central build 
 server and when run locally; for example (for a document 
 named book.xml):
 
 * 'make book.valid': runs xmllint and other tools to validate book.xml
 * 'make book.html'
 * 'make book.pdf'
 * 'make book.epub'
 * etc.

I'd need to hide the specific tool as my colleagues aren't used to command-line 
tools in general, and make in particular.  
 
 The idea is to have an easy-to-remember set of commands that 
 work both 
 locally and centrally, and a system that can be set up 
 fairly quickly. 

I'd be inclined to hide this behind some GUI application.

 More information can be found here: 
 http://dev.mysql.com/doc/mysqldoc-guide/en/index.html (and 
 the complete 
 tool set is here: 
 http://downloads.mysql.com/docs/mysqldoc-toolset.tar.gz).

I'll try and have a look at some of these.


Appreciatively,
Richard.

-
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] How do you manage your catalogs ?

[Kerry, Richard]

Peter,



So yours is a workflow where the XML writers don't produce final outputs 
themselves.  Indeed many/most of them can't do so as they don't have the 
publishing tools.



Is this the common way DocBook authoring and publishing are done ?



I'm not sure it would work for us.  We produce software and write our own 
documentation.  And there aren't many of us.

What my colleagues are used to is ediiting in Word and producing PDF straight 
from it using a third-party pseudo-printer (BullZip) (*).  Some have started 
producing CHM instead, based on hand-edited HTML (ie edited in FrontPage or 
Expression Web).  We've been told that neither format is suitable for every one 
of our customers so I'd like to find a way of generating multiple formats - 
hence trying DocBook.

So from this starting point I think we need a system where everyone can 
generate any output themselves.

At the moment some of the software and documents are produced by a manual build 
by an individual developer, and others are produced by an automated build.



Hence the question about how to handle the catalog.



Part of what you say is fine and is the way I'd expect to do it.  The 
stylesheets etc are in a standard directory, and reorganization therein would 
be expected to break the system.





Appreciatively,

Richard.





(*)

I know that recent Word can do its own export directly to PDF but thus far I've 
been unable to get a script working to do this so we're sticking with this 
method.




From: Peter Desjardins [peter.desjardins...@gmail.com]
Sent: 04 December 2012 16:04
To: Kerry, Richard
Cc: DocBook Apps Mailing List [docbook-apps@lists.oasis-open.org]
Subject: Re: [docbook-apps] How do you manage your catalogs ?


In my environment, most people don't have to set up the publishing
tools so hand editing the catalog is not a problem. I keep all the
publishing tools (the catalog, DTDs, Saxon, XSL) in a directory that
people can grab and put anywhere on a computer. Then the person
setting up to publish needs to go into the catalog and set the
xml:base attribute with the path to that directory.

So when you place my publishing tools directory on a computer, the
first lines of the catalog file look like this:

catalog xmlns=urn:oasis:names:tc:entity:xmlns:xml:catalog
  group prefer=public
  xml:base=file:///c:/path/to/publishing-tools/
!-- Resolve DTD URL system ID to local file --
rewriteSystem
systemIdStartString=http://www.oasis-open.org/docbook/xml/4.5/;
rewritePrefix=docbook-xml-4.5/ /

And you edit the base file path. The rest of the catalog assumes that
you haven't reorganized the files in the publishing tools directory.
This seems to work well on Windows and Linux servers.

Hope that helps a little.

Peter



On Mon, Dec 3, 2012 at 11:44 AM, Kerry, Richard richard.ke...@atos.net wrote:


 How do people manage their XML catalogs, when developing DocBook ?

 In particular when you're not working alone so need to share a catalog's
 contents but with individualized base paths.  And even if 'not alone' just
 means there's a build server which needs a catalog of its own.



 Of course using a catalog gets away from individuals needing to customize
 their copies of XML files.

 But then you need to put your own location(s) in the catalog, which is
 otherwise the same as the ones your colleagues, and the build server, need.



 So do you :

 - insist  all the files are in the same location on all computers ?

 - have an installation process which takes a common catalog with a place
 marker and inserts the individual's path at the appropriate place (xml:base
 attribute) ?   (eg a simple xsl task)

 - use some feature of catalogs which I haven't noticed to make an external
 reference to an absolute path ?

 - expect all the users to hand-edit the catalog to put in their own
 locations ?

 - something else entirely ?









 Uncertainly,

 richard.



 BTW.  My particular interest is in how to do this this under Windows.
 (Li|U)n(i|u)x may have different answers.  Or may not.







 Richard Kerry

 BNCS Engineer

 T: +44 (0)20 82259063

 M: +44 (0)7812 325518

 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ

 richard.ke...@atos.net

 uk.atos.net

 This e-mail and the documents attached are confidential and intended solely
 for the addressee; it may also be privileged. If you receive this e-mail in
 error, please notify the sender immediately and destroy it. As its integrity
 cannot be secured on the Internet, the Atos group liability cannot be
 triggered for the message content. Although the sender endeavours to
 maintain a computer virus-free network, the sender does not warrant that
 this transmission is virus-free and will not be liable for any damages
 resulting from any virus transmitted.



 -
 To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
 For additional commands, e

[docbook-apps] RE: Creating a separate section/component for Revision History

[Kerry, Richard]

Well, having done some more testing I can answer my own question..

(partially if not totally)



I'd assumed that the stylesheets automatically put any appendices after all 
sections.  I now find this is not so.  If I have a section in my source after 
the appendix then it gets rendered after the appendix.

So if I put my Revision History (or two of them) into this section it gets 
rendered there.



So that part of the question is answered.



What I now need to do is work out how to control the rendering.  I want it to 
be a table with visible borders whereas the default has the borders not 
visible.  Also I'll want a coloured heading line (which I will for other tables 
in the document as well).



Also the Appendix heading is indented compared to the Section headings.





Eventually,

Richard.











From: Kerry, Richard [richard.ke...@atos.net]
Sent: 03 December 2012 16:42
To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: [docbook-apps] Creating a separate section/component for Revision 
History




Team,



I've successfully removed the Revision History from the title-page of my 
document (ie from the title-page of the FO transform) - that was 
straightforward.

I'd like to add it back as a separate section (*) later in the file - probably 
between the appendix (which is rarely present) and the index (which is never 
present).



Can anyone advise me where in the stylesheets I need to add my new section ?

I'm expecting to see somewhere the current main structure - ie title-page, ToC, 
section 1 ... section n, Appendices, Index.  I'd expect to be adding something 
in there.

There will probably be a pile of other stuff needed to make this work.

It may be that I just need to write a 'section' and mark it for special 
handling, then customize a version of the section template to be called between 
the appendix and the index.  This may be simpler.  But I still need to find out 
where to get it called.

Actually, since I'll generally need two revision histories, writing it into a 
separate Section page may also make it easier



Appreciatively,

Richard.





(*) I've said 'section' here but that has a specific meaning.  I think what I 
mean here is what is sometimes referred to as a 'component'.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

RE: [docbook-apps] Date and Time normalization

[Kerry, Richard]

Bob,

Thanks for the notes about dates and EXSLT.

Note that I am not dealing with arbitrary date formats.  I am dealing with a 
small number; not many more than the three I listed below (*).  Also that they 
are all UK standard, ie 3/12 is definitely 3rd December.  And the month names 
are English, and usually either three letter abbreviations or in full.

In a previous job many years ago we did have, written in Pascal, a fairly 
arbitrary date parser.  It could cope with relative ones like tomorrow and 
next tuesday as well as the more obvious (absolute) ones.  It was used 
interactively so these relative forms were useful.  The general technique was 
to check a number of Regular Expressions until one matched.  I know XSLT 1 
doesn't have REs so that may be harder here, but if it can parse based on an 
expected format, and return a failure, then I should be able to scan through 
several for a match.

I'll do some more work on this when I am next able to.
If I get something that's applicable to the epub3 stylesheets I'll let you know.


Appreciatively,
Richard.

(*)
[0]3/12/12
[0]3/12/2012
[0]3-12-2012
[0]3 Dec 12
[0]3 December 2012
(possibly) 20121203

so mainly variants of \d{1,2}[/:]\d{1,2}[/:]\d{1,4} or \d{1,2} [a-zA-Z]{3,9} 
\d{1,4}



From: Bob Stayton [mailto:b...@sagehill.net]
Sent: 03 December 2012 20:20
To: Kerry, Richard; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Date and Time normalization

Hi Richard,
EXSLT does have some date-time functions, including one that will generate the 
current date and time in a standard format.  Perhaps the most useful function 
for you will be date-format() to convert a standard date string into some other 
output format.

But EXSLT does not include a function to parse an arbitrary string into a 
standard date string.  That is actual a hard problem with ambiguities that must 
be resolved, such as Is 3/12/2012 to be interpreted as March 12 or December 
3?.  And month names and abbreviations come in many languages and abbreviation 
styles.  I have not been able to find an XSLT module that can handle such 
conversions.  If you find something, please let me know and I will add it to 
the DocBook epub3 stylesheet.

The standard xs:date string format is CCYY-MM-DD.  If you can get your data 
into that format, then the EXSLT date functions can process it.

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net

From: Kerry, Richardmailto:richard.ke...@atos.net
Sent: Monday, December 03, 2012 10:52 AM
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]‎
Subject: [docbook-apps] Date and Time normalization




I want to normalize some dates in my DocBook.

Ie I have dates written in a number of different formats (eg 3/12/2012, 3 Dec 
2012, 3 December 2012) which I'd like to normalize into one.

This is sometimes just to achieve consistency in the output documents - ie to 
make them the same as my existing ones, written in Word, despite their starting 
out in a number of different formats.  Though in one particular case, epub3, it 
is to get the dates into the format required by the spec.  Epub requires dates 
in a particular format, and the existing eupb3 stylesheets just pass dates 
through as found in the source (and I have known it to leave duplicates, though 
I may have tweaked one of my source files to fix this as it isn't happening 
with my test file right now).



I'm expecting to do this by using a standard function to parse the dates as 
strings, then to use a formatting function to get the resultant date/time into 
a chosen format.

I can't see an XSLT 1 function to do this but I think there's one in EXSLT.

Can anyone advise on the best option to use.  Or direct me to any other options 
available.





Regards,

Richard.












Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



-
To unsubscribe, e-mail: docbook

RE: [docbook-apps] RE: Title-page customization - is it just me ?

[Kerry, Richard]

Bob,

I'm not sure if I'd recognize whether the two differences I note below are 
causing functional differences as I'm very new to titlepage customization.  I 
shall report back if I do think I've found anything.





I got my first bit of title-page customization working, though more by 
guesswork than from the docs.



On recognizing font-family as an fo:block attribute I tried adding break-after 
as an attribute.



ie changing :

t:titlepage t:element=article t:wrapper=fo:block 
font-family={$title.fontset} 



to :

t:titlepage t:element=article t:wrapper=fo:block 
font-family={$title.fontset} break-after=page 

And that worked.   Ie I got a page-break after the title.

Then I found something that told me that was what I needed to do - Note 5 in 
Example 11.1.



I'm not yet sure why it worked - there are some pages somwehere on the 
titlepage configuration elements, but I can't now find them.

I'll want to add some element positioning and coloured blocks, lines and images.







Eventually,

Richard.






[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

From: Bob Stayton [b...@sagehill.net]
Sent: 24 November 2012 00:44
To: Kerry, Richard; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] RE: Title-page customization - is it just me ?

Hi Richard,
Thanks for pointing out these inconsistencies.  I think I know why they are 
happening, and I'll correct them for the next release.

I hope they are not producing any functional differences.  If so, please point 
them out.

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net

From: Kerry, Richardmailto:richard.ke...@atos.net
Sent: Friday, November 23, 2012 9:58 AM
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]â€?
Subject: [docbook-apps] RE: Title-page customization - is it just me ?




Well - no sooner do I send my question than I make some progress, and realize 
it was me 

(checking a query I sent to the list back in July)



Since I'm using Docbook 5 I need to use the ns stylesheets.



Having done that I get the processed file being nearly the same as the 
published one.

The xml header PI differs in that mine states encoding=utf-8 which the 
published one doesn't.

The xsl:stylesheet lists the namespaces in different orders.

And the This stylesheet was cretated comment is slightly different.

Both the above differences I think are trivial, though i'm surprised the 
generated one is not the same as the published one as regards the comment.  I 
think the namespace name differences are just due to the processor.



Further down the file I find the following in my generated file, but absent 
from the published one.

   xsl:when test=d:docinfo/d:title
xsl:apply-templates mode=topic.titlepage.recto.auto.mode 
select=d:docinfo/d:title/
   /xsl:when
and

   xsl:when test=d:docinfo/d:subtitle
xsl:apply-templates mode=topic.titlepage.recto.auto.mode 
select=d:docinfo/d:subtitle/
 /xsl:when

I am suprised at this difference as I'd expect the real content in the 
published files to correspond to the source as published.





Now I do need to work out what to do to get the page-break added.

And then the removal of the Rev History from the beginning and moving it to the 
end and adding another.





Progressively,

Richard.








Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity

[docbook-apps] Title-page Customizaton vs Attribute-set : Table Of Contents.

[Kerry, Richard]

Team,



I seem to be finding that although I can customize the font params for a 
Section heading using an attribute-set (eg. section.title.level1.properties) it 
seems that in order to do the same for the Table Of Contents heading I need 
to use the titlepage customization system.



Is there a reason for this ?



It would be easier if just changing the colour of the ToC heading could be done 
just by a simple attibute-set customization.  As it happens I am doing some 
other title-page customization but it would seem overkill if I needed to go to 
that level of compliexity just to change a font colour/weight etc.



Uncertainly,

Richard.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Creating a separate section/component for Revision History

[Kerry, Richard]

Team,



I've successfully removed the Revision History from the title-page of my 
document (ie from the title-page of the FO transform) - that was 
straightforward.

I'd like to add it back as a separate section (*) later in the file - probably 
between the appendix (which is rarely present) and the index (which is never 
present).



Can anyone advise me where in the stylesheets I need to add my new section ?

I'm expecting to see somewhere the current main structure - ie title-page, ToC, 
section 1 ... section n, Appendices, Index.  I'd expect to be adding something 
in there.

There will probably be a pile of other stuff needed to make this work.

It may be that I just need to write a 'section' and mark it for special 
handling, then customize a version of the section template to be called between 
the appendix and the index.  This may be simpler.  But I still need to find out 
where to get it called.

Actually, since I'll generally need two revision histories, writing it into a 
separate Section page may also make it easier



Appreciatively,

Richard.





(*) I've said 'section' here but that has a specific meaning.  I think what I 
mean here is what is sometimes referred to as a 'component'.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

[docbook-apps] How do you manage your catalogs ?

[Kerry, Richard]

How do people manage their XML catalogs, when developing DocBook ?

In particular when you're not working alone so need to share a catalog's 
contents but with individualized base paths.  And even if 'not alone' just 
means there's a build server which needs a catalog of its own.



Of course using a catalog gets away from individuals needing to customize their 
copies of XML files.

But then you need to put your own location(s) in the catalog, which is 
otherwise the same as the ones your colleagues, and the build server, need.



So do you :

- insist  all the files are in the same location on all computers ?

- have an installation process which takes a common catalog with a place marker 
and inserts the individual's path at the appropriate place (xml:base attribute) 
?   (eg a simple xsl task)

- use some feature of catalogs which I haven't noticed to make an external 
reference to an absolute path ?

- expect all the users to hand-edit the catalog to put in their own locations ?

- something else entirely ?









Uncertainly,

richard.



BTW.  My particular interest is in how to do this this under Windows.  
(Li|U)n(i|u)x may have different answers.  Or may not.






[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Date and Time normalization

[Kerry, Richard]

I want to normalize some dates in my DocBook.

Ie I have dates written in a number of different formats (eg 3/12/2012, 3 Dec 
2012, 3 December 2012) which I'd like to normalize into one.

This is sometimes just to achieve consistency in the output documents - ie to 
make them the same as my existing ones, written in Word, despite their starting 
out in a number of different formats.  Though in one particular case, epub3, it 
is to get the dates into the format required by the spec.  Epub requires dates 
in a particular format, and the existing eupb3 stylesheets just pass dates 
through as found in the source (and I have known it to leave duplicates, though 
I may have tweaked one of my source files to fix this as it isn't happening 
with my test file right now).



I'm expecting to do this by using a standard function to parse the dates as 
strings, then to use a formatting function to get the resultant date/time into 
a chosen format.

I can't see an XSLT 1 function to do this but I think there's one in EXSLT.

Can anyone advise on the best option to use.  Or direct me to any other options 
available.





Regards,

Richard.












[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Title-page customization - is it just me ?

[Kerry, Richard]

I'm sure it is me, but I can't seem to get this to work.



I want to customize my (PDF via FO) document.

I want to make the title-page a separate page, ie to insert a page-break.  My 
document is an article.

I'm using docbook-xsl-1.77.1 stylesheets, and Docbook 5.



Following the instructions in Bob's book I've taken a copy of 
fo\titlepage.templates.xml.

I process it using template\titlepage.xsl and Saxon 6-5-5.  I call the result 
mytitlepages.xsl.

If I then compare my mytitlepages.xsl with the supplied 
fo\titlepage.templates.xml I find that all the elements which are fo:block in 
the given file are block in my generated one.

For example :

published:  fo:block xmlns:fo=http://www.w3.org/1999/XSL/Format; 
font-family={$title.fontset}

against
generated:  block font-family={$title.fontset}

If I then import my generated file I get streams of error messages - the 
first of which is :

Error at fo:block on line 342 of 
file:/C:/Users/Richard/Downloads/DocBook/docbook-xsl-1.77.1/fo/refentry.xsl:
  No attribute-set exists named refnamediv.titlepage.recto.style

and the others are similar.

I am assuming these are being caused by this inconsistency in the xsl.



Can anyone advise what I might be doing wrong ?

I am assuming that as the published stylesheets have been around for a while 
they are right 

And that Bob's book is accurate.



Note that at this stage my local titlepage.templates.xml is unmodified, yet is 
showing this inconsistency.  I would expect processing the published 
titlepage.templates.xml would generate a copy of the published 
titlepage.templates.xsl.





Once I've got this aspect sorted my next task will be to work out exactly what 
I  need to put where to get a page-break after the article recto title page.







Puzzledly,

Richard.





PS,

Once I've got the title page on a separate page I'll want to move the revision 
history somewhere else, ie to near the end of the document.

Actually I want it at the end, since it would be before the Index, but there 
isn't an Index.

And then I'm going to want two separate Revision Histories, one for the 
document and one for the software to which it refers.






[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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: Title-page customization - is it just me ?

[Kerry, Richard]

Well - no sooner do I send my question than I make some progress, and realize 
it was me 

(checking a query I sent to the list back in July)



Since I'm using Docbook 5 I need to use the ns stylesheets.



Having done that I get the processed file being nearly the same as the 
published one.

The xml header PI differs in that mine states encoding=utf-8 which the 
published one doesn't.

The xsl:stylesheet lists the namespaces in different orders.

And the This stylesheet was cretated comment is slightly different.

Both the above differences I think are trivial, though i'm surprised the 
generated one is not the same as the published one as regards the comment.  I 
think the namespace name differences are just due to the processor.



Further down the file I find the following in my generated file, but absent 
from the published one.

   xsl:when test=d:docinfo/d:title
xsl:apply-templates mode=topic.titlepage.recto.auto.mode 
select=d:docinfo/d:title/
   /xsl:when
and

   xsl:when test=d:docinfo/d:subtitle
xsl:apply-templates mode=topic.titlepage.recto.auto.mode 
select=d:docinfo/d:subtitle/
 /xsl:when

I am suprised at this difference as I'd expect the real content in the 
published files to correspond to the source as published.





Now I do need to work out what to do to get the page-break added.

And then the removal of the Rev History from the beginning and moving it to the 
end and adding another.





Progressively,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

From: Kerry, Richard [richard.ke...@atos.net]
Sent: 23 November 2012 17:09
To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: [docbook-apps] Title-page customization - is it just me ?




I'm sure it is me, but I can't seem to get this to work.



I want to customize my (PDF via FO) document.

I want to make the title-page a separate page, ie to insert a page-break.  My 
document is an article.

I'm using docbook-xsl-1.77.1 stylesheets, and Docbook 5.



Following the instructions in Bob's book I've taken a copy of 
fo\titlepage.templates.xml.

I process it using template\titlepage.xsl and Saxon 6-5-5.  I call the result 
mytitlepages.xsl.

If I then compare my mytitlepages.xsl with the supplied 
fo\titlepage.templates.xml I find that all the elements which are fo:block in 
the given file are block in my generated one.

For example :

published:  fo:block xmlns:fo=http://www.w3.org/1999/XSL/Format; 
font-family={$title.fontset}

against
generated:  block font-family={$title.fontset}

If I then import my generated file I get streams of error messages - the 
first of which is :

Error at fo:block on line 342 of 
file:/C:/Users/Richard/Downloads/DocBook/docbook-xsl-1.77.1/fo/refentry.xsl:
  No attribute-set exists named refnamediv.titlepage.recto.style

and the others are similar.

I am assuming these are being caused by this inconsistency in the xsl.



Can anyone advise what I might be doing wrong ?

I am assuming that as the published stylesheets have been around for a while 
they are right 

And that Bob's book is accurate.



Note that at this stage my local titlepage.templates.xml is unmodified, yet is 
showing this inconsistency.  I would expect processing the published 
titlepage.templates.xml would generate a copy of the published 
titlepage.templates.xsl.





Once I've got this aspect sorted my next task will be to work out exactly what 
I  need to put where to get a page-break after the article recto title page.







Puzzledly,

Richard.





PS,

Once I've got the title page on a separate page I'll want to move the revision 
history somewhere else, ie to near the end of the document.

Actually I want it at the end, since it would be before the Index, but there 
isn't an Index.

And then I'm going to want two separate Revision Histories, one for the 
document and one for the software to which it refers.






Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518

RE: [docbook-apps] RE: Epub3 - zip, or not ?

[Kerry, Richard]

The output is as follows (slightly edited for clarity - shortened some names, 
hope it's still clear)

java   -jar C:\EPubcheck\epubcheck-3.0b5\epubcheck-3.0b5.jar 
Output/alm_acq.epub
Epubcheck Version 3.0b5
Validating against EPUB version 3.0
WARNING: Output/alm_acq.epub/OEBPS/package.opf(16,39): date value '28 April 
2009' does not follow recommended syntax as per 
http://www.w3.org/TR/NOTE-datetime:[For input string: 28 April 2009] is not 
an integer
ERROR: Output/alm_acq.epub/OEBPS/package.opf(18,16): element dc:date not 
allowed here; expected the element end-tag or element dc:contributor, 
dc:coverage, dc:creator, dc:description, dc:format, dc:identifier, 
dc:language, dc:publisher, dc:relation, dc:rights, dc:source, 
dc:subject, dc:title, dc:type, link or meta
WARNING: Output/alm_acq.epub/OEBPS/package.opf(18,42): date value '19 November 
2003' does not follow recommended syntax as per 
http://www.w3.org/TR/NOTE-datetime:[For input string: 19 November 2003] is 
not an integer
Check finished with warnings or errors

It looks like the dc:date (or possibly meta property=dcterms:date) warnings 
are due to revision history entries with revision/date elements in the format 
'28 April 2009'  and '19 November 2003' .
Looking at 'www.w3.org/TR/NOTE-datetime' it looks like dates need to be in 
-MM-DD format.  I've found (in epub3/epub3-element-mode.xsl) !-- EPUB3 
meta date should be of the form:  , -MM or -MM-DD -- and !-- 
FIXME: this needs further work, so just return the date string for now --, so 
it looks like this format is missing a conversion of dates into the required 
format.

I am getting two dc:date elements in package.opf.  The ERROR above can be fixed 
by removing one of them.



The relevant part of package.opf is this (within the 'metadata' element):

  meta property=dcterms:date28 April 2009/meta
  dc:date28 April 2009/dc:date
  meta property=dcterms:date19 November 2003/meta
  dc:date19 November 2003/dc:date





Hope that helps,

Regards,

Richard.





Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.net
uk.atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



From: Carlos Araya [carlos.ar...@gmail.com]
Sent: 30 August 2012 21:41
To: Kerry, Richard
Cc: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: Re: [docbook-apps] RE: Epub3 - zip, or not ?



Richard:

There are some errors reported by epubcheck that are known to be fixed soon.

Could you post what are the errors you're getting from validation?

Carlos

On Thu, Aug 30, 2012 at 3:50 AM, Kerry, Richard richard.ke...@atos.net wrote:

 OK, so that wasn't quite what I'd done.
 I didn't really want to add zip's folder to my path as I'm not using it for 
 anything else, so I was actually running it by doing

 set zip=path-to\Info-Zip\zip232xn\zip.exe

 then not doing
 zip -r -X mybook.epub mimetype META-INF OEBPS

 but actually doing
 %zip% -r -X mybook.epub mimetype META-INF OEBPS

 And that gives the errors I showed before.
 If I add it to my path it is working.

 Though now I'm at step 4 - Validating with epubcheck 3
 and that is giving failures.


 Eventually,
 Richard.




 Richard Kerry
 BNCS Engineer
 T: +44 (0)20 82259063
 M: +44 (0)7812 325518
 Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
 richard.ke...@atos.net
 uk.atos.net

 This e-mail and the documents attached are confidential and intended solely 
 for the addressee; it may also be privileged. If you receive this e-mail in 
 error, please notify the sender immediately and destroy it. As its integrity 
 cannot be secured on the Internet, the Atos group liability cannot be 
 triggered for the message content. Although the sender endeavours to maintain 
 a computer virus-free network, the sender does not warrant that this 
 transmission is virus-free and will not be liable for any damages resulting 
 from any virus transmitted.

 
 From: Kerry, Richard
 Sent: 30 August 2012 11:22
 To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
 Subject: Epub3 - zip, or not ?

 I decided to try building an epub from my DocBook document, using epub3 .
 Following the instructions in the README.

 Step 1.  XSL (epub3/chunk.xsl) to generate Xhtml and other files.
 That seems to work fine.

 Step 2.  Copy in any image files.
 I wrote some XSL

RE: [docbook-apps] Epub3 - zip, or not ?

[Kerry, Richard]

zip is the Info-zip program to create and manipulate zip files.



I know that (and I already knew it), but 

note to the maintainers of the documentation - please state it explicitly; as I 
indicated I got the 'zip' is not recognized as an internal or external 
command, operable program or batch file. message as it isn't a standard 
operating system file.  Someone reading this who isn't a developer may not know 
what's meant.

Also please add a note to the effect that its folder *must* be in your path.  
Just adding a symbol pointing to zip.exe is not sufficient.  Presumably there 
is something else important in the folder.



I've been trying to get 7-zip to do the job.

Firstly it needs telling to do zip format, which can be done using -tzip.

However, it seems to be insisting on putting everything in the file in 
alphabetical order, which isn't accepted by epubcheck.



So for the moment the answer seems to be that 7-zip can't build epubs.  Unless 
someone can tell me how to sort out the ordering.





Unhelpfully,

Richard.










[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

From: Kevin O. Grover [ke...@kevingrover.net]
Sent: 31 August 2012 03:39
To: Kerry, Richard
Cc: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: Re: [docbook-apps] Epub3 - zip, or not ?

Zip is just a compression format.  zip is the Info-zip program to create and 
manipulate zip files.  7-zip can create zip files so you just need to adapt the 
CLI args to add the files you need to a zip archive with an extension of '.epub'

On Thu, Aug 30, 2012 at 3:22 AM, Kerry, Richard 
richard.ke...@atos.netmailto:richard.ke...@atos.net wrote:

I decided to try building an epub from my DocBook document, using epub3 .
Following the instructions in the README.

Step 1.  XSL (epub3/chunk.xsl) to generate Xhtml and other files.
That seems to work fine.

Step 2.  Copy in any image files.
I wrote some XSL to scan package.opf and generate a batch file to do the 
copy.
I don't think XSL (or Saxon) has a built-in ability to copy files, so I 
build a batch file then run it.

Step 3.  Zip it.
Ok, so I do the command as in the README -
zip -r -X mybook.epub mimetype META-INF OEBPS

And I get -
'zip' is not recognized as an internal or external command, operable program or 
batch file.

So - firstly, if referring to a program that isn't part of the operating 
system, please explain exactly what is meant.


Anyway, I thought I recognized the syntax as Info-Zip's zip (I normally use 
7-zip) so I set about getting a copy.
Ok, the download is FTP, which I haven't used for ages.  So install Filezilla 
and try and download an info-zip exe.
Eventually find an exe, from zip323xn.  Add its folder to my Path.

Then run it 
zip -r -X mybook.epub mimetype META-INF OEBPS

And now I get -
zip warning: multiple disk information ignored
path-to/Info-Zip/zip232xn/zip.exe: found a preamble of 20832 bytes
zip warning: name not matched: mybook.epub
zip I/O error: Permission denied
zip error: Could not create output file (path-to//Info-Zip/zip232xn/zip.exe)


Ok, so can someone tell me how to actually get this to work ?


And ..
Can 7-zip be used for this, if Info-zip's zip is going to give problems ?
I think I've seen somewhere that mimetype should be in the archive but not 
compressed.  Is this so ?
If so how do we get it not to compress certain files ?


Frustratedly,
Richard.







Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message

RE: [docbook-apps] Epub3 - zip, or not ?

[Kerry, Richard]

How far do you take this Kerry?
Insist that java be on the $PATH?

There's a lot of discussion in Bob's book, and elsewhere, about how to get Xslt 
processors working.  That tends to include a bit about getting Java running as 
so many are Java-based.

That permissions be set for local directories?
You wouldn't have got that far with them set wrong.

They are an issue that applies to (nearly) all computer work.  This is the 
first time ever, in many years working with computers, that I've found 
somethiing with a specific requirement of which zip utility is used.  (or which 
one isn't)

There has to be a break point somewhere.
Yes.
But the program in question is not standard in (probably) the most widely used 
operating system.  All I really wanted was slightly more information on what to 
use and how to get it going.  As I mentioned in another response my usual zip 
program, 7-zip, can't do the job.  I could have saved a morning's 
experimentation if someone had documented that.  A Google search shows that 
others have already discovered this so it'd be helpful if the central point for 
DocBook generation of epubs, ie the Readme file in the epub(3) directory of the 
docbook-xsl project, mentioned it.

And speaking as someone who doesn't like cluttering up the PATH with folders 
for rarely-used programs I always try and run things directly from their homes, 
rather than via path.  In this case (unusually I think) the program appears to 
work when run directly but turns out not to be able to run properly unless 
accessed via PATH, something discovered only after a period of experimentation.

it isn't a standard operating system file. It is, on my Operating System?

Oh, what operating system is that then ?
Don't think any version of Windows has it.

Shades of grey everywhere?

How many ?
It gets absolutely everywhere doesn't it ?
Aaarghh .  didn't think that could creep into this list !




Uncertainly,
Richard.




Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.net
uk.atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



From: DaveP [da...@dpawson.co.uk]
Sent: 31 August 2012 13:12
To: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Epub3 - zip, or not ?


On 08/31/2012 12:51 PM, Kerry, Richard wrote:


 zip is the Info-zip program to create and manipulate zip files.



 I know that (and I already knew it), but 

 note to the maintainers of the documentation - please state it explicitly; as 
 I indicated I got the 'zip' is not recognized as an internal or external 
 command, operable program or batch file. message as it isn't a standard 
 operating system file.  Someone reading this who isn't a developer may not 
 know what's meant.

 Also please add a note to the effect that its folder *must* be in your path.  
 Just adding a symbol pointing to zip.exe is not sufficient.  Presumably there 
 is something else important in the folder.


How far do you take this Kerry? Insist that java be on the $PATH? That
permissions be set for local directories?

There has to be a break point somewhere.
it isn't a standard operating system file. It is, on my Operating
System? Shades of grey everywhere?





regards

--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
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] Epub3 - zip, or not ?

[Kerry, Richard]

I decided to try building an epub from my DocBook document, using epub3 .
Following the instructions in the README.

Step 1.  XSL (epub3/chunk.xsl) to generate Xhtml and other files.
That seems to work fine.

Step 2.  Copy in any image files.
I wrote some XSL to scan package.opf and generate a batch file to do the 
copy.
I don't think XSL (or Saxon) has a built-in ability to copy files, so I 
build a batch file then run it.

Step 3.  Zip it.
Ok, so I do the command as in the README -
zip -r -X mybook.epub mimetype META-INF OEBPS

And I get -
'zip' is not recognized as an internal or external command, operable program or 
batch file.

So - firstly, if referring to a program that isn't part of the operating 
system, please explain exactly what is meant.


Anyway, I thought I recognized the syntax as Info-Zip's zip (I normally use 
7-zip) so I set about getting a copy.
Ok, the download is FTP, which I haven't used for ages.  So install Filezilla 
and try and download an info-zip exe.
Eventually find an exe, from zip323xn.  Add its folder to my Path.

Then run it 
zip -r -X mybook.epub mimetype META-INF OEBPS

And now I get -
zip warning: multiple disk information ignored
path-to/Info-Zip/zip232xn/zip.exe: found a preamble of 20832 bytes
zip warning: name not matched: mybook.epub
zip I/O error: Permission denied
zip error: Could not create output file (path-to//Info-Zip/zip232xn/zip.exe)


Ok, so can someone tell me how to actually get this to work ?


And ..
Can 7-zip be used for this, if Info-zip's zip is going to give problems ?
I think I've seen somewhere that mimetype should be in the archive but not 
compressed.  Is this so ?
If so how do we get it not to compress certain files ?


Frustratedly,
Richard.







Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063 
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.net
uk.atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

-
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: Epub3 - zip, or not ?

[Kerry, Richard]

OK, so that wasn't quite what I'd done.
I didn't really want to add zip's folder to my path as I'm not using it for 
anything else, so I was actually running it by doing 

set zip=path-to\Info-Zip\zip232xn\zip.exe

then not doing 
zip -r -X mybook.epub mimetype META-INF OEBPS

but actually doing 
%zip% -r -X mybook.epub mimetype META-INF OEBPS

And that gives the errors I showed before.
If I add it to my path it is working.

Though now I'm at step 4 - Validating with epubcheck 3
and that is giving failures.


Eventually,
Richard.




Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.net
uk.atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


From: Kerry, Richard
Sent: 30 August 2012 11:22
To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
Subject: Epub3 - zip, or not ?

I decided to try building an epub from my DocBook document, using epub3 .
Following the instructions in the README.

Step 1.  XSL (epub3/chunk.xsl) to generate Xhtml and other files.
That seems to work fine.

Step 2.  Copy in any image files.
I wrote some XSL to scan package.opf and generate a batch file to do the 
copy.
I don't think XSL (or Saxon) has a built-in ability to copy files, so I 
build a batch file then run it.

Step 3.  Zip it.
Ok, so I do the command as in the README -
zip -r -X mybook.epub mimetype META-INF OEBPS

And I get -
'zip' is not recognized as an internal or external command, operable program or 
batch file.

So - firstly, if referring to a program that isn't part of the operating 
system, please explain exactly what is meant.


Anyway, I thought I recognized the syntax as Info-Zip's zip (I normally use 
7-zip) so I set about getting a copy.
Ok, the download is FTP, which I haven't used for ages.  So install Filezilla 
and try and download an info-zip exe.
Eventually find an exe, from zip323xn.  Add its folder to my Path.

Then run it 
zip -r -X mybook.epub mimetype META-INF OEBPS

And now I get -
zip warning: multiple disk information ignored
path-to/Info-Zip/zip232xn/zip.exe: found a preamble of 20832 bytes
zip warning: name not matched: mybook.epub
zip I/O error: Permission denied
zip error: Could not create output file (path-to//Info-Zip/zip232xn/zip.exe)


Ok, so can someone tell me how to actually get this to work ?


And ..
Can 7-zip be used for this, if Info-zip's zip is going to give problems ?
I think I've seen somewhere that mimetype should be in the archive but not 
compressed.  Is this so ?
If so how do we get it not to compress certain files ?


Frustratedly,
Richard.







Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.net
uk.atos.net

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

-
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] export from MS Excel to DocBook?

[Kerry, Richard]

Not knowing about the xlsx (sic) unpacking facility in Saxon, and having had no 
success trying to automate Excel internally, I've recently written a simple C++ 
program to take an Excel spreadsheet file and convert it to XML.  From there 
I'm using Xsl to generate the Xml I really want.

As it's a program I've written for work I can't publish it, though it is really 
quite simple.  Access Excel using COM.  Scan all worksheets, scan all rows, 
scan all columns, and write the text in the cells to Xml using Msxml.  Took 
about an afternoon to get it working.

Maybe now I'll see if I can get anything useful from the xlsx file directly 
using Saxon

Unhelpfully,
Richard.




 -Original Message-
 From: Jirka Kosek [mailto:ji...@kosek.cz] 
 Sent: 16 August 2012 09:02
 To: robert.buer...@bmw.de
 Cc: docbook-apps@lists.oasis-open.org
 Subject: Re: [docbook-apps] export from MS Excel to DocBook?
 
 On 16.8.2012 9:23, robert.buer...@bmw.de wrote:
 
  Has anybody any experience with this? Any pointers?
 
 XSLT 2.0 has powerfull grouping instruction xsl:for-each-group. With
 that instruction and Excel file saved as .xslx it's fairly easy to
 produce output you want. Also Saxon9 (XSLT 2.0 
 implementation) can read
 directly content of .xsls files there is no need to unpack them first.
 Simply use something like
 
 doc('jar:table.xslx!!/_rels/.rels')
 
 to access parts of XSLX file.
 
   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 member
 --
 
 

-
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] Striped tables in Html Help

[Kerry, Richard]

I'd like to apply a striped effect to some tables that I'm creating in some 
Html-Help (ie chm) that I'm generating from DocBook.



Has anyone already done this ?

Is there a setting already available or will I need to customize something ?   
In which case what ?

(I'd also like to do it in a Revision History table)



Presumably it's a matter of having two styles and getting the stylesheet to 
apply them to alternate entries (tr's).  So I need also to be able to count the 
number of preceeding entries, though that seems like it'll just be a 
count(preceeding-sibling::*).



Apparently there's a tr:nth-child control in CSS3 but as I'm doing chm that's 
effectively IE and reported as not available there.





Regards,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Striped tables in Html Help

[Kerry, Richard]

Bob,

Thank you, that would seem to be exactly it !



In this instance Google wasn't my friend .

(probably didn't find the right search terms)





Appreciatively,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

From: Bob Stayton [b...@sagehill.net]
Sent: 10 August 2012 18:34
To: Kerry, Richard; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Striped tables in Html Help

Do you mean something like what is described here:

http://www.sagehill.net/docbookxsl/BGtableColor.html#TableRowBackground

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net


- Original Message -
From: Kerry, Richardmailto:richard.ke...@atos.net
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]â€?
Sent: Friday, August 10, 2012 10:07 AM
Subject: [docbook-apps] Striped tables in Html Help




I'd like to apply a striped effect to some tables that I'm creating in some 
Html-Help (ie chm) that I'm generating from DocBook.



Has anyone already done this ?

Is there a setting already available or will I need to customize something ?   
In which case what ?

(I'd also like to do it in a Revision History table)



Presumably it's a matter of having two styles and getting the stylesheet to 
apply them to alternate entries (tr's).  So I need also to be able to count the 
number of preceeding entries, though that seems like it'll just be a 
count(preceeding-sibling::*).



Apparently there's a tr:nth-child control in CSS3 but as I'm doing chm that's 
effectively IE and reported as not available there.





Regards,

Richard.








Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org


blank
Description: blank

-
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] What is Xml ?

[Kerry, Richard]

Please can someone direct me to an authoritative explanation of what 
constitutes a valid XML file ?
I've been provided with some XML files which are a bit like this :

?xml?
category id=information
 section id=general
  element id=fileinfo /
 /section
/category
category id=device
 section id=Status
  element id=1 /
  element id=2 /
 /section
/category

They are described as XML, together with a note that ... file can be created 
using any XML editor providing the format and tags required are used, though I 
get various errors from emacs+nxml-mode, XmlMind and Serna.
I think that they are not well-formed, on account of having two root nodes.
I'm also a bit surprised by the lack of the usual version, encoding and 
standalone attributes in the xml PI, though I suspect they are actually 
optional.
And I've just found that it starts with (hex) ef bb bf, before the ? - is 
that a byte-order mark ?  Or just another non-standardness ?


I will need to pass this back to the originators so that they can either :
1.  Change their software to produce/use real XML.
or:
2.  Change their documentation to refer to XML-like or similar.

In the meantime I'll need to do some sort of processing to get it into a form 
that I can process.


Appreciatively,
Richard.





[Blue line]
Richard Kerry
BNCS Engineer

T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

 [Atos logo]

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

inline: Atos_EmailBlueLine.gifinline: Atos_EmailLogo.gif

RE: [docbook-apps] What is Xml ?

[Kerry, Richard]

Stefan,

Thanks for that, but I know most of it already.

The issue is that if I'm to get the supplier to change their software or docs 
I'll need to be able refer to an authoritative source.


Appreciatlvely,
Richard.



 -Original Message-
 From: Stefan Hinz [mailto:stefan.h...@oracle.com] 
 Sent: 30 July 2012 13:45
 To: docbook-apps@lists.oasis-open.org
 Subject: Re: [docbook-apps] What is Xml ?
 
 
 Hi Richard,
  
   Please can someone direct me to an authoritative 
 explanation of what
  constitutes a valid XML file ?
 
 Let me try with expert knowledge freshly gained from Wikipedia 
 (http://en.wikipedia.org/wiki/XML#Well-formedness_and_error-handling).
 
 For your below document, this means:
 
 * The ?xml? prolog is optional.
 * There's no single root element that contains all the 
 other elements. 
 Therefore, the XML isn't well-formed, and thus not valid.
 
 HTH.
 
 Cheers,
 
 Stefan
 
  I've been provided with some XML files which are a bit like this :
  ?xml?
  category id=information
section id=general
 element id=fileinfo /
/section
  /category
  category id=device
section id=Status
 element id=1 /
 element id=2 /
/section
  /category
  They are described as XML, together with a note that ... 
 file can be
  created using any XML editor providing the format and tags 
 required are
  used, though I get various errors from emacs+nxml-mode, 
 XmlMind and Serna.
  I think that they are not well-formed, on account of having 
 two root
  nodes.
  I'm also a bit surprised by the lack of the usual version, 
 encoding and
  standalone attributes in the xml PI, though I suspect they 
 are actually
  optional.
  And I've just found that it starts with (hex) ef bb bf, 
 before the ?
  - is that a byte-order mark ?  Or just another non-standardness ?
  I will need to pass this back to the originators so that 
 they can either :
  1.  Change their software to produce/use real XML.
  or:
  2.  Change their documentation to refer to XML-like or similar.
  In the meantime I'll need to do some sort of processing to 
 get it into a
  form that I can process.
  Appreciatively,
  Richard.
  Blue line
 
  *Richard Kerry*
 
  BNCS Engineer
 
  T: +44 (0)20 82259063
 
  M: +44 (0)7812 325518
 
  Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
 
  richard.ke...@atos.net mailto:richard.ke...@atos.net
 
  uk.atos.net http://uk.atos.net/en-uk/
 
  Atos logo
 
  This e-mail and the documents attached are confidential and intended
  solely for the addressee; it may also be privileged. If you 
 receive this
  e-mail in error, please notify the sender immediately and 
 destroy it. As
  its integrity cannot be secured on the Internet, the Atos group
  liability cannot be triggered for the message content. Although the
  sender endeavours to maintain a computer virus-free 
 network, the sender
  does not warrant that this transmission is virus-free and 
 will not be
  liable for any damages resulting from any virus transmitted.
 
 
 
 -- 
 Cheers,
 
 Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager
 
 Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc
 
 ORACLE Deutschland B.V.  Co. KG
 Registered Office: Riesstr. 25, 80992 Muenchen, Germany
 Commercial Register: Local Court Of Munich, HRA 95603
 Managing Director: Jürgen Kunz
 
 General Partner: ORACLE Deutschland Verwaltung B.V.
 Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
 Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
 Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher
 
 -
 To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
 For additional commands, e-mail: 
 docbook-apps-h...@lists.oasis-open.org
 

-
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] Saxon 6 or 9 ? And extensions - extensions/saxon65 or use docbook-xsl-saxon

[Kerry, Richard]

Just putting together a new DocBook system using Saxon.

Using Docbook 5.   (5.1 still looks to be beta)

Should I be using Saxon 6 or 9 ?
And if 6 I note that there are some extensions available.  In that case do I 
just need what's in extensions (ie extensions/saxon65.jar) or should I use 
docbook-xsl-saxon-1.0 ?  (is there anything else that docbook-xsl-saxon gives 
me that I might need ?).
If Saxon 9 are there any extensions I need ?

Appreciatively,

Richard.

PS.  Sent this on Friday and it doesn't seem to have got through.  Apologies if 
it comes through twice.
And wondering if any knows why this keeps happening to me ?




[Blue line]
Richard Kerry
BNCS Engineer

T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

 [Atos logo]

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

inline: att7495a.gifinline: att7496b.gif

[docbook-apps] Saxon 6 or 9 ? And extensions - extensions/saxon65 or use docbook-xsl-saxon

[Kerry, Richard]

Just putting together a new DocBook system using Saxon.



Using Docbook 5.   (5.1 still looks to be beta)



Should I be using Saxon 6 or 9 ?

And if 6 I note that there are some extensions available.  In that case do I 
just need what's in extensions (ie extensions/saxon65.jar) or should I use 
docbook-xsl-saxon-1.0 ?  (is there anything else that docbook-xsl-saxon gives 
me that I might need ?).

If Saxon 9 are there any extensions I need ?







Appreciatlvely,

Richard.






[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Where'a the names of the top-level stylesheets ?

[Kerry, Richard]

Are you sure ?

I'm looking at docbook-xsl-ns-1.77.1/README

There are sections : Background, How these stylesheets were produced, How to 
use these stylesheets, Customizing these stylesheets, Report any problems.
In none of them can I see the list of file-names I'm expecting (and that I am 
quite sure I have seen sometime in the past).


Uncertainly,
Richard.




From: Bob Stayton [mailto:b...@sagehill.net]
Sent: 09 July 2012 08:13
To: DocBook Apps
Subject: Re: [docbook-apps] Where'a the names of the top-level stylesheets ?

Hi Richard,
The README file in the top level directory of the stylesheets shows the 
filename for each output's main stylesheet file.

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net


- Original Message -
From: Kerry, Richardmailto:richard.ke...@atos.net
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]‎
Sent: Friday, July 06, 2012 10:43 AM
Subject: [docbook-apps] Where'a the names of the top-level stylesheets ?




Bit of a beginner question here, I think





I've just downloaded and unpacked the 1.77 stylesheets (ns) from Sourceforge.



I can't find the documentation of which are the top-level stylesheets (ie the 
file-names for them).



Can someone tell me where to find them; I'm sure there used to be something in 
the docs to tell me the starting point for each output type ?



I'm sure it's staring me in the face but I can't seem to see it 







Uncertainly,

Richard.






Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



-
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] Where'a the names of the top-level stylesheets ?

[Kerry, Richard]

Are you sure ?

I'm looking at docbook-xsl-ns-1.77.1/README

There are sections : Background, How these stylesheets were produced, How to 
use these stylesheets, Customizing these stylesheets, Report any problems.
In none of them can I see the list of file-names I'm expecting (and that I am 
quite sure I have seen sometime in the past).


Uncertainly,
Richard.


PS.  Seem to have some problem posting to the list.  Apologies if this turns up 
twice.



From: Bob Stayton [mailto:b...@sagehill.net]
Sent: 09 July 2012 08:13
To: DocBook Apps
Subject: Re: [docbook-apps] Where'a the names of the top-level stylesheets ?

Hi Richard,
The README file in the top level directory of the stylesheets shows the 
filename for each output's main stylesheet file.

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net


- Original Message -
From: Kerry, Richardmailto:richard.ke...@atos.net
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]‎
Sent: Friday, July 06, 2012 10:43 AM
Subject: [docbook-apps] Where'a the names of the top-level stylesheets ?




Bit of a beginner question here, I think





I've just downloaded and unpacked the 1.77 stylesheets (ns) from Sourceforge.



I can't find the documentation of which are the top-level stylesheets (ie the 
file-names for them).



Can someone tell me where to find them; I'm sure there used to be something in 
the docs to tell me the starting point for each output type ?



I'm sure it's staring me in the face but I can't seem to see it 







Uncertainly,

Richard.






Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



-
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] Where's the names of the top-level stylesheets ?

[Kerry, Richard]

Ok, I've found it.
The information I'm looking for is actually in docbook-xsl-1.77.1/README.
I.e. it is not present in the namespaced file-set.

May I suggest that even if it remains that way there should be a reference from 
the ns README to the old one.  Otherwise the namespaced files can't really be 
used in isolation.  Or is that the intention ?


Regards,
Richard.



From: Kerry, Richard
Sent: 09 July 2012 15:46
To: DocBook Apps
Subject: RE: [docbook-apps] Where'a the names of the top-level stylesheets ?


Are you sure ?

I'm looking at docbook-xsl-ns-1.77.1/README

There are sections : Background, How these stylesheets were produced, How to 
use these stylesheets, Customizing these stylesheets, Report any problems.
In none of them can I see the list of file-names I'm expecting (and that I am 
quite sure I have seen sometime in the past).


Uncertainly,
Richard.


PS.  Seem to have some problem posting to the list.  Apologies if this turns up 
twice.



From: Bob Stayton [mailto:b...@sagehill.net]
Sent: 09 July 2012 08:13
To: DocBook Apps
Subject: Re: [docbook-apps] Where'a the names of the top-level stylesheets ?

Hi Richard,
The README file in the top level directory of the stylesheets shows the 
filename for each output's main stylesheet file.

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net


- Original Message -
From: Kerry, Richardmailto:richard.ke...@atos.net
To: DocBook Apps Mailing List 
‎[docbook-apps@lists.oasis-open.org]‎mailto:docbook-apps@lists.oasis-open.org]‎
Sent: Friday, July 06, 2012 10:43 AM
Subject: [docbook-apps] Where'a the names of the top-level stylesheets ?




Bit of a beginner question here, I think





I've just downloaded and unpacked the 1.77 stylesheets (ns) from Sourceforge.



I can't find the documentation of which are the top-level stylesheets (ie the 
file-names for them).



Can someone tell me where to find them; I'm sure there used to be something in 
the docs to tell me the starting point for each output type ?



I'm sure it's staring me in the face but I can't seem to see it 







Uncertainly,

Richard.






Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.



-
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] Where'a the names of the top-level stylesheets ?

[Kerry, Richard]

Bit of a beginner question here, I think





I've just downloaded and unpacked the 1.77 stylesheets (ns) from Sourceforge.



I can't find the documentation of which are the top-level stylesheets (ie the 
file-names for them).





Can someone tell me where to find them; I'm sure there used to be something in 
the docs to tell me the starting point for each output type ?



I'm sure it's staring me in the face but I can't seem to see it 







Uncertainly,

Richard.








[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Complete Guide - 5th Edition ?

[Kerry, Richard]

I note that Bob's DocBook XSL: The Complete Guide is currently at its Fourth 
Edition, dated 2007.



Is there any expectation of a fifth edition in the near future ?





Or perhaps a specific reason why that won't happen ?







Appreciatively,

Richard.






[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Where'a the names of the top-level stylesheets ?

[Kerry, Richard]

Bit of a beginner question here, I think





I've just downloaded and unpacked the 1.77 stylesheets (ns) from Sourceforge.



I can't find the documentation of which are the top-level stylesheets (ie the 
file-names for them).



Can someone tell me where to find them; I'm sure there used to be something in 
the docs to tell me the starting point for each output type ?



I'm sure it's staring me in the face but I can't seem to see it 







Uncertainly,

Richard.






[Blue line]
Richard Kerry
BNCS Engineer
T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=mailto%3arichard.kerry%40atos.net
uk.atos.nethttps://webmail.siemens-it-solutions.com/owa/redir.aspx?C=9fb20d019e3e4cb99344d708709a3177URL=http%3a%2f%2fuk.atos.net%2fen-uk%2f
[Atos logo]
This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.


attachment.ashx
Description: attachment.ashx


attachment.ashx
Description: attachment.ashx

-
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] Setting up a DocBook system

[Kerry, Richard]

Team,

I am setting up a Docbook system.
When I did so for the first time for some tests a couple of years ago I didn't 
worry too much about whether everything was done using the best tools, or in 
the best way.
This time I want to be a bit more certain I'm doing things the best way and not 
missing anything.  I want to produce a susyem that colleagues can use and 
foresee resistence if it is more difficult than it needs to be.

I've started out by looking at Bob Stayton's book on-line.  But, I think it is 
a bit out of date.
Can anyone direct me to any more up-to-date Getting Started guides ?
Or Bob, is there any chance that you might update your on-line book, in 
particular the version numbers referenced for Saxon and Fop ?  And the class 
names to use (The section on Saxon still refers to version 6 and the ICL 
version of the class-name).





Appreciatively,
Richard.





[Blue line]
Richard Kerry
BNCS Engineer

T: +44 (0)20 82259063
M: +44 (0)7812 325518
Room 457 Drama Building, BBC Television Centre, Wood Lane, London, W12 7RJ
richard.ke...@atos.netmailto:richard.ke...@atos.net
uk.atos.nethttp://uk.atos.net/en-uk/

 [Atos logo]

This e-mail and the documents attached are confidential and intended solely for 
the addressee; it may also be privileged. If you receive this e-mail in error, 
please notify the sender immediately and destroy it. As its integrity cannot be 
secured on the Internet, the Atos group liability cannot be triggered for the 
message content. Although the sender endeavours to maintain a computer 
virus-free network, the sender does not warrant that this transmission is 
virus-free and will not be liable for any damages resulting from any virus 
transmitted.

inline: Atos_EmailBlueLine.gifinline: Atos_EmailLogo.gif

[docbook-apps] Different params for different outputs .....

[Kerry, Richard]

 
Team,
 
I have a DocBook source file that includes a reference to a png file for
a diagram.
 
When I generate a pdf file from it (via FO using FOP) I need to specify
a scaling.
ie
imagedata fileref=./Diagrams/Flowchart.png scale=35 /
 
When I generate an html file I don't.
ie
imagedata fileref=./Diagrams/Flowchart.png /
 
What's my best way to handle this ?  
Of course I don't want to have two separate DocBook source files for the
two output formats.
 
 
Regards,
Richard.
 
 
 

Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Drama Building, BBC Television Centre, Wood Lane, London, W12
7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
Email: richard.ke...@siemens.com
blocked::mailto:richard.ke...@siemens.com 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for the exclusive
use of the addressee/s.  If you are not the addressee, then any
distribution, copying or use of this e-mail is prohibited. If received
in error, please advise the sender and delete it immediately.  We accept
no liability for any loss or damage suffered by any person arising from
use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens Square, Frimley,
Camberley, GU16 8QD

 

RE: [docbook-apps] Using draft images with fop, and catalogs.

[Kerry, Richard]

 
Bob,
 
I can see how to add the Resolver and Catalog Manager paths to the local
class-path in fop.bat (LOCALCLASSPATH).
But its not clear to me how to pass in the resolver options (-x, -y, -r)
- JAVOPTS or FOP_CMD_LINE_ARGS ?  
If these are specific to Saxon then there's surely no way Fop could make
any use of them ?  Although I'd expect they might be generic Java
facilities but my knowledge of Java is very minimal and I don't know how
to pass in all the required parameters.
 
Could you perhaps post a few lines from your fop.bat as an example.
 
Uncertainly,
Richard.
 




From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: 04 February 2009 17:54
To: Kerry, Richard; Docbook Apps
Subject: Re: [docbook-apps] Using draft images with fop, and
catalogs.


Hi Richard,
I don't think FOP has direct support for XML catalogs, but it
can be added to the java command that executes FOP's java classes.  I
generally edit the FOP convenience script (fop.bat or fop.sh) to enhance
the java.exe command to add the catalog resolver options -x, -y, -r, and
to extend the java CLASSPATH to find resolver.jar and
CatalogManager.properties.  
  
Bob Stayton
Sagehill Enterprises
b...@sagehill.net
 
 

- Original Message - 
From: Kerry, Richard mailto:richard.ke...@siemens.com

To: Docbook Apps
mailto:docbook-apps@lists.oasis-open.org  
Sent: Wednesday, February 04, 2009 9:20 AM
Subject: RE: [docbook-apps] Using draft images with fop,
and catalogs.

Bob,
Thanks for the advice.
I realized that the XSL processor didn't open the
graphic file but I was wondering whether, since the stylesheet writes
out the FO file, maybe there was something in the stylesheet that might
vary what gets written out for use by the FO processor.
I'll enquire on the FOP list about how to get it to use
catalogs as I can't see anything in the documentation.
 
Appreciatively,
Richard.
 




From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: 04 February 2009 17:00
To: Kerry, Richard; Docbook Apps
Subject: Re: [docbook-apps] Using draft images
with fop, and catalogs.


The XML catalog file is used when a file is
actually opened for use. In the case of graphics in XSL-FO output, the
DocBook stylesheet does not open the graphic files, the XSL-FO processor
does.  So you need to  configure your XSL-FO processor to use your
catalog file.  There is a similar issue for resolving the DTD reference
that is in some SVG files.  There is a short example in my book for
setting up a catalog in XEP, but it would be similar for FOP.
 

http://www.sagehill.net/docbookxsl/SVGimages.html#SvgDtd
 
Bob Stayton
Sagehill Enterprises
b...@sagehill.net
 
 

- Original Message - 
From: Kerry, Richard
mailto:richard.ke...@siemens.com  
To: Docbook Apps
mailto:docbook-apps@lists.oasis-open.org  
Sent: Wednesday, February 04, 2009 4:52
AM
Subject: [docbook-apps] Using draft
images with fop, and catalogs.

 
I am using Saxon and FOP to generate PDF
files from DocBook.  And I'm using a draft image.
My customized stylesheet for DocBook-FO
includes a value for the parameter draft.watermark.image.  It is
currently the full local path to the draft.png file that I am using (ie
somethiing like C:/DocBook/docbook-xsl-1.74.0/images/draft.png)
I would like to change it to be a url
(or is it a uri), probably using the catalog resolving mechanism that is
available in Saxon using the -x, -y, -r, -u qualifiers.  
 
I notice that at the moment the filename
value appears in the FO file in the form url(images/drft.png) when I
set draft.watermark.image to images/draft.png in my custom xsl file.
Thus I presume that the stylesheet is just copying over the parameter
value and putting it in url().
 
Can someone advise how to go about doing
this.  Do I need to tell the XSL stylesheet to change the format of what
it inserts in the FO ?  Or do I need to tell FOP that it's a URL

[docbook-apps] Using draft images with fop, and catalogs.

[Kerry, Richard]

 
I am using Saxon and FOP to generate PDF files from DocBook.  And I'm
using a draft image.
My customized stylesheet for DocBook-FO includes a value for the
parameter draft.watermark.image.  It is currently the full local path to
the draft.png file that I am using (ie somethiing like
C:/DocBook/docbook-xsl-1.74.0/images/draft.png)
I would like to change it to be a url (or is it a uri), probably using
the catalog resolving mechanism that is available in Saxon using the -x,
-y, -r, -u qualifiers.  
 
I notice that at the moment the filename value appears in the FO file in
the form url(images/drft.png) when I set draft.watermark.image to
images/draft.png in my custom xsl file.  Thus I presume that the
stylesheet is just copying over the parameter value and putting it in
url().
 
Can someone advise how to go about doing this.  Do I need to tell the
XSL stylesheet to change the format of what it inserts in the FO ?  Or
do I need to tell FOP that it's a URL/URI and to use the resolver ?
 
Uncertainly,
Richard.
 
 
 

Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Drama Building, BBC Television Centre, Wood Lane, London, W12
7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
Email: richard.ke...@siemens.com
blocked::mailto:richard.ke...@siemens.com 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for the exclusive
use of the addressee/s.  If you are not the addressee, then any
distribution, copying or use of this e-mail is prohibited. If received
in error, please advise the sender and delete it immediately.  We accept
no liability for any loss or damage suffered by any person arising from
use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens Square, Frimley,
Camberley, GU16 8QD

 

RE: [docbook-apps] Using draft images with fop, and catalogs.

[Kerry, Richard]

Bob,
Thanks for the advice.
I realized that the XSL processor didn't open the graphic file but I was
wondering whether, since the stylesheet writes out the FO file, maybe
there was something in the stylesheet that might vary what gets written
out for use by the FO processor.
I'll enquire on the FOP list about how to get it to use catalogs as I
can't see anything in the documentation.
 
Appreciatively,
Richard.
 




From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: 04 February 2009 17:00
To: Kerry, Richard; Docbook Apps
Subject: Re: [docbook-apps] Using draft images with fop, and
catalogs.


The XML catalog file is used when a file is actually opened for
use. In the case of graphics in XSL-FO output, the DocBook stylesheet
does not open the graphic files, the XSL-FO processor does.  So you need
to  configure your XSL-FO processor to use your catalog file.  There is
a similar issue for resolving the DTD reference that is in some SVG
files.  There is a short example in my book for setting up a catalog in
XEP, but it would be similar for FOP.
 
http://www.sagehill.net/docbookxsl/SVGimages.html#SvgDtd
 
Bob Stayton
Sagehill Enterprises
b...@sagehill.net
 
 

- Original Message - 
From: Kerry, Richard mailto:richard.ke...@siemens.com

To: Docbook Apps
mailto:docbook-apps@lists.oasis-open.org  
Sent: Wednesday, February 04, 2009 4:52 AM
Subject: [docbook-apps] Using draft images with fop, and
catalogs.

 
I am using Saxon and FOP to generate PDF files from
DocBook.  And I'm using a draft image.
My customized stylesheet for DocBook-FO includes a
value for the parameter draft.watermark.image.  It is currently the full
local path to the draft.png file that I am using (ie somethiing like
C:/DocBook/docbook-xsl-1.74.0/images/draft.png)
I would like to change it to be a url (or is it a uri),
probably using the catalog resolving mechanism that is available in
Saxon using the -x, -y, -r, -u qualifiers.  
 
I notice that at the moment the filename value appears
in the FO file in the form url(images/drft.png) when I set
draft.watermark.image to images/draft.png in my custom xsl file.  Thus
I presume that the stylesheet is just copying over the parameter value
and putting it in url().
 
Can someone advise how to go about doing this.  Do I
need to tell the XSL stylesheet to change the format of what it inserts
in the FO ?  Or do I need to tell FOP that it's a URL/URI and to use the
resolver ?
 
Uncertainly,
Richard.
 
 
 

Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Drama Building, BBC Television Centre, Wood
Lane, London, W12 7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44
(0)7921 244993
Email: richard.ke...@siemens.com
blocked::mailto:richard.ke...@siemens.com 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for
the exclusive use of the addressee/s.  If you are not the addressee,
then any distribution, copying or use of this e-mail is prohibited. If
received in error, please advise the sender and delete it immediately.
We accept no liability for any loss or damage suffered by any person
arising from use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens
Square, Frimley, Camberley, GU16 8QD

 

RE: [docbook-apps] documenting code

[Kerry, Richard]

 

 
 Is it the same problem? A command line for Windows wouldn't work
 since (AFAIK) there is no continuation character?
 


The continuation character for Windows is ^



Helpfully,
Richard.



-
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] DocBook to Microsoft Help File - all linked files being included

[Kerry, Richard]

 
I've just been working on a document and I find some behaviour I'd like
to stop.
 
I'm writing some instructions for a process.
Part of the instructions concerns software to install and I've included
ulink elements pointing to a selection of zip files.
This is all fine when generating a single html file or a pdf.  The
resulting files are reasonable in size and the links are genuine links
on the web, or links to one of our local servers.
However, when I generate a Microsoft compiled html help file, all the
zip files are included in the resultant chm file.  Which as a result is
very much larger than the other two formats (16Mb against a few hundred
Kb).  I would like to stop this happening.
Of course the whole point of a chm file is that it is a mini web-site
all in one file, but for some items, which start off as DocBook ulink
elements I'd like this not to happen.
Can I put anything in the DocBook source to stop this happening ?
Or is there something I can do when calling hhc ?
 
Appreciatively,
Richard.
 
 

Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Design Building, BBC Television Centre, Wood Lane, London, W12
7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
Email: [EMAIL PROTECTED]
blocked::mailto:[EMAIL PROTECTED] 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for the exclusive
use of the addressee/s.  If you are not the addressee, then any
distribution, copying or use of this e-mail is prohibited. If received
in error, please advise the sender and delete it immediately.  We accept
no liability for any loss or damage suffered by any person arising from
use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens Square, Frimley,
Camberley, GU16 8QD

 

RE: [docbook-apps] FW: long Tables in docbook using FOP

[Kerry, Richard]

See the thread I started on 17/12/2007, Headed  Fop unable to render
tables ?  (without intervention ?).
 
The outcome is that you need to put a processing instruction
?dbfo keep-together=auto ?
In your FO.
And I think you need to use the latest snapshot version of the xsl
stylesheets from Sourceforge to get this done from docbook without
intervention (ie manually editing in the above PI) as 1.73.2 doesn't
support it.
 
And this leads to a question I've been meaning to ask since I got the
tables working..
 
 
*** Why is the default setting that Long Tables Do Not Work ?
 
This seems to me to be useless in all circumstances.
 
Surely there are two options with a long table (ie a table that will
take more than one page)
1.
Unconditional.
Start at current position and insert page breaks wherever necessary.
2.
Unconditional.
Start after next page break and then insert page breaks wherever
necessary.
 
The default behaviour is currently : Don't put page breaks the table at
all.  Irrespective of whether it ought to take more than a page to
complete.
 
 
For a short table, ie one that fits on a single page, the options are :
1.
Unconditional.
Start at current position.
A page break may actually be necessary if we started near the bottom of
a page.
2.
Unconditional.
Start after next page break.
If we're saying this table is less than a page long then page breaks
will not be necessary.
3.
Conditional.
If the table will fit on the current page, put it there.
If it won't fit on the current page, start it after the next page break.
 
 
So again, my question, slightly rephrased, is :
*** What is the point of the default setting being that Long Tables Do
Not Work ?
 
Uncertainly,
Richard.
 
 
 




From: David White [mailto:[EMAIL PROTECTED] 
Sent: 11 February 2008 21:33
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] FW: long Tables in docbook using FOP




Greetings,
 
I'm using the latest docbook and FOP and have some valid
XML that includes a table
that spans more than 1 page.
 
The content is running off the foot of the first page
and is not rendering on the second page.
 
 
My parmeter settings:
   xsl:param name=use.extensions1/xsl:param
  xsl:param name=xep.extensions1/xsl:param
  xsl:param name=fop1.extensions1/xsl:param
 
attribute-sets:
xsl:attribute-set name=formal.object.properties
  xsl:attribute
name=keep-together.within-columnauto/xsl:attribute
/xsl:attribute-set
 
 xsl:attribute-set name=table.table.properties
  xsl:attribute name=space-after8pt/xsl:attribute
  xsl:attribute name=space-before0pt/xsl:attribute
  xsl:attribute
name=space-before.conditionalityretain/xsl:attribute
  xsl:attribute
name=space-before.precedenceforce/xsl:attribute
  xsl:attribute name=clearxsl:choosexsl:when
test=../@pgwide = 1 or @pgwide =
1both/xsl:whenxsl:otherwiseinherit/xsl:otherwise/xsl:choose/x
sl:attribute
  xsl:attribute name=spanxsl:choosexsl:when
test=../@pgwide = 1 or @pgwide =
1all/xsl:whenxsl:otherwiseinherit/xsl:otherwise/xsl:choose/xs
l:attribute
  xsl:attribute
name=space-after.conditionalityretain/xsl:attribute
  xsl:attribute
name=space-after.precedenceforce/xsl:attribute
  xsl:attribute
name=keep-together.within-columnauto/xsl:attribute
 /xsl:attribute-set

xsl:attribute-set name=table.properties
  xsl:attribute
name=keep-together.within-columnauto/xsl:attribute
/xsl:attribute-set
 
 
Everything else uses standard docbook stylesheet code.
 
When I use informaltable it works...but I loose my
title which I really need.
 
Any suggestions?
 
Thanks,
 
David White






Need to know the score, the latest news, or you need your
Hotmail(r)-get your fix. Check it out.
http://www.msnmobilefix.com/Default.aspx  

RE: [docbook-apps] Fop unable to render tables ? (without intervention ?)

[Kerry, Richard]

 
I've tried setting fop1.extensions but I don't think it does anything
for me regarding tables.
It generates a bookmark-tree and gives a region the name blank-body.

One problem I'd had was that I'd missed the colspec elements within
the tgroup.  Having added those I'm no longer getting the many
warnings about table-layout.

However, I am still gettting Fop attempting to place each table on one
page only, and I get the warnings shown below for the two long tables.
I did get these when I sent my earlier message on this subject but
thought the other messages, with their many repetitions, were more
important, so I neglected to include them in my posting.  I think
actually these are the most significant in that they are telling me
directly that it has placed the long tables on single pages.  There's
nothing I can see in DocBook, or Chapter 30 of Rob Stayton's book, to
indicate that I need to tell it to split a table over multiple pages -
indeed I'd have thought it would default to doing so.  And I can't find
any attributes or anything that looks like it will enable splitting
tables across pages.



These are the two warning messages that tell me directly that there are
tables on pages 3 and 6 that can't be fitted onto the single page.

17-Dec-2007 13:34:20 org.apache.fop.layoutmgr.PageBreaker$1
notifyOverflow
WARNING: Content of the region-body on page 6 overflows the available
area in block-progression dimension. (fo:page-sequence, location:
237/61)
17-Dec-2007 13:34:20 org.apache.fop.layoutmgr.PageBreaker$1
notifyOverflow
WARNING: Content of the region-body on page 3 overflows the available
area in block-progression dimension. (fo:page-sequence, location:
237/61)


Uncertainly,
Richard.


 -Original Message-
 From: Andrew McFarland [mailto:[EMAIL PROTECTED] 
 Sent: 17 December 2007 15:49
 To: Kerry, Richard
 Cc: docbook-apps@lists.oasis-open.org
 Subject: Re: [docbook-apps] Fop unable to render tables ? 
 (without intervention ?)
 
 On 17/12/2007, Kerry, Richard [EMAIL PROTECTED] wrote:
 
 snip/
  Fop is version 0.94, which I think is the latest.
 snip/
 
 Try setting fop1.extensions
 
 http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop1
 .extensions.html
 
 Also read chapter 30 of the Sagehill book,
 http://www.sagehill.net/docbookxsl/Tables.html
 
 And good luck. Tables drive me nuts :-)
 
 Andrew
 -- 
 We can't change the past, but each of us, by challenging prejudice and
 intolerance, can help to change the future.
 - Rabbi Jonathan Sacks, Address at Holocaust Memorial Day, Westminster
 Hall, London, 27th January 2005
 

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

RE: [docbook-apps] Fop unable to render tables ? (without intervention ?)

[Kerry, Richard]

 
OK. I have some sort of progress.

I found an answer on mail-archive.com (*) which explains how the
keep-together on the fo:table block is unable to split the table over
several pages using keep-together.within-column=auto because the
surrounding fo:block has keep-together.within-column=always.

I've got my document to display properly by editing the xsl-fo.
This is, of course, a solution in the xsl-fo domain, and I want to get a
fix at the DocBook level.

I've used ?dbfo keep-together=auto ? within my DocBook table to
get the innermost of these set correctly, but I need the parent block to
somehow get the attribute changed.

Can I do this from the DocBook level ?  I don't want to need to patch
the fo to get the formatting to work.
Do I need to put another ?dbfo keep-together=auto ? to get the
parent fo:block's attribute fixed ?
If so, where should this be done ?
Is there something else I need to change ?



Appreciatively,
Richard.


(*) http://www.mail-archive.com/[EMAIL PROTECTED]/msg07904


 -Original Message-
 From: Kerry, Richard 
 Sent: 18 December 2007 11:16
 To: docbook-apps@lists.oasis-open.org
 Subject: RE: [docbook-apps] Fop unable to render tables ? 
 (without intervention ?)
 
  
 I've tried setting fop1.extensions but I don't think it does anything
 for me regarding tables.
 It generates a bookmark-tree and gives a region the name blank-body.
 
 One problem I'd had was that I'd missed the colspec elements within
 the tgroup.  Having added those I'm no longer getting the many
 warnings about table-layout.
 
 However, I am still gettting Fop attempting to place each table on one
 page only, and I get the warnings shown below for the two long tables.
 I did get these when I sent my earlier message on this subject but
 thought the other messages, with their many repetitions, were more
 important, so I neglected to include them in my posting.  I think
 actually these are the most significant in that they are telling me
 directly that it has placed the long tables on single pages.  There's
 nothing I can see in DocBook, or Chapter 30 of Rob Stayton's book, to
 indicate that I need to tell it to split a table over multiple pages -
 indeed I'd have thought it would default to doing so.  And I 
 can't find
 any attributes or anything that looks like it will enable splitting
 tables across pages.
 
 
 
 These are the two warning messages that tell me directly that 
 there are
 tables on pages 3 and 6 that can't be fitted onto the single page.
 
 17-Dec-2007 13:34:20 org.apache.fop.layoutmgr.PageBreaker$1
 notifyOverflow
 WARNING: Content of the region-body on page 6 overflows the available
 area in block-progression dimension. (fo:page-sequence, location:
 237/61)
 17-Dec-2007 13:34:20 org.apache.fop.layoutmgr.PageBreaker$1
 notifyOverflow
 WARNING: Content of the region-body on page 3 overflows the available
 area in block-progression dimension. (fo:page-sequence, location:
 237/61)
 
 
 Uncertainly,
 Richard.
 
 
  -Original Message-
  From: Andrew McFarland [mailto:[EMAIL PROTECTED] 
  Sent: 17 December 2007 15:49
  To: Kerry, Richard
  Cc: docbook-apps@lists.oasis-open.org
  Subject: Re: [docbook-apps] Fop unable to render tables ? 
  (without intervention ?)
  
  On 17/12/2007, Kerry, Richard [EMAIL PROTECTED] wrote:
  
  snip/
   Fop is version 0.94, which I think is the latest.
  snip/
  
  Try setting fop1.extensions
  
  http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop1
  .extensions.html
  
  Also read chapter 30 of the Sagehill book,
  http://www.sagehill.net/docbookxsl/Tables.html
  
  And good luck. Tables drive me nuts :-)
  
  Andrew
  -- 
  We can't change the past, but each of us, by challenging 
 prejudice and
  intolerance, can help to change the future.
  - Rabbi Jonathan Sacks, Address at Holocaust Memorial Day, 
 Westminster
  Hall, London, 27th January 2005
  
 
 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: 
 [EMAIL PROTECTED]
 
 

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

RE: [docbook-apps] Fop unable to render tables ? (without intervention ?)

[Kerry, Richard]

 

Thank you, but, recent snapshot release of what ?
Docbook-xsl ? Or Fop ?

Appreciatively,
Richard.



 -Original Message-
 From: Mauritz Jeanson [mailto:[EMAIL PROTECTED] 
 Sent: 18 December 2007 16:39
 To: Kerry, Richard; docbook-apps@lists.oasis-open.org
 Subject: RE: [docbook-apps] Fop unable to render tables ? 
 (without intervention ?)
 
  -Original Message-
  From: Kerry, Richard 
  
  I've used ?dbfo keep-together=auto ? within my DocBook 
 table to
  get the innermost of these set correctly, but I need the 
  parent block to
  somehow get the attribute changed.
  
  Can I do this from the DocBook level ?  I don't want to 
 need to patch
  the fo to get the formatting to work.
  Do I need to put another ?dbfo keep-together=auto ? to get the
  parent fo:block's attribute fixed ?
  If so, where should this be done ?
  Is there something else I need to change ?
 
 
 It should work with a recent snapshot release. I added a fix for this
 problem on 13 September (after the release of DocBook XSL 1.73.2).
 
 /MJ
 
 
 
 

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

[docbook-apps] Fop unable to render tables ? (without intervention ?)

[Kerry, Richard]

I have a DocBook document which I wish to convert to pdf and I'm having
a problem with Fop rendering the tables.
 
I've used the Xsl stylesheet to convert it to Xsl-Fo.  Originally with
no parameters set.  I then use Fop version 0.94 to generate pdf.  
 
The DocBook document contains several tables, one in particular is very
large, and will stretch over several pages of the final document
(another is perhaps just a little over the size that should fit on one
page).
 
The two symptoms I had were :
1.  There were many error messages from Fop.
2.  The tables in the pdf file were attempting to display on one page
each, which seems wrong.
 
The Fop error messages were as follows :
 
17-Dec-2007 13:34:19 org.apache.fop.fo.FONode attributeWarning
WARNING: Warning(994/42): fo:table, table-layout=auto is currently not
supported by FOP

Once for each table.
 
Then 
 
17-Dec-2007 13:34:20
org.apache.fop.layoutmgr.inline.LineLayoutManager$LineBreakingAlgorithm
updateData2
WARNING: Line 1 of a paragraph overflows the available area. (fo:block,
location: 2481/70)

Many times.  Possibly once per expected resulting page.
 
I am assuming that these error messages indicate the reasons why the
large tables were not rendered properly.
 
So what I'd like to know is :
How can I stop this happening ?
Do I need to do something to change table-layout to something other than
auto, and if so how do I pass this in ?
I expected that tables would just go through on the nod, and work
without intervention, as they would seem to be a very common part of a
technical document.
 
 
Uncertainly,
Richard.
 
PS.
Fop is version 0.94, which I think is the latest.
Xsl template processing is being done by Saxon 6.5.5, which I believe is
the most recent Saxon-6.
I've also done the xsl processing using Saxon 9.0.0.1j, which gives
almost exactly the same xsl-fo file output, except that it can be told
to indent its output which I don't believe Saxon-6 can (see question by
me last week), and I don't care to try reading unindented xml
 
PPS
When I say Originally with no parameters set. I mean that in order to
stop getting messages about not being able to fetch the draft picture
I'm now setting draft.mode=no, and I'm now also setting
paper.type=A4 as I'm in Europe.  As well as !indent=yes, which only
afects Saxon-9, to get the fo indented.
 
 
 
Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Design Building, BBC Television Centre, Wood Lane, London, W12
7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
Email: [EMAIL PROTECTED]
blocked::mailto:[EMAIL PROTECTED] 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for the exclusive
use of the addressee/s.  If you are not the addressee, then any
distribution, copying or use of this e-mail is prohibited. If received
in error, please advise the sender and delete it immediately.  We accept
no liability for any loss or damage suffered by any person arising from
use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens Square, Frimley,
Camberley, GU16 8QD

 

[docbook-apps] Can I set indent=yes using Saxon-6

[Kerry, Richard]

If I'm using Saxon-9 I can say !indent=yes to tell Saxon to behave as if
the indent attribute of xsl:output has been set to 'yes'.
 
Is there an equivalent in Saxon-6 ?  (I'd like to get my fo output
indented).
 
Or I might go back to Saxon-9 for that particular output format.
 
 
Regards,
Richard.
 
 

Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Design Building, BBC Television Centre, Wood Lane, London, W12
7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
Email: [EMAIL PROTECTED]
blocked::mailto:[EMAIL PROTECTED] 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for the exclusive
use of the addressee/s.  If you are not the addressee, then any
distribution, copying or use of this e-mail is prohibited. If received
in error, please advise the sender and delete it immediately.  We accept
no liability for any loss or damage suffered by any person arising from
use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens Square, Frimley,
Camberley, GU16 8QD

 

[docbook-apps] Getting Html Chunks with Saxon 9j

[Kerry, Richard]

I've been using Saxon for a while and have just started using it to do
DocBook transformations.
 
I'm getting a problem with Chunked Html.
I'm getting a message saying Saxon 9.0.0.1 doesn't know how to chunk,
which I don't really believe.
I presume I've failed to do some basic bit of configuration.
 
My error messages are as follows :
 
C:\Projects\Documentationset
CLASSPATH=C:/Downloads/Saxon/saxonb9-0-0-1j/saxon9.jar 

C:\Projects\Documentationjava net.sf.saxon.Transform  -s:Proliant.dbk
-xsl:C:\Downloads\DocBook\docbook-xsl-1.73.2\html\chunk.xsl
base.dir=ProliantDocumentationChunked/ 
Warning: at xsl:stylesheet on line 4 of
file:/C:/Downloads/DocBook/docbook-xsl-1
file:///C:/Downloads/DocBook/docbook-xsl-1 .73.2/html/chunk.xsl: 
  Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor 
Warning: on line 337 of
file:/C:/Downloads/DocBook/docbook-xsl-1.73.2/common/str
file:///C:/Downloads/DocBook/docbook-xsl-1.73.2/common/str ipns.xsl: 
  The attribute axis starting at a document node will never select
anything 
Note: namesp. cut : stripped namespace before processing
Proliant Server Monitor Driver 
Note: namesp. cut : processing stripped document
Proliant Server Monitor Driver 
WARNING: cannot add @xml:base to node set root element.  Relative paths
may not work. 
Don't know how to chunk with SAXON 9.0.0.1 from Saxonica 
Processing terminated by xsl:message at line 46 in chunker.xsl 

 
This message appears to occur when element-available(saxon:output) is
not true (nor exsl:document nor redirect:write but I'm assuming they're
not relevant as I'm using Saxon).
 
 
(The same error occurs whether or not I try to use base.dir)


 
I assume I'm missing something basic but I can't find anything on the
WWW that clarifies it.
 
As you can probably partially tell from the above I am working with :
Windows XP
Saxon 9.0.0.1j
docbooc-xsl-1.73.2
Java 1.6.0_03
 
Regards,
Richard.
 
 

Richard Kerry
Colledia Control Engineer
Siemens IT Solutions and Services Ltd
Room 457 Design Building, BBC Television Centre, Wood Lane, London, W12
7RJ
T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
Email: [EMAIL PROTECTED]
blocked::mailto:[EMAIL PROTECTED] 
Website:  www.siemens.co.uk/it-solutions
blocked::outbind://47/www.siemens.co.uk/it-solutions 

This e-mail contains confidential information and is for the exclusive
use of the addressee/s.  If you are not the addressee, then any
distribution, copying or use of this e-mail is prohibited. If received
in error, please advise the sender and delete it immediately.  We accept
no liability for any loss or damage suffered by any person arising from
use of this e-mail.

Siemens IT Solutions and Services Limited
Registered No: 1203466 England
Registered Office: Faraday House, Sir William Siemens Square, Frimley,
Camberley, GU16 8QD