Re: DOCBOOK-APPS: Page Breaking for each section?

[Markus Spath <mspath@arcor.de>]

Brian Burridge wrote:
> First, I'm very new to DocBook, just started using it earlier this week,
> and am very excited about the endless possibilities.
> 
> I have put together the document that I am tasked with creating (a
> design document), which includes images. Now, each section, is really
> just a title and an image. In some cases there will be text before the
> image, but not in most.
> 
> The problem I'm having is when it renders as a PDF. It is page breaking
> between the section title and the image many times. This looks very odd.
> What I need to do is tell the XSL to page break before each section.
> 

have a look at bob stayton's (excellent) documentation on the docbook stylesheets:

(basically, you can customize almost everything using a 'customization layer')


you are looking for:

<xsl:attribute-set name="section.title.level1(or 2,3...).properties">
   <xsl:attribute name="break-before">page</xsl:attribute>
</xsl:attribute-set>

(explained here: http://www.sagehill.net/xml/docbookxsl/PrintCustomEx.html#d0e7184)

how to use a customized stylesheet is explained here:
http://www.sagehill.net/xml/docbookxsl/CustomMethods.html#CustomDriverFile


hth,
Markus