[docbook-apps] Long programlisting

[davep]

Output pdf,

I've crashed xep with a 'two page' or more programlisting?
Are these split at all please?

If so how might it be done?

I'd like to xinclude the file (as text) rather than copy/past/s/replace


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

Re: [docbook-apps] Long programlisting

[davep]

On 06/06/2011 04:25 PM, deannel...@aol.com wrote:

Dave,
To xinclude text files in programlisting:
xmlns:xi="http://www.w3.org/2001/XInclude";href="MyFile.txt" 
parse="text" />
Yes, that's what I have...


And then make sure you have a something like this in your mod files:

I'm using v5... if that makes any difference Dean?

regards DaveP






http://www.w3.org/2001/XInclude";
href   CDATA   #REQUIRED
parse  (xml|text)  "xml"
encoding   CDATA   #IMPLIED
xpointerCDATA   #IMPLIED
accept  CDATA   #IMPLIED
accept-charset  CDATA   #IMPLIED
accept-language CDATA   #IMPLIED >


http://www.w3.org/2001/XInclude"; >





















Regards,
Dean Nelson





In a message dated 6/6/2011 7:49:31 A.M. Pacific Daylight Time, 
da...@thingbag.net writes:


-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Is the programlisting in an ? If so, you can either
change the
default for examples or use :

http://lists.oasis-open.org/archives/docbook-apps/201103/msg00046.html
http://www.sagehill.net/docbookxsl/PageBreaking.html

David

On 06/06/2011 09:40 AM, davep wrote:
> Output pdf,
>
> I've crashed xep with a 'two page' or more programlisting?
> Are these split at all please?
>
> If so how might it be done?
>
> I'd like to xinclude the file (as text) rather than
copy/past/s/replace
>
>
> regards
>

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJN7OjbAAoJEMHeSXG7afUhOnMIAJRgeqdMWMXgTCSGKHMfQNB5
nKjdJTbMf05sNLbF02HLzop519E1VEHVSEJRI2CzWRsNkHbJZOh/8XkgpEW9s+jc
0XQp1clQpBQpjPjp1JQL4l40YS0IArwBwEP6se8SUlaC1jc4Tmle6Jm8dqBfHpBv
qa4D4+hgFMDXkXAc1U/3NDf1mV8rdE3kU3Fg6zemmZpNJYxkLXDiiSoQ9XV0QjDU
OGBumqvVWnaTCobZwVX1PCwYNL/+dd4OzEaUYs/vRgWhl3fiNsOYkSqvU4Xi2N4e
28DD2tATdcMp2O0oLgxlWVvN10W8MczVJ/cha+XUvhcrwPdSUd0aWHAV/bLiYBg=
=z9Bc
-END PGP SIGNATURE-

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




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

Re: [docbook-apps] Long programlisting

[davep]

On 06/06/2011 03:49 PM, David Cramer wrote:

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Is the programlisting in an?

Yes it is.


  If so, you can either change the
default for examples or use:

http://lists.oasis-open.org/archives/docbook-apps/201103/msg00046.html

For a long listing, keep-together.always is a problem.
Sounds like the source of my issue David?



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

Sounds like a plan
The example shows


  My long table
  **


how does that translate for example/programlisting?
within example, outside programlisting?
Seems about right.
[Is this a candidate for a param?]


Thanks David




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

Re: [docbook-apps] Long programlisting

[davep]

On 06/06/2011 07:57 PM, David Cramer wrote:


For a long listing, keep-together.always is a problem.
Sounds like the source of my issue David?

Yes, but the default behavior will change the next time we do a release.

I think that's an improvement.



I think you can do:



OR (better yet, since this will be the default in the future) add this
to your customization layer:


auto


And then use the PI to set it to always when you have a short example
that you want kept together.

Why .within-column? I'd have thought .within-page
would be more logical?





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

Re: [docbook-apps] Long programlisting

[davep]

On 06/07/2011 01:11 PM, David Cramer wrote:

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 06/07/2011 01:40 AM, davep wrote:

Why .within-column? I'd have thought .within-page
would be more logical?

Well, column and page are the same unless you do two-column output. If
you're doing two column output, you would only need to use .within-page
if you wanted a different value for .within-column, for example if you
want to make .within-column auto and .within-page always.



Noted.

I tried the custom solution. Then  XEP suggested
reverting to java 1.6.0_25, which in combination, seems to
do the trick.
Unsure if there's a connection. Others have noted 64bit
java on Linux as being 'iffy'.

thanks for the suggestions David.




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] fop and floats

[davep]

Input docbook
In the midst of ...

resultant fo


I n the midst of ...

I have said I'm using fop




fop 1.0 doesn't support floats.
Is the use here necessary?
I'm not at all sure I see its purpose?


regards






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

Re: [docbook-apps] fop and floats

[davep]

On 07/13/2011 05:10 PM, Bob Stayton wrote:

Hi Dave,
I'm not understanding your example.  This looks like an implementation 
of dropcap using a side float for the first letter of the para. There 
is no such dropcap implemented in the stock DocBook XSL, so that must 
be coming from a customization layer.


A float is used when you want the dropcap to cover more than one line 
of the paragraph.  If you don't use a float, the the second line of 
text will overwrite the big letter.  The float forces the next line to 
give it space.




Thanks for the reminder Bob.
I have a pre-processing step that does this.

Sorry for wasting bandwidth folks.




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

Re: [docbook-apps] db 5, para formatting, fo output

[davep]

On 07/25/2011 03:41 PM, davep wrote:
Attached (if it gets through) the horrible looking result when 
justification is on and the line includes a url of any length.
1. I'd like to have justified text (param alignment='justified'), but 
if it contains a url...

(Yes, not easy)
or
2. How to persuade the formatter to hyphenate url's at / or similar to 
make it look better?
Using xep 


Half a solution








As a pre-process.
  Still looks ugly using justified text though OK when left justified.

I somehow don't think I can do better than this.

Any suggestions appreciated.





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

Re: [docbook-apps] db 5, para formatting, fo output

[davep]

On 07/25/2011 04:30 PM, Bob Stayton wrote:

Hi Dave,
The DocBook XSL stylesheets can already insert zero-width spaces for 
long URLs.  See this reference:


http://www.sagehill.net/docbookxsl/Ulinks.html#BreakLongUrls

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


Thanks Bob... I think :-)
I had

​
I have added
/
I ran that and I'm still getting squashed, long lines?
src
http://money.cnn.com/magazines/fortune/fortune_archive/2004/02/23/362182/index.htm";>http://money.cnn.com/magazines/fortune/fortune_archive/2004/02/23/362182/index.htm

Screenshot attached?


regards









- Original Message - From: "davep" 
To: 
Sent: Monday, July 25, 2011 8:22 AM
Subject: Re: [docbook-apps] db 5, para formatting, fo output



On 07/25/2011 03:41 PM, davep wrote:
Attached (if it gets through) the horrible looking result when 
justification is on and the line includes a url of any length.
1. I'd like to have justified text (param alignment='justified'), 
but if it contains a url...

(Yes, not easy)
or
2. How to persuade the formatter to hyphenate url's at / or similar 
to make it look better?

Using xep


Half a solution








As a pre-process.
  Still looks ugly using justified text though OK when left 
justified.


I somehow don't think I can do better than this.

Any suggestions appreciated.





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









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

Re: [docbook-apps] db 5, para formatting, fo output

[davep]

On 07/25/2011 08:51 PM, Bob Stayton wrote:

Hi Dave,
The feature is applied only when the link element is empty, when the 
stylesheet is processing the url attribute to make the displayed link 
text.  I think that is the correct behavior, because the text content 
of link is arbitrary, and applying the url hyphenation process to 
arbitrary text could produce odd results.  So use:


xlink:href="http://money.cnn.com/magazines/fortune/fortune_archive/2004/02/23/362182/index.htm"/>


I'll update the reference page for this parameter.

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



That's it Bob.
  Many thanks.


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] Docbook and style

[davep]

Docbook is now used for many other uses than tech doc.  With this come
style requirements.  Since db5 now uses Relax NG, which is easy to
customize, is it possible to add a simple 'decorative' customization
to add markup specifically for styling.  E.g. Drop caps for the first
letter of the first para of a chapter.  Direct italics, rather than
indirect via emphasis/@role.  Specific styling/font directives for
headings. Letting the stylesheet author know about font requirements
etc, perhaps as metadata? Perhaps as Some Greekhttp://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

Re: [docbook-apps] Docbook and style

[davep]

On 07/28/2011 09:56 AM, redlettucemail wrote:
It is somewhat simplistic to say that DB5 can be easily customised 
with a simple customisation layer - some customisations for style are 
easy (and the stylesheets logical to follow), while others are 
frustratingly difficult because the logic changes (such as customising 
figure, table and example labels from the "en.xml" file rather than 
the relevant titlesheet xsl).

I was referring to customization of the schema in relax NG.
Then leaving the XSLT styling of that markup to customization of that layer.






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] fo template 'header.content'

[davep]

I want to tweak the header contents.
http://www.sagehill.net/docbookxsl/PrintHeaders.html#PrintHeadersText
suggests header.content is the right place.

Running that, no priority attribute I get

Error at xsl:call-template on line 2025 of 
file:/sgml/docbook/docbook-xsl-ns-1.76.1/fo/pagesetup.xsl:
  There are several templates named 'header.content' with the same 
import precedence


3 times.

Documentation or use of include rather than import?


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

Re: [docbook-apps] fo template 'header.content'

[davep]

On 08/01/2011 12:07 PM, Markus Hoenicka wrote:

davep  was heard to say:


I want to tweak the header contents.
http://www.sagehill.net/docbookxsl/PrintHeaders.html#PrintHeadersText
suggests header.content is the right place.



Hi Dave,

I've used Bob's instructions just lately to modify the headers, and 
things worked right out of the box. I copied the template from 
fo/pagesetup.xsl to my customization layer and applied a few tweaks to 
obtain the desired results. What does your customization layer look like?


Wrong!
  I had the template in the customization layer twice.
My bad.
  Sorry to waste bandwidth.

Tks Markus





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] acknowledgements

[davep]

http://www.docbook.org/tdg51/en/html/acknowledgements.html


   Parents

These elements containacknowledgements 
:article 
,book 
,module 
 
(db.container.module),part 
,resource 
 
(db.container.resource).


In file block.xsl I see








Yet the element, in a book, isn't reported as an unknown element?

In components.xsl I see








So it would appear that this element in a book is not processed?
Is that correct?

regards




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

Re: [docbook-apps] acknowledgements

[davep]

On 08/01/2011 05:51 PM, Bob Stayton wrote:

Hi Dave,
In FO output, acknowledgements is not a block, it is a page-sequence.
The template for book in division.xsl (in 1.76.1) has this:



and component.xsl as:



to generate the page sequence.  It works for me.


Yes. Thanks Bob.



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] Bibliography, v5, titlepage template

[davep]

My template is









and I'm seeing





font-weight="bold" text-align="center" space-after="33.161mm" 
color="rgb(40%,40%,40%)">
http://www.antennahouse.com/names/XSL/Extensions"; 
keep-with-next.within-column="always" space-before.optimum="10pt" 
space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" 
hyphenate="false" text-align="start" start-indent="0pt" 
line-height="1.3" hyphenation-character="-" 
hyphenation-push-character-count="2" 
hyphenation-remain-character-count="2">Further Reading






Of note:
I specify text-align='center'
the inside block overrides this, with text-align='start'

What am I missing please?

TIA

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

Re: [docbook-apps] Bibliography, v5, titlepage template

[davep]

On 08/02/2011 07:20 PM, Bob Stayton wrote:

Hi Dave,
This is a case of two methods of applying formatting attributes 
conflict with each other.
When you use the t:named-template="component.title", that template 
applies the attribute-set named 'component.title.properties'.  That's 
where the text-align="start" and other properties are coming from.


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


Thanks Bob.
   component.title.properties is used quite widely isn't it?
Not sure how to address this one.

regards DaveP





- Original Message - From: "davep" 
To: "Docbook-apps" 
Sent: Tuesday, August 02, 2011 5:31 AM
Subject: [docbook-apps] Bibliography, v5, titlepage template



My template is









and I'm seeing





font-weight="bold" text-align="center" space-after="33.161mm" 
color="rgb(40%,40%,40%)">
xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions"; 
keep-with-next.within-column="always" space-before.optimum="10pt" 
space-before.minimum="10pt * 0.8" space-before.maximum="10pt * 1.2" 
hyphenate="false" text-align="start" start-indent="0pt" 
line-height="1.3" hyphenation-character="-" 
hyphenation-push-character-count="2" 
hyphenation-remain-character-count="2">Further Reading






Of note:
I specify text-align='center'
the inside block overrides this, with text-align='start'

What am I missing please?

TIA

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









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] itemized list, and import precedence

[davep]

I have
import docbook stylesheets
import my attribute sets

in which I have


5mm
5mm



The resulting xsl-fo shows



I.e. the
space-before is set twice?

I'm guessing it's an import precedence issue... but I don't know
what the precedence is... and Mike Kays book only talks about
nested importing?

1. Which takes precedence please?
2. My basic problem is that I need to reduce the space-before/space-after
each list-item?

Any suggestions please? I want it to be the same as basic para's, i.e. 
line-height 16pt.


TIA



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] pagesetup.xsl

[davep]

I gather from pagesetup.xsl that if I wanted the various page-masters
to have different region sizes that I'd need to customize

...

Is that the only way to make them different please?


TIA

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

Re: [docbook-apps] itemized list, and import precedence

[davep]

On 08/07/2011 05:50 PM, Bob Stayton wrote:

Hi Dave,
This isn't a case of import precedence, but of  different attributes.  
In general, the qualified attributes (like  space-before.optimum) take 
precedence over the non-qualified attributes (like  space-before). I 
wish the DocBook XSL stylesheets had not been written using the 
qualified attributes in some of the attribute-sets, because if you 
want to override the space before, you need to override all three of 
the qualified attributes for it to have any effectc.


BTW, was that a typo in your example?  Your attribute-set says 
space-before="5mm" but the resulting xsl-fo has space-before="0pt", 
but I don't see where the 0pt might have come from.


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


Understood. I was drowning in attributes and couldn't see the wood for 
the trees.

The 0pt value came from a direct customization. I have stripped them all out
now. I simply wanted to reduce the space-before/after in a sequence of  
epigraphs.


+1 on the qualified attributes. Unnecessary complication?

Thanks Bob.





- Original Message - From: "davep" 
To: "Docbook-apps" 
Sent: Saturday, August 06, 2011 1:45 AM
Subject: [docbook-apps] itemized list, and import precedence



I have
import docbook stylesheets
import my attribute sets

in which I have


5mm
5mm



The resulting xsl-fo shows



I.e. the
space-before is set twice?

I'm guessing it's an import precedence issue... but I don't know
what the precedence is... and Mike Kays book only talks about
nested importing?

1. Which takes precedence please?
2. My basic problem is that I need to reduce the 
space-before/space-after

each list-item?

Any suggestions please? I want it to be the same as basic para's, 
i.e. line-height 16pt.


TIA



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









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

Re: [docbook-apps] pagesetup.xsl

[davep]

On 08/07/2011 05:53 PM, Bob Stayton wrote:
If you want to use the original page master names, then the answer is 
yes, you must customize that big template.  If you want to use your 
own master names, then you can use the user.pagemasters and 
select.user.pagemaster templates to write your own original page masters.

Thanks Bob.
 Sneaky thing!
Very neat solution.  And a much nicer way to go!
I'm looking for a new template for  Different from 

I'm wondering if the titlepage.template system would work with those?
sounds like it should?

regards DaveP






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


- Original Message ----- From: "davep" 
To: "Docbook-apps" 
Sent: Saturday, August 06, 2011 6:00 AM
Subject: [docbook-apps] pagesetup.xsl



I gather from pagesetup.xsl that if I wanted the various page-masters
to have different region sizes that I'd need to customize

...

Is that the only way to make them different please?


TIA

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









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

Re: [docbook-apps] pagesetup.xsl

[davep]

On 08/07/2011 05:53 PM, Bob Stayton wrote:
If you want to use the original page master names, then the answer is 
yes, you must customize that big template.  If you want to use your 
own master names, then you can use the user.pagemasters and 
select.user.pagemaster templates to write your own original page masters.


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


There appears to be nothing about this at
http://www.sagehill.net/docbookxsl/PrintOutput.html#FinishedPageSize
nor http://docbook.sourceforge.net/release/xsl/current/doc/fo/

How to use please Bob/anyone?

I think TBC

In customization layer
In template name='user.pagemasters'
Create a simple-page-master and page-sequence-master which uses it
 (Steal from template name=setup.pagemasters)
In template name = 'select.user.pagemaster'
 return a string which names the page-master

Then in component.xsl, this will be used by the template for d:preface
when it selects a value for master-reference.

I think that's it.



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] fo page sizes

[davep]

wrt top margins I see

page.margin.top
body.margin.top
region.before.extent.

I'm looking for specific sizes,
A smaller page within A4,
  so I want a top/bottom page margin of 43.5mm,
then the regions within this.

I.e. region-before offset by 43.5mm below the top of the page.
page.margin.top seems not to be this setting?

What should it be please?

TIA


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] titleabbrev, docbook v5

[davep]

http://www.docbook.org/tdg/en/html/titleabbrev.html
says
"One common use of|TitleAbbrev| 
is for the text 
used in running headers or footers, when the proper title is too long to 
be used conveniently."


I can't find any customization that indicates that I want to use this 
for running headers?

header.content sets a call to

to obtain the title value...

Is it right to use
apply-templates select="." mode="titleabbrev.markup"/>
which seems to work fine.


Leaves the problem of a chapter title that is too long
for a single line.
Shame this couldn't be processed in the same way
   Unless you know better?

regarsd




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

Re: [docbook-apps] itemized list, and import precedence

[davep]

On 08/09/2011 11:33 AM, Jirka Kosek wrote:

On 7.8.2011 18:50, Bob Stayton wrote:


This isn't a case of import precedence, but of  different attributes.
In general, the qualified attributes (like  space-before.optimum) take
precedence over the non-qualified attributes (like  space-before). I
wish the DocBook XSL stylesheets had not been written using the
qualified attributes in some of the attribute-sets, because if you want
to override the space before, you need to override all three of the
qualified attributes for it to have any effectc.

Is some FO processor supporting these non-qualified attributes for
space-before/after? I don't think so. (Probably with the exception of
xmltex which can map these directly to glues in TeX, but xmltex is not
widely used today.) So I think we can safely remove those and just use
value of .optimum trait as unqalified property.

Jirka



+1





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

Re: [docbook-apps] titleabbrev, docbook v5

[davep]

On 08/11/2011 05:12 PM, Bob Stayton wrote:

Hi  Dave,
Yes, using mode="titleabbrev.markup" is the way to get the titleabbrev 
when you need it.  It falls back to the title if there is no titleabbrev.


In fact, the default header declared in the 'header.content' template 
in fo/pagesetup.xsl uses that mode for the chapter and section titles 
in the header, and for the TOC entry in the 'toc.line' template in 
fo/autotoc.xsl. Myself, I'm not sure I agree with that latter usage, 
as a user might be confused when the title they land on from the TOC 
link differs from the TOC entry.  At least in the running header you 
have the context of the chapter you are in to reduce confusion.


I'm not clear what you mean about about the long chapter title. There 
is a mode="titleabbrev.markup" for chapter in DocBook XSL. Are you 
talking about the title on the chapter title page itself?



Two use cases.
 1. When the title is > about 30 characters, it messes up the 
formatting on the title page.

2. With a long title, a running header containing the title again messes up.

It really needs feedback from the formatter (xsl 2.0).

regards


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

Re: [docbook-apps] fo page sizes

[davep]

On 08/12/2011 08:08 AM, Bob Stayton wrote:

Hi Dave,
I think you want to look at the page.height and page.width params.  
They set the size of the finished paper dimensions.  Then the 
page.margin.top is measured relative to the top of this page 
dimension.  For more details, see:


http://www.sagehill.net/docbookxsl/PrintOutput.html#FinishedPageSize

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


Wow that's a bit subtle (for me). Finished paper dimension... where
I'm thinking of the paper on which I'm starting (A4).

I'll look at your book, and see if I can think of a way of making
the help clearer.
  Thanks Bob.

regarsd






- Original Message - From: "davep" 
To: "Docbook-apps" 
Sent: Monday, August 08, 2011 7:22 AM
Subject: [docbook-apps] fo page sizes



wrt top margins I see

page.margin.top
body.margin.top
region.before.extent.

I'm looking for specific sizes,
A smaller page within A4,
  so I want a top/bottom page margin of 43.5mm,
then the regions within this.

I.e. region-before offset by 43.5mm below the top of the page.
page.margin.top seems not to be this setting?

What should it be please?

TIA


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









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] Word/ODF to docbook

[davep]

http://holloway.co.nz/docvert/

"

Docvert takes word processor files (typically .doc) and converts them 
toOpenDocument 
and 
cleanHTML.


Web Service receives .doc fileand converts it to a OpenDocument 
(ODF)which can then be converted toHTML, DocBook, RSS, or/any XML format/.


The resulting OpenDocument is then optionally converted to HTML or any 
XML. This is done with/XML Pipelines/ 
, an approach that 
supports XSLT, breaking up content over headings or sections, and saving 
those results to multiple files (e.g., chapter1.html, chapter2.html…).


"




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

Re: [docbook-apps] ZedAI

[davep]

On 08/28/2011 01:11 AM, William R. Greene wrote:
Is the Daisy Consortium's Z39.86 Authoring and Interchange Framework 
 (ZedAI) meant to replace 
DocBook as the format for master documents?


   -- Bill Greene


No Bill.



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] Page master selection. .fo, db5

[davep]

I note that for my usage, I can see 15 page-masters.
Each has the same paper size.
Each has the same margin-top margin-bottom margin-left margin-right 
(inside/outside inverted)
Each has the same region-body margin-bottom, margin-top, margin-left, 
margin-right.

Each has the same before-extent, after-extent.

How would I (for instance) change the dimension C in the diagram at
http://docbook.sourceforge.net/release/xsl/current/doc/fo/general.html
Perhaps to set the opening text in a new chapter a little lower?

Is it possible to configure these via params? Another way?
Or should it be done using (say) the space-before in the title?


TIA

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

Re: [docbook-apps] default value for @content-width in fo xsls

[davep]

On 08/30/2011 10:59 PM, David Cramer wrote:

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 08/30/2011 01:23 PM, Křištof Želechovski wrote:

Dnia wtorek, 30 sierpnia 2011 o 14:30:44 David Cramer napisał(a):

Hi there,
I notice that the default value for content-width in the fo stylesheets
is currently "auto". Is there any reason not to make the default
"scale-down-to-fit" [1]? Or should it be parameterized for those using

scale-down-to-fit could render the text unreadable, couldn’t it?  Unreadable 
text worse than clipped text.

I guess it's a matter of preference. I would much rather have a scaled
down image than a truncated one.

+1



  IIRC, XEP doesn't render the images at
all if there's not enough space (at least in some situations). So your
choice is a scaled down image or nothing.

Which is very annoying.
I think this is a reasonable default. For a user wanting to resize
the options are there, I'd hope the default did what is most
widely expected, which in this case (IMHO) is to scale to fit.

regards






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

Re: [docbook-apps] Page master selection. .fo, db5

[davep]

On 08/31/2011 04:44 AM, Bob Stayton wrote:

Hi Dave,
The simplest solution for just the chapter title is to add 
space-before in the title (and be sure to add 
space-before.conditionality="retain" since it appears first in the flow).


I thought so, thanks for the confirmation.



In general, the page-masters all share the same page size and margin 
parameters for consistency of look, but that makes it harder to 
customize particular page masters. Adding separate params for each 
page-master's many margins would result in a *lot* of params (15 
masters * 4 sides * 3 properties).

Mmm. Not reasonable. Understood.


  So you are left with defining custom page masters and getting your 
stylesheet to use them.  It is easiest to copy an existing page master 
to a custom 'user.pagemasters' template, change the name, and change 
just the properties you want to be different.  Then customize 
'select.user.pagemaster' template to turn it on.


Mostly understood
   I was half way through listing spm's, psm's and relating them.
I don't think there is any mapping of major docbook elements/page sets
to the psm's though is there?



in pagesetup.xsl ?

So I customize the template for ... chapter and then...
Copy the logic from component.xsl to pick up the right
page master.

Not so difficult.. (he says, not yet having tried!!!)

Thanks Bob.

regards




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

Re: [docbook-apps] Using olinks in bibliography collection with processor's parameters with relative paths

[davep]

On 09/11/2011 10:28 AM, Křištof Želechovski wrote:
This problem is common to all hypertext technologies, not only 
DocBook: namely, how do I declare an entity to be global to the 
current project, without hardcoding the path to the project, so that 
the links continues to work if the project is logically moved 
elsewhere? So far, the only solution I can think of is using virtual 
hosts or at least server-side redirections.



Same problem, absolute uri solution?
On my hard disk I have /docbook as a 'home' for all images/shared 
documents etc.

Ditto on my website I have /docbook (you choose a name) so that all
these 'odd'  files can be accessed in a common manner.

I also use it for docbook graphics, CSS files etc. the root directory is
further split by project
/docbook
   /project1
   /css
  /bibtex
etc.

HTH


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

Re: [docbook-apps] Using olinks in bibliography collection with processor's parameters with relative paths

[davep]

On 09/11/2011 04:49 PM, Křištof Želechovski wrote:

Dnia niedziela, 11 września 2011 o 12:29:26 davep napisał(a):

I also use it for docbook graphics, CSS files etc. the root directory is
further split by project
/docbook
 /project1
 /css
/bibtex
etc.

HTH

This is all good and well until you need to grab the whole project, in which 
case you need to move all parts of it dispersed in various places.  Can be done 
in a finite number of steps, but annoying.

The entire project support files are in /docbook/project1
I.e. easily managed.
I also have common to all docbook files in another, /docbook/common etc.

So no, in my case they aren't dispersed all over the disk?


regards






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] @role. How high can it go?

[davep]

I'm experimenting with typekit, typekit.com
and I want to add an @role attribute quite high in the xml tree,
to select a font for all the children?

Tried it on book, chapter, section and it doesn't come through as a @class
attribute? Works OK on para ... I have the params set correctly I believe;


text/css

http://www.docbook.org/tdg/en/html/book.html
@role is valid on 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

Re: [docbook-apps] @role. How high can it go?

[davep]

On 09/13/2011 05:28 PM, Bob Stayton wrote:

Hi Dave,
There are only four elements for which the stylesheets can propagate a 
role attribute to an HTML class attribute: emphasis, para, phrase, and 
entry, and each has its own stylesheet param to control such behavior 
(such as $para.propagates.style).  Because @role is used for many 
different purposes, this feature has not been implemented for all 
elements.


But the stylesheets do support customizing class attributes.  If you 
want to use propagate role to class for other elements, then you'll 
need to add a custom template in mode="class.value", as described here:


http://www.sagehill.net/docbookxsl/HtmlCustomEx.html#CustomClassValues

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



Thanks Bob.
I need it higher than that... and found







Into which I added some jscript.

Then used CSS to import a common stylesheet
which I used to propograte the font-family to the body element.

Working so far, though website is missing the user.head.content call?


regards





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

Re: [docbook-apps] @role. How high can it go?

[davep]

On 09/13/2011 05:41 PM, Bob Stayton wrote:

Hi Dave,
That sounds fine.  There is also a utility template named 
'body.attributes' that can be customized to add attributes to the body 
element.  The original is in html/docbook.xsl.  It is called right 
after the opening tag of .


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





Always 15 ways to skin a cat in docbook it seems!!

Thanks Bob. Neater than my approach for the css I think.


Is that used for website? Not sure how I'd check?






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

Re: [docbook-apps] Removing HTML TOC from epub

[davep]

On 09/22/2011 08:49 PM, Bob Stayton wrote:

Hi Chris,
Regarrding your first question, you can set the stylesheet param named 
'generate.toc' to empty to turn off the TOC chunk.  You will still get 
the NCX toc.
I noticed the same issue with customizing the epub 2 stylesheet.  If 
your customization consists only of parameter settings, then importing 
it should work.  However, it is a chunking stylesheet, so any template 
changes require paying careful attention to import precedence for them 
to work.  Generally that requires two separate customization files, 
but the epub/docbook.xsl needs to be rearranged for that to work.  
Based on the experience I gained from creating the epub 3 stylesheet, 
I plan to rearrange the files in the  epub directory for EPUB 2 output 
to make it easier to customize.

Bob Stayton
Sagehill Enterprises
b...@sagehill.net <mailto:b...@sagehill.net>


Since the toc is never needed (the ncx supplants a toc), would it make sense
to delete the call to generate it such that annoyance is removed?

regards DaveP



- Original Message -
*From:* Chris Ridd <mailto:chrisr...@mac.com>
*To:* docbook-apps@lists.oasis-open.org
<mailto:docbook-apps@lists.oasis-open.org>
*Sent:* Wednesday, September 21, 2011 3:26 AM
*Subject:* [docbook-apps] Removing HTML TOC from epub

Epubs have a table of contents used by readers (toc.ncx?) which
makes the generated HTML table of contents rather superfluous. How
does one prevent its generation in 1.76.1?

Actually a rather more general question is how (or what's best
practice) to customize the epub stylesheets. The shipped
epub/docbook.xsl doesn't really seem amenable to being customized
by an importing stylesheet. The FO stylesheets are significantly
more flexible in this regard.

Or should I be editing a copy of epub/docbook.xsl and customizing
it that way? There's a lot of logic in that stylesheet that I
really don't want to copy and try and keep in sync with the
shipping file.

Cheers,

Chris




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

Re: [docbook-apps] Removing HTML TOC from epub

[davep]

On 09/24/2011 08:34 AM, Chris Ridd wrote:

On 23 Sep 2011, at 17:47, Keith Fahlgren wrote:


Hi,

On Thu, Sep 22, 2011 at 11:30 PM, davep  wrote:

Since the toc is never needed (the ncx supplants a toc), would it make sense
to delete the call to generate it such that annoyance is removed?


Many publishers deliberately include an HTML TOC in their EPUB
documents. An HTML TOC can offer more nuanced layout and text than an
NCX TOC and is appropriate for some titles.

It sounds like it *can* be useful in some cases, but maybe shouldn't be the 
default.

Chris


I'm 50:50, could argue either way?
  How messy is it, in, say 3 different readers, to have the duplicate ToC?
Perhaps use that as the decider?

regards





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

Re: [docbook-apps] EPUB3: missing some meta data

[davep]

On 09/25/2011 09:47 PM, Keith Fahlgren wrote:

Hi,

You can include the (somewhat deprecated) DCMES versions as well:
http://idpf.org/epub/30/spec/epub30-publications.html#sec-opf-dcmes-optional

This (duplication) will help older EPUB 2 reading systems (and should
probably be controlled with a parameter).


Regards,
Keith


What's the situation wrt backwards compatibility Keith?
Is epub 3 'required' to be backwards compatible with 2.0?
Any ideas?

regards


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

Re: [docbook-apps] EPUB3: missing some meta data

[davep]

On 09/26/2011 08:05 PM, Keith Fahlgren wrote:

http://idpf.org/epub/30/spec/epub30-publications.html#confreq-rs-backward-epub2

On Mon, Sep 26, 2011 at 12:15 AM, davep  wrote:


What's the situation wrt backwards compatibility Keith?
Is epub 3 'required' to be backwards compatible with 2.0?

Backward Compatibility

   ›
   
<http://idpf.org/epub/30/spec/epub30-publications.html#confreq-rs-backward-epub2>
   It should process EPUB version 2 Publications as defined in[OPF2]
   <http://idpf.org/epub/30/spec/epub30-publications.html#refOPF2>,[OPS2]
   <http://idpf.org/epub/30/spec/epub30-publications.html#refOPS2>and[OCF2]
   <http://idpf.org/epub/30/spec/epub30-publications.html#refOCF2>.

Very clear! Thanks Keith.


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

Re: [docbook-apps] EPUB3: missing some meta data

[davep]

On 09/27/2011 07:38 AM, Michael Wiedmann wrote:

davep wrote:

On 09/26/2011 08:05 PM, Keith Fahlgren wrote:
<http://idpf.org/epub/30/spec/epub30-publications.html#confreq-rs-backward-epub2>

It should process EPUB version 2 Publications as defined in[OPF2]
<http://idpf.org/epub/30/spec/epub30-publications.html#refOPF2>,[OPS2]
<http://idpf.org/epub/30/spec/epub30-publications.html#refOPS2>and[OCF2]
<http://idpf.org/epub/30/spec/epub30-publications.html#refOCF2>.

Very clear! Thanks Keith.

But what does "should process" really mean for a EPUB3 reading system:

- does it have to visualize e.g. Dublin Core (EPUB2) metadata?
- is it sufficient to only "process" a subset of EPUB2 metadata?


Suggest 'process' as in rev 2 definition?
http://idpf.org/epub/30/spec/epub30-publications.html#sec-metadata-elem

I.e. it is required, though how it is used is player dependent?
epub seems to be following Daisy, in *not* saying anything about
what action a player must/should execute.


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

Re: [docbook-apps] EPUB3: missing some meta data

[davep]

On 09/27/2011 08:25 AM, Bob Stayton wrote:

Hi Keith,
This description is backwards compatibility of the epub 3 reader, that 
it should be able to handle epub 2 documents.  That is useful, must 
mostly of interest to creators of epub3 reader software.


I don't have that interpretation Bob? I think epub is a 'files on disk' 
spec,

as with Docbook?

The word reader only appears with the list of applications?

What makes you think it is reader specific?




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

Re: [docbook-apps] EPUB3: missing some meta data

[davep]

On 09/27/2011 09:39 AM, Bob Stayton wrote:
Well, the title of that section is "2.2 Reading System Conformance" 
and the intro para says "An EPUB Reading System must meet all of the 
following criteria:"  So the spec is more than just the file format.


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



 Fair enough.





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] fo output, docbook 5,

[davep]

Two issues.

  There is a param
left
Not visible on http://docbook.sourceforge.net/release/xsl/1.76.1/doc/fo/

Tried setting
/_&
and I see  no hyphenation on the / character, xep formatter.
I have hyphenate set to true.

Screenshot


Is there some interaction between text-align=justify and this?


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

Re: [docbook-apps] fo output, docbook 5,

[davep]

On 10/10/2011 02:38 PM, Bob Stayton wrote:

Hi Dave,
I'm not sure what you are describing here.  There is no DocBook 
stylesheet param named 'text-align-last', so that is why it does not 
appear in the documentation.  In the XSL-FO standard, there is a 
formatting property of that name, and it is used to format entries in 
a table of contents.  Where did you see that  name as a param?


param.xsl
I did see it... but didn't note its context?

justify
start
select="concat($toc.indent.width, 'pt')"/>
select="concat('-', $toc.indent.width, 'pt')"/>



My bad, I apologise.


I do think if justification is set to on, that text-align-last should be set
to left? Looks horrible stretched out to justify?







Regarding ulink hyphens, it works for me in XEP.  To what value did 
you set the other required param, the 'ulink.hyphenate' param?  I used 
­


I tried to include an image. Now attached.
true
/_&

So I'm expecting it to break at the  slash character?
Which version of xep are you using please?




Regarding screenshot, that element is just a semantic container for a 
single mediaobject.


That's my email app. I tried to insert a file called screenshot into the 
file.

See attached.


  In FO output, it just adds an fo:block wrapper without any 
properties, so any properties  it gets would be inherited.  If the 
fo:root has text-align="justify", then that would be inherited by its 
container.  But since there is only one line object in the container, 
that line should be using text-align-last, which defaults to 'start' 
when text-align="justify".  So I can't see how there would be an 
interaction.  Are you seeing something odd?


Yes. See the attached graphic, if it comes through?
You say that if I set justify, then text-align-last defaults to left?
Where please? grep doesn't show that?

regards DaveP












- Original Message - From: "davep" 
To: "Docbook-apps" 
Sent: Monday, October 10, 2011 1:46 AM
Subject: [docbook-apps] fo output, docbook 5,





Two issues.

  There is a param
left
Not visible on http://docbook.sourceforge.net/release/xsl/1.76.1/doc/fo/

Tried setting
/_&
and I see  no hyphenation on the / character, xep formatter.
I have hyphenate set to true.

Screenshot


Is there some interaction between text-align=justify and this?


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









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

Re: [docbook-apps] fo output, docbook 5,

[davep]

On 10/10/2011 04:04 PM, Bob Stayton wrote:

Hi Dave,

I do think if justification is set to on, that text-align-last should 
be set

to left? Looks horrible stretched out to justify?


I completely agree, as did the authors of the XSL-FO spec.  The spec 
says the default value for text-align-last is 'relative',  which they 
describe as:


"If text-align is justify, then the alignment of the last line, and of 
any line ending in U+000A, will be start. If text-align is not 
justify, text-align-last will use the value of text-align."


Since the DocBook stylesheet does not set a root value for 
text-align-last, this statement applies.




Regarding the ulinks, you *must* also set the 'ulink.hyphenate' param, 
as described here:


http://www.sagehill.net/docbookxsl/Ulinks.html#BreakLongUrls

Your mail did not mention that param, but it is necessary to achieve 
the effect.


Which was my problem in this case Bob. Many thanks.

Leaves me with an itch.
Three parameters. Set one, to have it work you must set at least one more:
Possibly two.
I've had this before...

Does anyone have any more 'inter-related' params?
At least they can go into the documentation.

Note: If you set this param you should set that param.


regards





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] Parameter interaction. Can you help?

[davep]

I've just been caught out setting one parameter, which depends on 
another being set.

I.e. I set one not knowing the other had to be set?


To help others, if you know of parameters which are associated like 
this, where the documentation could be improved, please let me know and  
I'll update it.

Onlist or offlist.
The parameters concerned, the effect and whether it is for html/fo/xhtml 
... etc.



TIA

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] Docbook and 'style'. db5 and xsl-fo output

[davep]

Some time back I had an itch, I wanted to add style information to 
docbook schema.
I've now scratched it, adding properties to a couple of elements and 
creating

stylesheet customizations to match.

See http://dpawson.co.uk/docbook/style/style.html


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

Re: [docbook-apps] Relative path for highlight.xslthl.config

[davep]

On 11/21/2011 06:59 PM, Lars Vogel wrote:

Hi,

I'm currently using an absolute path for the syntax highlighting
configuration file. As I'm switching between computers back and forth I
would like to make this relative.

Currently:



I did not manage to make the system accept a relative path. Can someone
please share an example?


I have the same problem, moving content from my disk to website.
My only solution was to have a common (absolute) address to use
in my case it was /dir/dir/file
If you can be assured of having the file on the same disk, this
solution will work for you. c: is redundant in a java world,
as is the file:/// prefix.

HTH


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] titlepage customization, docbook v5

[davep]

I'm having problems using the html titlepage code.
Bob has
http://www.sagehill.net/docbookxsl/TitlePageNewElems.html
which relates to older versions, where the templates
and the xsl file to process it is in the template directory
which doesn't exist in the v5 distro.

I copied out titlepage.template.xml in  say /temp
I'm running saxon
saxon /temp/titlepage.template.xml
stylesheet //html/titlepage.xsl
output ...

I'm getting all sorts of errors and I'm unsure why?
should I be using titlepage.xsl  titlepage.templates.xsl
I don't think so (it says )


Surely my configured specfile doesn't need to be moved back into the v5 
distro

location?

Any suggestions please?



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

Re: [docbook-apps] titlepage customization, docbook v5

[davep]

On 11/26/2011 08:29 AM, davep wrote:

I'm having problems using the html titlepage code.


Only because I didn't rtfm.

why does it always happen after  I send the email?

the template directory is still there, used as in previous releases.

Sorry for the noise.




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] Relocated graphics.... bug or not?

[davep]

Scenario.
  I keep my graphics in X/graphics
I set


I build (docbook v5)

During the build I get errors
Failed to load image: ARM1176JZF-Sblockdiag.png

Part of the (ant based) build is to copy all images to /styles/rpi/graphics
so they aren't really missing...

When checking for 'missing' graphics,
should the docbook stylesheets prefix the graphics path in the xml source
with $img.src.path ?

If so , I'll report a bug. If not I'll accept the spurious report.

HTH






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

Re: [docbook-apps] Relocated graphics.... bug or not?

[davep]

On 11/29/2011 02:06 PM, Markus Hoenicka wrote:


davep  was heard to say:


During the build I get errors
Failed to load image: ARM1176JZF-Sblockdiag.png



Just a thought: does this error message indeed state that the image 
file was not where it was supposed to be, or does it state (quite 
literally) that the image could not be loaded from the file? I'm 
asking because I had quite a few problems with PNG files and fop 
recently, especially some which were created with the GIMP. I had to 
rewrite those to TIF (or even PNG) using ImageMagick.


regards,
Markus


Yes... The source file has href='file.jpg' i.e. in same directory as XML
former, but that means the latter (if you see what I mean?)

I'm doing it so that files loaded from my hard drive load
from the same 'absolute' location as from my website?

regards



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

Re: [docbook-apps] Relocated graphics.... bug or not?

[davep]

On 11/29/2011 02:31 PM, David Cramer wrote:

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

I think you've run into the bug mentioned here:

http://www.cygwin.com/ml/docbook-apps/2005-q1/msg00320.html

David

Yes. Looks like it.
Is it a bug processing or java? Or just the way I'm using docbook
to get what I want?

regards






On 11/29/2011 08:06 AM, Markus Hoenicka wrote:

davep  was heard to say:


During the build I get errors Failed to load image:
ARM1176JZF-Sblockdiag.png


Just a thought: does this error message indeed state that the image
file was not where it was supposed to be, or does it state (quite
literally) that the image could not be loaded from the file? I'm
asking because I had quite a few problems with PNG files and fop
recently, especially some which were created with the GIMP. I had
to rewrite those to TIF (or even PNG) using ImageMagick.

regards, Markus


-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJO1OykAAoJEMHeSXG7afUhVhEIAIEkFtBbgVyuWgdRu4sy3IHK
+A9XEmvy+Nv2FRlq31y4NctAhXXZBqgyo8TQss6wV8qyxaJCgCLWVGSyHJ+9ylhf
c50957zm/hvoxkcWuIGJmh74pMq0rU41ZyXGEnFHRRGRVHEZpnBIox7umiQyTbto
zx+r6z54dz26Q2ux3B4uS8ZAretvhG6m5zwTOJTLJ1aZhpcivHNHxF/K1JTSRrOy
BGub5GUzRDqIcR0T5outBFdkhwVv+pzcKpxEHvahhRdnc75Bal10Ockt5iI9lI+9
HDYxKck0andUohQCBq2cpmCjpn/Vv18524TAM+OgcDKdmoROr82hm3bPXlsRPYM=
=wC39
-END PGP SIGNATURE-

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





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

Re: [docbook-apps] Relocated graphics.... bug or not?

[davep]

On 11/29/2011 06:15 PM, Jirka Kosek wrote:

On 29.11.2011 16:55, davep wrote:


Yes... The source file has href='file.jpg' i.e. in same directory as XML
former, but that means the latter (if you see what I mean?)

I'm doing it so that files loaded from my hard drive load
from the same 'absolute' location as from my website?

BTW, have you tried setting
http://docbook.sourceforge.net/release/xsl/1.76.1/doc/html/graphicsize.use.img.src.path.html
to 1?

Jirka


 No Jirka.
   I now have a serious itch.
There are so many params in docbook xsl which interact,
one with another, that it really is worthwhile to document that
interaction.

Action: Any docbook users. Let me know of any interactions
that you know of... and I'll get them into the docbook xsl 
documentation... somehow.


Thanks for number 1 Jirka.

I'll still submit the bug though.

regards



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

Re: [docbook-apps] MSV validation?

[davep]

On 11/29/2011 07:18 PM, Bob Stayton wrote:
I've used Sun's Multi-Schema Validator with the Schematron add-on for 
DocBook5 files. The version with add-on was in a 'relames.jar' file.  
I am no longer able to locate a download for such a file.


Since Oracle bought Sun, it is now the Oracle Multi-Schema Validator.  
But I am not able to locate that on Oracle's site.


When I go to http://msv.java.net, I find "GlassFish > Project MSV", 
which does not mention relames or Schematron.  When I download the 
msv.20090415.zip files from that site, I find no mention of relames or 
Schematron in any of the files.


Does anyone know what is up with Multi-Schema Validator with 
Schematron support?



I don't think there's been much development for some time Bob?
I'll ask on the rng list, but I'm wondering if thought should be given
to dropping it if no longer supported?

regards


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

Re: [docbook-apps] Relocated graphics.... bug or not?

[davep]

On 11/29/2011 04:59 PM, Bob Stayton wrote:
Yes, as the message says, it is a bug introduced in version 1.67 of 
the java extensions.  The extension code is triggered when stylesheet 
parameters $use.extensions=1 and $graphicsize.extension=1.


It appears that a bug report was not filed (I cannot find such a 
report).  Would you mind submitting a bug report so this can get 
tracked and fixed by a Java programmer familiar with that code?


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



   Item created successfully. (Artifact3445867
   
)



HTH

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

Re: [docbook-apps] passivetex support

[davep]

On 12/15/2011 08:03 AM, Klaus Schilling wrote:


Is Docbook In ConTeXt usable for Docbook5?

Or what other free software tools without java exist for that purpose?

Emacs + nxml-mode. Very solid, also provides
an xslt 2.0 mode.


HTH



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] Opera oddity

[davep]

using opera labs 12.0 beta.

I have my images at /dir/dir/name.jpg

Works fine in FF, Chrome.

For some strange reason I get the 'graphic missing' glyph in Opera?

Anyone else noticed this?



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] Sun Java, 64 bit, core dump?

[davep]

Getting rather regular recently.
I'm on Linux if it makes a difference.

I run docbook transforms using Ant.
xInclude, Validate, transform to html.
I can do it half a dozen times then
I get a core dump.
Rebooting or log-off/-on seems
to cure it for a while.

Today it was using a transform in oXygen.
Ran fine for most of the day, then a core
dump, again on the transform.

Anyone else seeing this please?


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

Re: [docbook-apps] Content Management solutions that support DocBook 5.x?

[davep]

On 02/04/2012 02:58 AM, Bob Stayton wrote:

Hi Jeff,
There is a pretty wide range of content management systems out there.  All of 
them would support checking in DocBook files, since those are just text files.  
It would help if you could post some more detailed requirements.  What are you 
looking for the system to do?  How will it be used, and by how many people, etc.

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


A related question here.
If you imported a docbook (or any other XML file) into a CMS,
would you expect it to be validated (and rejected  if
the file were not valid docbook ) on import?

Something I found this week which surprised me.
A well formed document, but invalid, was rejected.


regards DaveP



--
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

Re: [docbook-apps] Regarding the project DocBook to Word XML roundtripping XSLs

[davep]

On 02/04/12 05:03, Buddhiprabha Erabadda wrote:



Are there any other links to resources which might be useful to further
study about the project DocBook to Word XML roundtripping XSLs? I am new to
DocBook and I would appreciate advice regarding the project. Thank you in
advance.


http://www.zveno.com/open_source/dbk-wordml.html

Steve has been doing this for some time?

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] Indexing.

[davep]

I'm about to start indexing a db5 book.
Reading up on the subject(Nancy C. Mulvany) and wondered if anyone has
been there and done that, got the tee-shirt and found the pitfalls in 
docbook? Any advice from those with lots of experience of using

db indexes please?



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

Re: [docbook-apps] Indexing.

[davep]

On 05/05/12 11:00, Thomas Schraitle wrote:

Any advice from those with lots of experience of using
db indexes please?


Are you asking more about the indexing task itself or about the technical
aspect?


The docbook aspects please Thomas



Speaking about the indexing task itself, IHMO this is something that some
books don't take it seriously enough. An index is a service to make the book
more accessible to readers. I've seen lots of bad index which came just as an
alibi, but with no value.
So it isn't a surprise that a good index takes time and energy. When I've
created the index of my book, it took lots of iterations and I guess it still
isn't perfect. :)


I'm hoping I can learn about the task from this book (at least a little)





If you are more interested in the technical aspect, that depends (heavily) on
your document. I assume, you write more technical documents, right? In that
case, you can automate (some) things to make the indexing more easy.


Yes, this is what I'm interested in. And yes, it is a tech document.



For example, if you write about HTML5 you will probably use  or
. If you use this tag consistently, you can add some of them
(semi-)automatically to your index page through profiling. I've described this
topic in my book:

  http://doccookbook.sf.net/html/en/dbc.structure.adding-indexterms.html


Thanks... I was thinking of a manual 'edit' (addition of indexterm)
but I'll have a look at this.



With the help of profiling, this eases the pain of indexing and you can
concentrate on the more difficult parts that can't be automated.

Hope that helps and good luck with your index. :-)


Thanks Thomas




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

Re: [docbook-apps] Indexing.

[davep]

On 05/05/12 12:52, PC Thoms wrote:

  Hi Dave

Mulvany's text is an excellent indexing manual.
The Chicago Manual of Style (http://www.chicagomanualofstyle.org/home.html)
has a concise chapter on indexing. A free trail is available, and this
manual is usually available at a library in the reference section.


I have the 14th edition. Ch 17 is apposite.



I have indexed books using docbook and TEI.
And my preference is docbook.


 Me too.



I did made a note to for myself some time back that an  inside a
footnote caused an error. I was using oXygenXML v12 at the time. Not sure
if this is still the case.


"Footnotes aren't normally indexed" is one piece of advice. So perhaps
docbook is right.




I did have a problem with the placement of the  but that was
answered at:
http://www.docbook.org/tdg51/en/html/indexterm.singular.html
Whitespace around  may affect placement of the IDs in PDFs
generated.


This is the sort of issue to which I referred (nothing like experience?)




Here are two examples of the  that have worked for me.



SHAKESPEAREShakespeare




The Shakespeare

  . . . .
  . . . .




I knew it existed, though I haven't used it.



Overall I have been pretty satisfied indexing with docbook.

And Dave, I know you are familiar with Bob Sagehill's book which has the
following:
http://www.sagehill.net/docbookxsl/GenerateIndex.html

Indexing an e-text it is very easy to over index. Generally an indexer is
allotted a limited number of pages for an index, but in an e-text what's a
few more bits. A bigger index does not mean a better index.


Common sense and balance? Paper (modulo 32 is not an issue in my case).




Happy Indexing


I'll report back!

Thanks.




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

Re: [docbook-apps] Better rendering for programlisting

[davep]

On 05/05/12 14:33, Norman Walsh wrote:

Hello world,

The current rendering for verbatim environments, when line numbers are
enabled, has a significant deficiency: you can't cut-and-paste the
listing without also getting the line numbers and separators.

Looking around at other sites with numbered program listings, the
solution seems to be to use tables. Put the line numbers in the first
column and the listing in the second.

That works, mostly, but if anything in the listing causes a variation in
line height (such as a larger callout), the numbers and the lines get
out of sync.

Using one-line-per-row fixes this, but then cut-and-paste doesn't work
again; the selection crosses over all the columns in each row.

An alternative solution uses nested divs and some slightly fancy CSS.
Naturally, it doesn't work in IE.

I've put an example online: http://nwalsh.com/scratch/out.html

The callout graphics in the listing are intentionally broken because
that was the easiest way to introduce variation. At this font-size,
the callouts are actually ok.

So:

1. Stick with what we have now.
2. Use the table solution and accept the limitation that all lines
must always be the same height.


Why is this an issue Norm? How often in a fixed width font do
users want exponents/Drop caps etc?



3. Find a way to tweak the CSS solution so that IE doesn't fall over


(or chase pixie dust?)




I'm open to suggestions on 3, but I'm not likely to figure it out myself.

Thoughts? Other suggestions?


You've obviated the line numbers by putting content in col 2...
why not finish the job and put co in col 3?

Then I could cut/paste?

HTH





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

Re: [docbook-apps] Re: Indexing.

[davep]

On 05/05/12 17:15, Norman Walsh wrote:

The sources for The Definitive Guide have quite a bit of index markup from
the O'Reilly copyedit. That might be a good place to look for examples.




Indexing is an art.


Yes. Exactly how it's described in this book I'm reading.
Tks for the reference, I'll take a look at  tdg Norm



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

Re: [docbook-apps] Re: Indexing.

[davep]

On 05/05/12 17:17, Norman Walsh wrote:

davep  writes:

I did made a note to for myself some time back that an   inside a
footnote caused an error. I was using oXygenXML v12 at the time. Not sure
if this is still the case.


"Footnotes aren't normally indexed" is one piece of advice. So perhaps
docbook is right.


I have a vague recollection that we may have loosened that restriction.

 Be seeing you,
   norm



To be precise the 'guideline' is Don't, unless they contain substantive
content relevant to the text.
I.e. bit gray?





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

Re: [docbook-apps] Indexing.

[davep]

On 05/05/12 18:57, Richard Hamilton wrote:

Dave,

Regarding the markup mechanics, here are two possibly unexpected things to look 
out for:

1) When you are doing a range, the closing index term in the range cannot 
follow a section close. I.e., If you have the following

   some text.
  
 
  


Generally this is not a problem, since you can move the index term up in a case

>like this without changing its position in the resulting text.
  ^^

It happens because the grammar doesn't allow much after a section closes except

>another section and a couple of other elements.

I guess this is the key bit. 'Guess' where the page number will be and 
align the element in a valid position.

Being a singleton it can 'cross' section boundaries though...






2) If you have space (including newlines) between index terms, you will get 
extra space

> in the output. E.g.,


In Shakespeare's Hamlet,Shakespeare
Hamlet
plays, Shakespeare
everyone (nearly) dies in the end.

In PDF output, you will get "In Shakespeare's Hamlet, everyone (nearly) dies in 
the end."

> The "^" characters are space characters that come through in the output.
> You can avoid this by not leaving any space/newlines between 
successive index terms.
> In the Definitive guide, you will find things like the following, 
where an indexterm is

> opened on one line and then continued (space inside are ok):


In Shakespeare's 
Hamlet,Shakespeare
Hamlet
plays, Shakespeare
  everyone (nearly) dies in the end.

I think this happens because the parser sees the white space between the index 
terms
(and in front or after) as distinct instances of white space that need to be 
preserved.



Rather more subtle Richard, thanks. I can see the logic.
... Just to check, it is the space *inbetween* 's that is 
causing the problem? Despite the fact that it shows (visually) at the 
end of the indexterm. Space between 

 is insignificant ws.






Neither is hard to avoid, but they can be frustrating (esp. the second one)

> if you're not expecting them.

Certainly I wouldn't be expecting the second one.
Thanks Richard.



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

Re: [docbook-apps] Better rendering for programlisting

[davep]

On 06/05/12 01:23, David Cramer wrote:

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 05/05/2012 10:38 AM, davep wrote:


1. Stick with what we have now. 2. Use the table solution and
accept the limitation that all lines must always be the same
height.


Why is this an issue Norm? How often in a fixed width font do users
want exponents/Drop caps etc?


The callouts cause the lines that contain them to be a little higher
than the others, causing the line numbers to become out of whack. If
you have more than a couple of callouts, the code listing ends up
extending beyond the line numbers and obviously the line numbers
aren't accurate.



Understood. I viewed them as character glyphs.





I'm open to suggestions on 3, but I'm not likely to figure it out
myself.

Thoughts? Other suggestions?


You've obviated the line numbers by putting content in col 2... why
not finish the job and put co in col 3?


But what if the user wants to put the callout somewhere other than the
end of the line? If you do that, you should just abandon callouts and
refer to line numbers from a list below the code listing.


If you want that you can't let your readers cut and paste as (I think)
is the objective here?
'Readers come first'??





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

Re: [docbook-apps] Indexing.

[davep]

On 06/05/12 22:45, John W. Shipman wrote:


There are certain very specific fetishes I have about indexing
that I see violated quite often.


!Not sure you should be talking about your fetishes in public John!!




The index to the "Guide to LaTeX" by Helmut Kopka has an example
of a horrible flaw that severely compromises its usefulness:
if a major topic is continued over a page break, the major
topic is NOT repeated on the continuation column.


?? Continuation column?

topic page 4  -   5
Is the '5' the continuation column?



Think about how you use an index: you depend on the top words
of each column to be in alphabetical order. But on page
584 of Kopka's book, the entire column is a continuation of
major topic "package", but the first entry is "amsmath".
So you think you're in the "a" section of the index, but you're
actually in the "p" section!


I think I interpret your 'continuation column' as meaning
the part of the back of the book index which happens to have
a page break in the middle of a main entry? Is that right?



It should look like this, but in many books I don't see a
line like the first one:

package (continued)
amsmath, 191, 269-270
amsopn, ...



a) I don't think (someone correct me if I'm wrong) that we'd
see the first line in a db output? Happens with table headers
but indexes? I.e. we'd only see
   amsmath, 191, 269-270
   amsopn, ...
Where the reader has to infer the sub-topic from the indent?



An obvious application for marks.


Yes.



My next suggestion may slightly increase the page count, so I
never mentioned it back in the day when dead trees were the
only route to publication. However, the increase is small,
and inexcusable if you expect most people will e-read your
book.

As an example, the discussion of the amsmath package should
have two entries:

amsmath package, 372
packages, 366
amsmath, 372

In general, if an indexable phrase has more than one important
word, it should appear in the index under each of those words.


+1 with your example. Covered in the book I'm reading, though
the author cations on making it an iron rule. Again the reader
comes first.




I can't give you any useful suggestions on current tools. Back
in the day I just invented a file format for entering all the
indexable references and then wrote my own software in C to
generate the index in TeX. This approach assumes that the
page numbers are all cast in stone, which was fine because
in my cases the rest of the book had all been put to bed.


Which is the case the author talks about (quite endlessly in fact)
but not so in my case. I'm thinking I may be able to have a two
swipe go at it, but that's for the future.

Thanks John.




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

Re: [docbook-apps] Indexing.

[davep]

On 11/05/12 21:27, Bob Stayton wrote:

Regarding the (continued) label for long index entries that break across
a column, I've implemented that feature for a client in XEP using its
extension property rx:table-omit-initial-header, in a manner similar to
that feature for repeating table titles across page breaks. In this
case, each primary indexterm is placed in a one-column table. I think
the XSL 1.1 retrieve-table-marker feature could probably do the same
thing without resorting to an extension, but I've not tried it.

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


If this is implemented in axf, do you think it is a worthwhile addition Bob?

http://www.antennahouse.com/xslfo/fo.htm
6.13.7 fo:retrieve-table-marker Extendedyes 

So it seems it is?

regards







- Original Message ----- From: "davep" 
To: 
Sent: Monday, May 07, 2012 12:10 AM
Subject: Re: [docbook-apps] Indexing.



On 06/05/12 22:45, John W. Shipman wrote:


There are certain very specific fetishes I have about indexing
that I see violated quite often.


!Not sure you should be talking about your fetishes in public John!!




The index to the "Guide to LaTeX" by Helmut Kopka has an example
of a horrible flaw that severely compromises its usefulness:
if a major topic is continued over a page break, the major
topic is NOT repeated on the continuation column.


?? Continuation column?

topic page 4 - 5
Is the '5' the continuation column?



Think about how you use an index: you depend on the top words
of each column to be in alphabetical order. But on page
584 of Kopka's book, the entire column is a continuation of
major topic "package", but the first entry is "amsmath".
So you think you're in the "a" section of the index, but you're
actually in the "p" section!


I think I interpret your 'continuation column' as meaning
the part of the back of the book index which happens to have
a page break in the middle of a main entry? Is that right?



It should look like this, but in many books I don't see a
line like the first one:

package (continued)
amsmath, 191, 269-270
amsopn, ...



a) I don't think (someone correct me if I'm wrong) that we'd
see the first line in a db output? Happens with table headers
but indexes? I.e. we'd only see
amsmath, 191, 269-270
amsopn, ...
Where the reader has to infer the sub-topic from the indent?



An obvious application for marks.


Yes.



My next suggestion may slightly increase the page count, so I
never mentioned it back in the day when dead trees were the
only route to publication. However, the increase is small,
and inexcusable if you expect most people will e-read your
book.

As an example, the discussion of the amsmath package should
have two entries:

amsmath package, 372
packages, 366
amsmath, 372

In general, if an indexable phrase has more than one important
word, it should appear in the index under each of those words.


+1 with your example. Covered in the book I'm reading, though
the author cations on making it an iron rule. Again the reader
comes first.




I can't give you any useful suggestions on current tools. Back
in the day I just invented a file format for entering all the
indexable references and then wrote my own software in C to
generate the index in TeX. This approach assumes that the
page numbers are all cast in stone, which was fine because
in my cases the rest of the book had all been put to bed.


Which is the case the author talks about (quite endlessly in fact)
but not so in my case. I'm thinking I may be able to have a two
swipe go at it, but that's for the future.

Thanks John.




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






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






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

Re: [docbook-apps] Copyright and dbtimestamp

[davep]

On 14/06/12 22:57, deannel...@aol.com wrote:

Ok, I found the issue inside my layers.

However, this issue should be able to work easier than shutting off the
multi year combination parameters. I assume that the dbtimestamp is being
evaluated after the multi-year-combination template of the copyright/year?

Is there a way to get the dbtimestamp evaluated earlier?



Very smart indeed.

Proposal? that this idea be made available for copyright as part of the
general distribution? Surely Dean isn't the only one to realise that
his copyright is now n years out of date?



  2005-&CURRENT_YEAR;
  My Company
  

Not sure how syntactically, possibly using the PI where Dean has the 
entity? but having me specify 2005, and letting the stylesheets pull in

the current year seems a good way to address this?


regards DaveP





--
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

Re: [docbook-apps] Copyright and dbtimestamp

[davep]

On 15/06/12 08:01, deannel...@aol.com wrote:

How about
  or something like that?


Yes. It's the idea I like.
Sort of keeping docbook up to date without doing anything?

regards








In a message dated 6/14/2012 10:19:29 P.M. Pacific Daylight Time,
da...@dpawson.co.uk writes:

On  14/06/12 22:57, deannel...@aol.com wrote:

Ok, I found the issue inside  my layers.

However, this issue should be able to work easier  than shutting off the
multi year combination parameters. I assume that  the dbtimestamp is being
evaluated after the multi-year-combination  template of the

copyright/year?


Is there a way to get the  dbtimestamp evaluated earlier?



Very smart indeed.

Proposal?  that this idea be made available for copyright as part of the
general  distribution? Surely Dean isn't the only one to realise that
his copyright  is now n years out of date?



2005-&CURRENT_YEAR;
My  Company


Not sure how syntactically, possibly using the PI  where Dean has the
entity? but having me specify 2005, and letting the  stylesheets pull in
the current year seems a good way to address  this?


regards DaveP









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

Re: [docbook-apps] generating a custom css to epub3 -- how? (+ italics?)

[DaveP]

On 07/18/2012 07:21 AM, Robert Nagle wrote:

  I've started to play around with the epub3 stylesheets. I noticed
that with the epub3 there is a docbook.epub.css which is generated in
the output directory.

I don't know what the rationale for this was (although I appreciate
that there are default css values included, and that you can add a
secondary css file which is also found in the package.opf file).

1. In a thread last year
http://markmail.org/search/?q=docbook.css.source&q=list%3Aorg.oasis-open.lists.docbook-apps#query:docbook.css.source%20list%3Aorg.oasis-open.lists.docbook-apps+page:1+mid:2blrnk6etoz5jr63+state:results
Bob mentions this:

**
Regarding your objections, I get around those by using XInclude. I have a
standard CSS file that I include into an XML file using XInclude:

 http://www.w3.org/2001/XInclude"/> 

That way I keep all the edits in one standard CSS file, and I don't have to copy
it into each output directory using a separate command.
*


I tried doing what Bob suggested, but it doesn't work -- possibly
because I don't really understand what is going on here.



I expand xIncludes prior to processing, as a separate step?
>xmllint --nofixup-base-uris --format -o $2 --xinclude $1
Then I can validate the full file prior to processing.
That processes param 1 through to param 2, processing xIncludes

Unless your processing includes the xInclude expansion,
it won't work.

HTH



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] Re: generating a custom css to epub3 -- how? (+ italics?)

[DaveP]

On 07/18/2012 08:13 AM, Robert Nagle wrote:

Ok, I haven't achieved my goal, which is causing docbook2.css to be
copied into the target directory. The xhtml references the
docbook2.css file though.

Ok, Dave are you saying that I need to preprocess the xsl
customization layer in order to expand the xinclude and drop the css
stuff inside? Then, after I have done this, I will have to process it
again? (something akin to two pass processing).

How would I do this with Saxon (if it's possible)? Would I need to do
two-pass processing (where I process it into an intermediary file?



The stylesheet contains the xinclude
docbook2.css.xml

  http://www.w3.org/2001/XInclude"/>

(I hope you close the xsl:param)

So you need to run the stylesheet through an xInclude processor,
or select the param to saxon to use xinclude

I have that as

# for xinclude 
-Dorg.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XIncludeParserConfiguration"/>


In which case the stylesheet parse will expand the xInclude, and the 
parameter will contain 'your' css file.


HTH




***


The problem is that I don't know what's going on with these
 parameters, and what Bob's answer means. Am I including a css file or
 an xml file which contains css information?

Dave Pawson replied:

The 'text' bit





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

Re: [docbook-apps] Multilanguage DocBook documents - best practices needed

[DaveP]

On 07/23/2012 07:58 AM, Jirka Kosek wrote:


In my experience the following works pretty well:

1. Store your source language (usually English) as modular DocBook
documents.

2. Prior sending document for translation assemble it into one large file.

3. Use agency which has very good translation software with translation
memory

4. If source document is updated, make one large assembled file again --
with translation memory only changed part of documents has to be
translated again.

Jirka



Which makes me think you have two separate documents, one for the 'master'
and another for the second language? Is that right Jirka?

I too thought it should be possible to have more than one language in
a single file.
The @id issue is only important for a built document, at which time
all except one language can be filtered out using XSLT?

regards




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

Re: [docbook-apps] Multilanguage DocBook documents - best practices needed

[DaveP]

On 07/23/2012 10:15 AM, Thomas Schraitle wrote:

Hi Dave,

On Mon, 23 Jul 2012 09:29:49 +0100
DaveP  wrote:


[...]

I too thought it should be possible to have more than one language in
a single file.


Well, you *could* use the lang attribute and carefully assemble your
structure if you want to add different translations:

   
  
 Making Tea
 Tee kochen
 
   
   ...
   ...
   

With profiling you can select just the language you are interested in.
Well, theoretically.

However, I don't think you should use more than one language in the
same file. It's neither really practical nor convenient. You end up
with lots of of paras and phrases. And you loose context and it is
really hard to edit such a file.



Sounds sensible on the practical issues. It's not something I have
ever done personally.
  Judging the right level for translation seems key.
More than phrase. ? More than para?
section level might be right to make an identifiable unit.



Apart from these structural thoughts, there is one issue that isn't
mentioned in this thread: version control. If you work with version
control systems (VCS, which you should), a writer and translator cannot
modify a single file at the same time.


I would suggest that sending XML to a translator is impractical (for
the majority of translators?) Sending them identifiable units seems
more practical.



Although a modern VCS should

detect any modifications and merge them automatically, there is always
the danger that you *could* potentially create conflicts.
Think you need to remove a whole section because it's not relevant
anymore. Or you need to restructure your file. These actions will very
likely create conflicts for your poor translator.


yes, this puts the workflow into focus! Need to get that right.




All in all, I would be _very_ reluctant to create _all_ translations in
_one_ file. That's the reason why there are translation memory systems
as mentioned before.


I wasn't suggesting that. As with any docbook unit, splitting it out
into appropriate units makes sense?

Two totally separate books, one for each of two languages, seems quite
odd to me, hence my original question.


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

Re: [docbook-apps] WYSIWYG Editor for docbook

[DaveP]

On 08/13/2012 09:14 AM, Paul Taylor wrote:

On 13/08/2012 02:19, deannel...@aol.com wrote:

Paul,
I've used oXygenXML before and if you can afford it, it will
accelerate your content development. However, if you need a cheap
(free) editor with "OK" XML support, use Eclipse which has XML support
and a spell checker.

I think youve missed the point here Dean, I want a WYSIWYG editor which
can save as docbook format, not an Xml Editor


oXygen has a true Wysiwyg mode and can use docbook.



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

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

[DaveP]

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] website 2.6

[DaveP]

In my output I'm seeing


  

   etc

in website.xsl there is a call to head.xsl which is followed,
proven by outputting comments.

  
  
head, head.mode




I am stuck, wondering where the charset definition is coming from?

Any suggestions please?


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

Re: [docbook-apps] website 2.6

[DaveP]

On 09/14/2012 11:16 AM, Jirka Kosek wrote:

On 14.9.2012 11:15, DaveP wrote:


I am stuck, wondering where the charset definition is coming from?


It is automatically generated if the output method is HTML. This is
standard feature of XSLT.



?
Input




ss

http://www.w3.org/1999/XSL/Transform";
version="1.0">

  

  

  

  

  



output

$ sax crap.xml crap.xsl crap.html
[dpawson@homer xsl]$ cat crap.html

   

Using saxon 6.5

specifying @encoding in the xsl:output still has no effect?




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

Re: [docbook-apps] website 2.6

[DaveP]

On 09/14/2012 11:38 AM, DaveP wrote:

On 09/14/2012 11:16 AM, Jirka Kosek wrote:

On 14.9.2012 11:15, DaveP wrote:


I am stuck, wondering where the charset definition is coming from?


It is automatically generated if the output method is HTML. This is
standard feature of XSLT.



?
Input




ss

http://www.w3.org/1999/XSL/Transform";
 version="1.0">

   

   
 
   

   
 
   



output

$ sax crap.xml crap.xsl crap.html
[dpawson@homer xsl]$ cat crap.html




Yes, you are right Jirka.
http://www.w3.org/TR/xslt#section-HTML-Output-Method

 If there is a HEAD element, then the html output method should add a 
META element immediately after the start-tag of the HEAD element 
specifying the character encoding actually used. For example,


Notes it is a 'should'

If I add the head element, I get the meta output, with the
encoding (seemingly ) derived from the input xml encoding.

So where do the website stylesheets get the encoding from?

Puzzling






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

Re: [docbook-apps] website 2.6

[DaveP]

On 09/14/2012 01:30 PM, Jirka Kosek wrote:

On 14.9.2012 13:52, DaveP wrote:


If I add the head element, I get the meta output, with the
encoding (seemingly ) derived from the input xml encoding.


It's definitively not from XML input encoding.

It's exither from xsl:output instruction if you are generating single
file output. If you use website in the version that's doing chunking,
then there is parameter for this:

http://docbook.sourceforge.net/release/xsl/current/doc/html/chunker.output.encoding.html

I think it should be used by Website as well.


So it is :-)
  It's imported from docbook stylesheets IIRC

Many thanks Jirka.

Having sorted that I'll go try the new website code.

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

Re: [docbook-apps] Images not getting output in all formats using Oxygen 14.0

[DaveP]

On

The WebHelp output (either the one which comes with Docbook or the
customized Oxygen WebHelp) executes an ANT transformation which
besides applying the XSLT stylesheets on the XML files does additional
operations like copying image folders to the output folder.


Yes realized later on I could copy the images over myself so not such a
big deal, but a bit inconsistent don't you think ?
As much as possible I want to create one help file and not consider the
output formats at all whilst writing it, then one click I want it
rendered nicely for each formats

Paul


IMHO it would be wrong for the stylesheets (or editor) to move images 
that the user has set up.


So moving the images to where you want them, relative to where you 
create the output, seems the right solution to me.




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

Re: [docbook-apps] Wrong PDF output: Custom button-format is only displayed in the Oxygen Editor and HTML, but not in PDF. Frame is missing.

[DaveP]

On 10/05/2012 01:42 PM, Aaron DaMommio wrote:

I'm no expert on fo properties, Daniel, but here is a reference to the
properties available for margins on an inline:
http://www.schemacentral.com/sc/fo11/ag-fo_common-margin-properties-inline.html



Thanks for that Aaron. Not sure how valid the xsd schema is, but it's a 
useful set of pages! Probably better generated from the WD itself.






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

Re: [docbook-apps] PDF transformation: Why is the right border of my inline "box" missing when I transform to PDF. It works for HTML and Oxygen XML Editor.

[DaveP]

On 10/12/2012 01:37 PM, daniel.ke...@finaris.de wrote:

Hi Simon,

we have implemented some custom styles in our style sheet and schema, so
d:button shuld/ does match.

As mentioned before, it is a custom style. It works for HTML and our
Oxygen XML Editor, but not for PDF.

Is it possible that our FO processor, i.e. Saxxon, does not work?


Daniel



No Daniel, very unlikely. Saxon is probably the most conformant
and well tested processor.




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

Re: [docbook-apps] re: How to create sidebars for epub3?

[DaveP]

On 10/13/2012 03:43 AM, Robert Nagle wrote:

Jason, one thing that you should remember is that Amazon recently made
the Kindle 3s support KF8. Kindle 3s were available as early as Fall,
2010, so that did wonders for backward compatibility. Ideally one
would like to support everything, but I think people trade up their
ebook devices a lot more regularly than their laptop for example. The
Kindle 4 (i.e., Kindle Touch) now sells for $70. I just can't imagine
that there are many Kindle 1 and 2 owners who have refused to trade up
to a 70$ device.



About the same number of ie6 or 8 users?
I think the above logic is flawed. Customers are strange beasts.





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

Re: [docbook-apps] Setting book toc.indent.width for sect1

[DaveP]

On 10/13/2012 08:33 AM, Xmplar wrote:

In a book toc, I need to set the first-level sections listed under each chapter
against the left margin of the toc.

The screenshot showing the sections listed under Chapter 2 is what I’m trying to
achieve with a customization of toc.indent.width (I think that’s what I need
anyway).

I used a single toc.indent.width value (29pt), and in the FO I changed the
margin-left for the fo:block that has a chapter id number, to give it a negative
value for toc.indent.width.


Using pt as length values may be interesting when viewed in a PDF viewer.

What happens when I zoom in to make the document readable (to me)?
Do the values remain constant? I.e. distort wrt remainder of the document?

If your base font is 10pt, try some value relative to that, 3em or 
something, to see if the spacing remains constant (relatively)


Just a thought.


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] DTD documentation.

[DaveP]

A relatively new project
https://github.com/NCBITools/DtdAnalyzer
documents DTD's, enabling markdown additions.

I ran it on docbook, then the xslt.
Produces a neat (undocumented of course) variant
of the docbook dtd.

Others may find it useful to aid in documenting dtd's.



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] Indexing markup... emacs

[DaveP]

Reading a very good emacs blog
I found the guy has a book, $5 US
http://ergoemacs.org/emacs/buy_xah_emacs_tutorial.html

The blog is good, I'm finding the tutorial really handy

Quick lesson in macros. Docbook indexing.

Highlight the term, M-x pi
with or without s (for secondary term)

Enjoy.


(defun pi (class start end)
  "Markup for docbook index, optional secondary term"
  (interactive "sEnter s for secondary : \nr")
  (let* (
 (idxterm  (buffer-substring start end))  ; the indexed term
 (termlen (length idxterm))  ; len of above
 (pms (concat "" idxterm ""))
 (sms "")
 (sme "")
 (pme "")
 (pml (length pms)) ;; primary length
 (sml (length sms))  ;; secondary length
 ) ;; end of local vars
  (goto-char (- end termlen ))(insert pme )
(goto-char start)(insert pms)
(when (equal "s" class) ;; if secondary wanted
   (insert (concat sms sme )))
(setq newpoint
  (if (equal "s" class)
  (+ (length pms) (length sms)) ;; insert point for secondary
(+ (length pms) (length pme))
))
(goto-char (+ (region-beginning) newpoint))
))

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] snapshots unavailable? 11 11 12

[DaveP]

http://docbook.sourceforge.net/snapshots/

Error 503 Service Unavailable

Service Unavailable

Guru Meditation:

XID: 1275547498

Varnish cache server



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

Re: [docbook-apps] snapshots unavailable? 11 11 12

[DaveP]

On 11/11/2012 01:08 PM, David Cramer wrote:

Seems to be working fine now.

David


Yes. Thanks David.




On 11/11/2012 02:49 AM, DaveP wrote:

http://docbook.sourceforge.net/snapshots/

Error 503 Service Unavailable

Service Unavailable

Guru Meditation:

XID: 1275547498

Varnish cache server



regards




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







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] docbook website, version.... 6?

[DaveP]

I (finally) came round to using this.
Couple of comments, though I'd better define the version I'm using.

1. Schema

Autolayout.rng headed



3. Stylesheets
website.xsl

Re: [docbook-apps] DocBook XSL stylesheets version 1.78.0 have been released

[DaveP]

On 12/18/2012 10:19 PM, Bob Stayton wrote:

A candidate release 1.78.0 of the DocBook XSL stylesheets has been
released on
SourceForge for downloading.  After logging onto the DocBook SourceForge
site, go to:

Files > docbook-xsl > 1.78.0
or
Files > docbook-xsl-ns > 1.78.0


Are there any plans to make the ns version 'the' docbook stylesheets 
Bob? I.e. make db 5 the main development?





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] Re Customization: was annotating docbook sections

[DaveP]

On 30/12/12 08:17, Bob Stayton wrote:

> That titlepage mechanism is described in this documentation:


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

I make it a practice of examining (or copying) the original template
matching on an element before customizing it.  That way I can see what
special handling the stylesheet already performs, and fit my
customizations into that existing process.


Very sage(hill?) advice.

Docbook has caught me out more than once with the subtleties of 
processing such as those mentioned in this thread. It may be a bit

hard copying in a hundred lines or more of code, but it does ensure
a smoother customization.


Best wishes to the docbook team for 2013, and very many thanks for your
work in 2012.


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

[davep]

Latest stylesheets, db5 source, single file.

The readme says

xsltproc \
--stringparam base.dir ebook1/OEBPS/ \
epub3/chunk.xsl \
mybook.xml

I tried, with a source file tmp.xml, having created ./ebook and 
./ebook/OEBPS.


Having run the transform, I see

$ tree ebook
ebook
├── OEBPS
│ ├── bk01-toc.xhtml
│ ├── ch01s02.xhtml
│ ├── ch01.xhtml
│ ├── docbook-epub.css
│ └── index.xhtml
├── OEBPS..
│ ├── META-INF
│ │ └── container.xml
│ └── mimetype
├── OEBPSpackage.opf
└── OEBPStoc.ncx

3 directories, 9 files


I.e. rather than adding files to ./ebook, ?? has created ./ebook/..OEBPS 
which

may be an attempt to write files to the parent?

I'm on Linux. Is this an oddity? a feature of xsltproc? Something else?
suggestions please


DaveP

-
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

[davep]

On 30/01/13 08:25, davep wrote:

Latest stylesheets, db5 source, single file.

The readme says

xsltproc \
--stringparam base.dir ebook1/OEBPS/ \
epub3/chunk.xsl \
mybook.xml

I tried, with a source file tmp.xml, having created ./ebook and 
./ebook/OEBPS.


Having run the transform, I see

$ tree ebook
ebook
├── OEBPS
│ ├── bk01-toc.xhtml
│ ├── ch01s02.xhtml
│ ├── ch01.xhtml
│ ├── docbook-epub.css
│ └── index.xhtml
├── OEBPS..
│ ├── META-INF
│ │ └── container.xml
│ └── mimetype
├── OEBPSpackage.opf
└── OEBPStoc.ncx

3 directories, 9 files


I.e. rather than adding files to ./ebook, ?? has created 
./ebook/..OEBPS which

may be an attempt to write files to the parent?

I'm on Linux. Is this an oddity? a feature of xsltproc? Something else?
suggestions please


DaveP


Resolved.

http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html
Quote Starting with version 1.77 of the stylesheets, the param's value 
will have a trailing slash added if it does not already have one.


I don't think that is happening?


I changed to use saxon.

Setting the param within a stylesheet, adding a trailing slaxh
resolves the problem.


Since the readme contains the slash, perhaps the documentation is wrong.


regards DaveP