Re: [Boost-users] [boost-users][quickbook] Trying to get many sectionsonto one page

From: John Maddock (john_at_[hidden])
Date: 2007-03-17 05:51:34

Darren Garvey wrote:
>> Hello,
>>
>> I have a situation like this:
>> [section Section 1]
>> ...
>>
>> [endsect]
>>
>> [section Section 2]
>> ...
>>
>> [endsect]
>>
>> and I'd like the generated html to have the layout of an article
>> document-type but for it all to lie on one page. Obviously cut/paste
>> is easy enough, but I'm wondering what the correct way to do this
>> automatically is.

You need to alter the xslt options, assuming you're building via bjam, 
here's a (rather complex) example Jamfile that does something similar:

using quickbook ;

xml math : math.qbk ;
boostbook standalone
    :
        math
    :
        # HTML options first:
        # Use graphics not text for navigation:
        <xsl:param>navig.graphics=1
        # How far down we chunk nested sections, basically all of them:
        <xsl:param>chunk.section.depth=10
        # Don't put the first section on the same page as the TOC:
        <xsl:param>chunk.first.sections=1
        # How far down sections get TOC's
        <xsl:param>toc.section.depth=10
        # Max depth in each TOC:
        <xsl:param>toc.max.depth=4
        # How far down we go with TOC's
        <xsl:param>generate.section.toc.level=10

        # PDF Options:
        # TOC Generation: this is needed for FOP-0.9 and later:
        <xsl:param>fop1.extensions=1
        # TOC generation: this is needed for FOP 0.2, but must not be set to 
zero for FOP-0.9!
        <xsl:param>fop.extensions=0
        # No indent on body text:
        <xsl:param>body.start.indent=0pt
        # Margin size:
        <xsl:param>page.margin.inner=0.5in
        # Margin size:
        <xsl:param>page.margin.outer=0.5in
        # Yes, we want graphics for admonishments:
        <xsl:param>admon.graphics=1
        # Set this one for PDF generation *only*:
        # default pnd graphics are awful in PDF form,
        # better use SVG's instead:
        # <xsl:param>admon.graphics.extension=".svg"
    ;

The options you need to change are the "chunking" ones, these are documented 
in the Docbook XSL guide: 
http://docbook.sourceforge.net/release/xsl/current/doc/. Hopefully that's 
enough to put you on the right track.

John.