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


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-tc message

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

Subject: Re: DocBook V4.0beta1

I had never heard Highlights described as cooked (derived object?).
For us, the Highlights section is an authored overview of the chapter.

It's a little weird to put indexterms in an overview or summary, but
not _that_ weird.  An author who wrote a longish highlights section
might want to index the highlights because it has the best one-line
description of a feature.

What about the XML version -- aren't we going to have to allow
IndexTerms in Highlights there?  To disallow them in XML sounds
like more trouble than it's worth.


 > >Indexterms are explicitly excluded from Highlights. Anybody
 > remember why?
 > Yes.  Highlights were supposed to be a cooked representation of
 > topics covered in the book component - not content in themselves.
 > You might have constructed Highlights by extracting all the
 > section titles - as Norm's style sheet(s) do(es) [ Norm, is there
 > one or many? ].
 > So having Indexterms in Highlights would be like having Indexterms
 > in Indexterms, which I hope we disallow (but I'm afraid to look 
 > right now).  
 > So Michael must be using them for something we didn't foresee
 > (or not ...); Michael, why do you have Indexterms in Highlights?
 > regards, Terry

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

Powered by eList eXpress LLC