Re: Best way to create an index?

[Bob Stayton <bobs at sco dot com>]

On Tue, Nov 18, 2003 at 01:16:07PM +0000, Wookey wrote:
> +++ Herman Bruyninckx [03-11-17 20:04 +0100]:
> > I have a (steadily growing) number of docbook manuals, but haven't
> > been able to generate an index for them. I have the 
> > <indexterm> ... </indexterm>
> > tags in the documents, but don't know how to process them :-)
> 
> me too :-)
> 
> I managed to produce an index for the HTML versions of my docs (using
> collateindex.pl) but never got it to work properly for the PDF versions. I
> can generate an index but most of the page numbers don't get filled in and
> many that do are wrong.
> 
> It seems that changing from SGML to XML toolchains is now deemed a good
> idea. Does anyone know if this will improve the index-generation for printed
> docs?

If you process your XML with the DSSSL tools, then you
still must use the collateindex.pl step.  If you use
the XSL stylesheets and tools, then the stylesheet will
generate the index automatically if you have an empty
<index/> element in your document.  I consider that
a big improvement.  However, the current version of FOP,
the major free FO processor, does not know how to
collapse duplicate page references and page ranges in
an index.  The XEP processor can do that, though.

-- 

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