Re: [boost] BOOST documentation in PDF/PS format

From: John Maddock (jz.maddock_at_[hidden])
Date: 2008-06-02 04:47:55

Daniel James wrote:
> Thanks for the help. I've applied your changes, adjusted the PNG's
> pixels per inch so it isn't so huge, added an SVG and a few other
> tweaks. There's a new pdf at the same location:
>
> http://unordered.nfshost.com/pdfs/unordered.pdf
>
> I've also tried generating a single html page and creating a pdf from
> that using prince (http://www.princexml.com/). This approach should
> give us a little more control over page breaks using CSS. Although the
> html output isn't ideal for this kind of thing. The result so far is
> at:
>
> http://unordered.nfshost.com/pdfs/unordered-prince.pdf

These both look pretty good to me: the first has the "no page break in long
code block" issue, the second doesn't have the TOC at the side.

Actually there *may* be a solution to the
wrongly-keeping-long-blocks-together issue: insert a "<?dbfo
keep-together="auto" ?>" inside the Docbook XML for the long block, that
should then allow it to page break and stop it from starting a new page.
The problem is while I think I can see how to insert this into quickbook, I
can't see how to insert this into your ref.xml at present :-(

There's more info on page break issues here:
http://www.sagehill.net/docbookxsl/PageBreaking.html

HTH, John.