[boost-users][quickbook] Trying to get many sections onto one page
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. Regards, Darren
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.
Hi John, On 17/03/07, John Maddock <john@johnmaddock.co.uk> wrote:
<snip>
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
<snip>
This actually split everything up into sections. The comments were very helpful: 'chunk' seems an ambiguous word to me in this context. :) 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.
I got it now (<xsl:param>chunk.section.depth=0), so thanks very much for the help! Darren
participants (2)
-
Darren Garvey -
John Maddock