OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] should simplesect be chunked?

Title: RE: [docbook-apps] should simplesect be chunked?
I don't think section level is the right criterium for excluding simplesect from chunking.  A chapter can contain nothing but simplesect elements, making them equivalent to level1 sections.  Currently such a chapter would be a single chunk, even if each simplesect was long, leading to a very long chunk.  Also, in the chunking stylesheets, the level of section chunking is controlled by a stylesheet parameter. 
So you could have one chapter consisting of simplesects that is are not chunked, and another chapter consisting of single-level section elements, and only the latter chapter will be chunked.  Since simplesect is essentially a terminal section, that isn't the behavior I would expect.  Readers certainly won't know the difference.
The DTD defines a simplesect as identical to section except for its lack of section children, as well as not allowing index, glossary, and bibliography.  That sounds the same as all the terminal section elements that I write.  So I don't see why they are processing differently from terminal sections.
I was also surprised to see that simplesect does not get numbered when section.autolabel is turned on.  That makes no sense to me, and I think it is a bug.  The template with match="simplesect" mode="label.markup" in common/labels.xsl has code written to generate a number label for it.  I would have to dig deeper to see why it doesn't work.
Bob Stayton
Sagehill Enterprises
----- Original Message -----
Sent: Monday, September 15, 2008 4:51 AM
Subject: RE: [docbook-apps] should simplesect be chunked?

I was thinking the same thing as Dave.
Technically, I see no reason not make simplesect chunkable. However, I think, in most cases, the resulting HTML content would be too small to be a standalone page.
I guess there are use cases where chunking that low would be appropriate.

-----Original Message-----
From: Dave Pawson [mailto:davep@dpawson.co.uk]
Sent: Mon 9/15/2008 2:18 AM
To: Bob Stayton
Cc: DocBook Apps
Subject: Re: [docbook-apps] should simplesect be chunked?

Bob Stayton wrote:
> While reviewing a stylesheet bug, I also noticed that the simplesect
> element is not chunked.  That seems odd to me, since a simplesect is a
> real section, except that it cannot have child sections.  Does anyone
> see a problem with making simplesect into chunks?

Only that it seems intuitively wrong to chunk at such a low level?


Dave Pawson

To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]