[Firebird-docs] Widowed section headers in PDF

[Philippe M. <mak...@a6...>]

>> So the only option (at least as long as we use Apache FOP) seems to
>> be: wrap every header in a single-cell table together with the text
>> that follows it. This requires editing our transformation stylesheets;
>> don't know how complicated it will be, but I'll have a look at it
>> (somewhere in the next weeks).
>>

It's seem that it is possible,
on my linux machine, I use db2pdf for my technical doc, and I have page-break
so it might be possible with FOP too ??

Perhaps some help with :

<http://cscisl.dce.harvard.edu/lecture_notes/20040722/links.html>
And this :

How to insert a pagebreak into docbook output

The answer's been that you need to use a processing instruction instead of an
element (so also need to write support in your XSLT customization layer for
generating a pagebreak in the FO output for each instance of that PI).

The suggestion from Paul Reavis on the debian-sgml list was to use <?dbfo
break-before="page"?>. Something like that would work -- there's existing
(undocumented) support in the stylesheets (dbfo-attribute template in fo/pi.xsl
and dbhtml-attribute template in html/pi.xsl) for processing PIs that start with
"dbfo" and "dbhtml" and extracting the pseudo- attributes/values from them.

As far as the rationale for the DTD not providing an element to force pagebreaks
in rendered output, it's just consistent with the fact that the DTD by design
provides markup only for modeling structure and content, not presentation. If a
pagebreak is strictly a processing thing and has no significance to structure or
content -- just something that's specific to print delivery, not to HTML or
online help, etc. -- then not really appropriate to have an element for it.

-- Philippe Makowski