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

From
Bob Stayton <>
Date
2008-09-15T17:14:21+00:00
ID
070f01c91756$ae0e2a40$6a00a8c0@pazu
Thread
Re: [docbook-apps] should simplesect be chunked?
Title: RE: [docbook-apps] should simplesect be chunked?

Hi,

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 ----- 

  
From: 
  Johnson, 
  Eric 

  
To: Dave Pawson ; Bob Stayton 

  
Cc: DocBook Apps 

  
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:]
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?

regards

--
Dave Pawson
XSLT XSL-FO 
  FAQ.
http://www.dpawson.co.uk

---------------------------------------------------------------------
To 
  unsubscribe, e-mail: 
For 
  additional commands, e-mail: