docbook-apps

David Toplin said the DocBook stylesheets tell the FO processor to set
line-height-shift-adjustment to disregard-shifts (actually, he didn't
say that verbatim, but anyway). I see that the root.properties set
carries that setting. Why does it disregard shifts by default? Also,
in an old docbook-apps thread I found[1], Bob S. said that xsltproc
overwrote attribute sets (if set in the customization layer) instead
of merging them. Is it still doing that?

[1] http://sources.redhat.com/ml/docbook-apps/2003-q3/msg00595.html


--
http://chris.chiasson.name/

Chris Chiasson wrote:
> David Toplin said the DocBook stylesheets tell the FO processor to set
> line-height-shift-adjustment to disregard-shifts (actually, he didn't
> say that verbatim, but anyway). I see that the root.properties set
> carries that setting. Why does it disregard shifts by default? Also,
> in an old docbook-apps thread I found[1], Bob S. said that xsltproc
> overwrote attribute sets (if set in the customization layer) instead
> of merging them. Is it still doing that?

The reason is very simple -- if you use footnotes and doesn't set
disregard-shifts your lines wouldn't be spaced uniformly -- there will
be larger space between lines containing footnote reference which looks
quite ugly. Of course if you put some larger images or stuff like that
inline, you must change setting of this property appropriately.

It is impossible to create default output for DocBook that everyone
would like. But you are free to change appearance of output very easily
by specifying your own FO properties using corresponding attributes sets
in the DocBook XSL stylesheets.

Jirka

--
------------------------------------------------------------------
Jirka Kosek e-mail: jirka@kosek.cz http://www.kosek.cz
------------------------------------------------------------------
Profesionální školení a poradenství v oblasti technologií XML.
Podívejte se na náš nove spuštený web http://DocBook.cz
Podrobný prehled školení http://xmlguru.cz/skoleni/
------------------------------------------------------------------
Nejbližší termíny školení:
** XSLT 23.-26.10.2006 ** XML schémata 13.-15.11.2006 **
** DocBook 11.-13.12.2006 ** XSL-FO 11.-12.12.2006 **
------------------------------------------------------------------
http://xmlguru.cz Blog mostly about XML for English readers
------------------------------------------------------------------

On 11/17/06, Jirka Kosek <jirka@kosek.cz> wrote:
> It is impossible to create default output for DocBook that everyone
> would like. But you are free to change appearance of output very easily
> by specifying your own FO properties using corresponding attributes sets
> in the DocBook XSL stylesheets.

I realize that and was not criticizing the stylesheet authors. I just
wanted to know why it was done so that I could avoid whatever the
original problem was. Your explanation lets me know why people in the
old thread were suggesting[1] customizations such as:

<xsl:template
match="para[.//footnote|.//footnoteref|.//superscript|.//subscript]">
<fo:block line-height-shift-adjustment="disregard-shifts">
<xsl:apply-imports/>
</fo:block>
</xsl:template>

[1] http://www.oasis-open.org/archives/docbook-apps/200304/msg00366.html

Anyway, thank you.

--
http://chris.chiasson.name/