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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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


Subject: Re: [docbook] DocBook Technical Committee Meeting Minutes: 24 Sep 2003


On Fri, Sep 26, 2003 at 05:27:58PM -0400, Stefan Seefeld wrote:
> Norman Walsh wrote:
> 
> > 8b. Topic Index
> > 
> > NW: Explains the problem after more discussion with the submitter: the
> > need is really for general index terms of different types.
> > 
> > MS: TEI has this feature. And if you generate an index just from other
> > markup, then you don't get the richness of secondary, tertiary, etc.
> > If you really wanted to make a sophisticated index with different
> > types, you'd need to have this kind of markup.
> > 
> > NW: What are the semantics of this attribute?
> > 
> > Proposal: add a 'type' attribute to 'indexterm' and 'index' to support
> > this markup.
> > 
> > Accepted.
> > 
> > BS: How tightly we need to define the processing expectations?
> > 
> > Proposed semantics:
> > 
> > Indexterms of type 'x' go in index of type 'x'. An index with no type
> > gets all of the index terms regardless of their type.
> > 
> > In 4.3?
> > 
> > Yes.
> 
> That's awesome !
> 
> I'm now looking into patches for the xsl stylesheets to make that work.
> Looking into xhtml/index.xsl, I find the following comment, which I find
> slightly confusing, and may be even contradictory to the above processing
> expectations:
> 
>    <!-- some implementations use completely empty index tags to indicate -->
>    <!-- where an automatically generated index should be inserted. so -->
>    <!-- if the index is completely empty, skip it. Unless generate.index -->
>    <!-- is non-zero, in which case, this is where the automatically -->
>    <!-- generated index should go. -->
> 
> So what should I do ? Should I (for the time being) simply assume the
> 'generate.index' parameter is non-zero ?

I wonder which implementations that comment is
referring to?  Certainly the DocBook XSL stylesheets
work that way.

The generate.index parameter lets you turn off an
otherwise automatically generated index.  By
default, its value is 1, so you can assume it is
turned on.

In your investigations, be sure to look at the 'scope'
parameter in the index templates.  It permits the
templates to operate on a subset of indexterms.

-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com


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