[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:paramnavig.graphics=1 # How far down we chunk nested sections, basically all of them: xsl:paramchunk.section.depth=10 # Don't put the first section on the same page as the TOC: xsl:paramchunk.first.sections=1 # How far down sections get TOC's xsl:paramtoc.section.depth=10 # Max depth in each TOC: xsl:paramtoc.max.depth=4 # How far down we go with TOC's xsl:paramgenerate.section.toc.level=10 # PDF Options: # TOC Generation: this is needed for FOP-0.9 and later: xsl:paramfop1.extensions=1 # TOC generation: this is needed for FOP 0.2, but must not be set to zero for FOP-0.9! xsl:paramfop.extensions=0 # No indent on body text: xsl:parambody.start.indent=0pt # Margin size: xsl:parampage.margin.inner=0.5in # Margin size: xsl:parampage.margin.outer=0.5in # Yes, we want graphics for admonishments: xsl:paramadmon.graphics=1 # Set this one for PDF generation *only*: # default pnd graphics are awful in PDF form, # better use SVG's instead: # xsl:paramadmon.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
<snip>
boostbook standalone : math : # HTML options first: # Use graphics not text for navigation: xsl:paramnavig.graphics=1 # How far down we chunk nested sections, basically all of them: xsl:paramchunk.section.depth=10 # Don't put the first section on the same page as the TOC: xsl:paramchunk.first.sections=1 # How far down sections get TOC's xsl:paramtoc.section.depth=10 # Max depth in each TOC: xsl:paramtoc.max.depth=4 # How far down we go with TOC's xsl:paramgenerate.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:paramchunk.section.depth=0), so thanks very much for the help! Darren
participants (2)
-
Darren Garvey
-
John Maddock