Title: RE: [docbook-apps] should simplesect be chunked?
Well, the way the pi works is that chunking stops from that
point down, so you'd only have to add it to any section that contains
simplesects. Still, I can see how that would be a burden if you have lots of
existing content with simplesects.
David
From: Johnson, Eric
[mailto:]
Sent: Tuesday, September 16, 2008
6:55 AM
To: David Cramer; docbook-apps
Subject: RE:
[docbook-apps] should simplesect be chunked?
So to maintain the current functionality of the stylesheets
I'd need to add a processing instruction to all of the simplesect elements in
all of my content? That seems like a lot of work.
I'd still ask for
simplesect chunking to be parameterized, but if if the community feels that
simplesect should chunk like regular sections then so be
it.
-----Original Message-----
From: David Cramer [mailto:]
Sent: Mon
9/15/2008 6:28 PM
To: Johnson, Eric; docbook-apps
Subject: RE:
[docbook-apps] should simplesect be chunked?
I had noticed that
simplesects don't chunk a while back when some of our
writers wanted a way
to create sections that don't chunk and simplesect
seemed a possible
answer. I was worried though that it was a bug that
would be fixed someday
:-) So I implemented <?dbhtml stop-chunking?> to
let writers control
where chunking stops and that's now part of the
xsls.
I don't have
strong feelings about simplesects chunking since we use the
processing
instruction. I can obviously understand the need for giving
writers the
option of creating sections that don't chunk. I do think
that either
simplescts should chunk or "The Definitive Guide" should be
updated to
indicate that the processing expectation is that they don't
chunk (or it
should be parameterized). The current processing
instruction will stop the
chunking of simplesects too btw.
David
> -----Original
Message-----
> From: Johnson, Eric [mailto:]
>
Sent: Monday, September 15, 2008 1:28 PM
> To: docbook-apps
>
Subject: RE: [docbook-apps] should simplesect be chunked?
>
>
Bob,
> I do not disagree with your position in theory. I can see
>
where there may be style guides that use simplesect in such a
> way as
they would be long enough to warrant entire html pages.
>
> I
don't think that having simplesect blocks being that long
> makes much
sense however. We use simplesect as the only
> terminal section
element.
> It is, in information mapping terms, a block. So a
chapter
> would never only have sect1 elements breaking it up
into
> sections. Such a chapter would use simplesect. If the
>
simplesect blocks get big enough to warrant it, then the
> chapter would
need to be broken up into sections - each of
> which contains a group of
simplesect element. sect1-sect5
> elements and section elements are not
used as terminal sections.
>
> Since this is only one way of doing
the mark-up using docbook
> and others will likely disagree with this
approach, I don't
> think adding the capabilities to chunk simplesect is
a bad idea.
>
> Perhaps simplesect chunking should have its own
parameter for
> being turned on and off? That way people whose output
depends
> on the current chunking algorithm for sections won't be messed
up.
>
> Cheers,
> Eric
>
> -----Original
Message-----
> From: Dave Pawson [mailto:]
>
Sent: Monday, September 15, 2008 1:54 PM
> To: Bob Stayton
> Cc:
DocBook Apps
> Subject: Re: [docbook-apps] should simplesect be
chunked?
>
> Bob Stayton wrote:
> > 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.
>
>
>
Too many what-if's there Bob. We can all make daft decisions
> when
marking up.
>
> For Docbook, used sensibly, there's no need to
chunk at
> simplesect level IMHO.
>
>
>
>
regards
>
> --
> Dave Pawson
> XSLT XSL-FO
FAQ.
> http://www.dpawson.co.uk
>
>
---------------------------------------------------------------------
>
To unsubscribe, e-mail:
>
For additional commands, e-mail:
>
>
>
---------------------------------------------------------------------
>
To unsubscribe, e-mail:
>
For additional commands, e-mail:
>
>
>
---------------------------------------------------------------------
To
unsubscribe, e-mail:
For
additional commands, e-mail: