Subject: Re: [boost] [quickbook] miss-generated headings?
From: John Maddock (boost.regex_at_[hidden])
Date: 2014-09-01 14:22:40
> On 1 September 2014 17:40, John Maddock <jz.maddock_at_[hidden]> wrote:
>> I have a problem with quickbook code that has [h6 ...] elements in it -
>> these end up being larger in both html and pdf output than [h5 ] blocks
>> which is not so good :-(
>> From what I can tell, [h5 ] actually produces html <h6> and [h6 ] produces
>> html <h5>.
> Looks like there's no 'h6' in docbook, the headings generate
> 'bridgehead' elements, which only have 5 levels of nesting, specified
> by the 'renderas' attribute:
> I think that 'h1' is the title, then 'h2' is 'sect1', 'h3' is 'sect2', etc.
> It might be possible that we could put something in our xsl to handle
> further levels.
>> BTW I realise [h6 ] is a lot of nesting, but the current stylesheet make
>> <h6> quite a bit larger than surrounding text, so <h7> seems to be not
>> beyond the realms of possibility?
> HTML headings only go up to 'h6'. We could possibly have 'h6' with a
> special class, but that won't convey the document structure to
> anything that reads the document, and there's a limit to how small we
> can go.
That's a killer argument against using it then ;-)
But in that case, I believe the quickbook docs need to remove the [h6 ]
example and explain that [h5...] is the maximum allowed?
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk