Re: Automated indexterms? was "DOCBOOK: proper use of indexterm?"

[Norman Walsh <ndw@nwalsh.com>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

/ David Cramer <dcramer@broadjump.com> was heard to say:
| I'm taking this in a tools direction, so moving it to docbook-apps.

Thank you!

| <snip/>
|> Any word that is in the glossary is interesting, so should be in the
|> index; I hoped to accomplish that by specifying the indexterm in the
|> glossentry - which appears legal from the documentation - and have the
|> processors search a <part label="A"> for occurrences of the term.
| <snip/>
|
| I've also notice that some elements should always be indexterms and
| thought that it should be automated. In cases where I use docbook as
| an intermediary format, I have added indexterms automatically on the
| way to docbook. One option would be to preprocess the file to add
| indexterms immediately before sending it to the DocBook xsls:

I think that would be the best option if you wanted to do this. For
one thing, the auto indexing code is about as hairy as XSLT gets.
Supporting more elements as indexterms is probably possible (might not
even be that hard, thinking about the code without looking at it) but
I'd like to avoid making that code any harder to grok.

But more importantly, good indexes are authored by hand. It's true
that in some documents most databases, filenames, etc., probably
appear in the glossary but it's not universally true that they all
should always appear there.

                                        Be seeing you,
                                          norm

- -- 
Norman Walsh <ndw@nwalsh.com>      | To what excesses will men not go
http://www.oasis-open.org/docbook/ | for the sake of a religion in
Chair, DocBook Technical Committee | which they believe so little and
                                   | which they practice so
                                   | imperfectly!--La Bruy�ère
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE+LpWHOyltUcwYWjsRAkYCAJ0Y8h4S8r9AYhs4hhVj/Fpq6Zd7mACcDitg
LOO8rofH+nPTA1MczCJ+TWk=
=A4NV
-----END PGP SIGNATURE-----