Michael Day wrote:
> Jon Noring wrote:

>> Hmmm, maybe, I'll have to redig into DocBook. The section I looked at
>> with regards to DocBook indexing did not appear to embed indexing
>> information within the content documents, but simply defined how to
>> build a "back of book index" with pointers to associated content
>> (possibly id/idref pairs.) But then maybe I totally misinterpreted
>> what I saw -- DocBook is one complicated markup vocabulary!

> You place <indexterm> elements through the document, then at the end
> place an empty <index/> element which is where the actual index will be
> generated.
>
> Here is an article on mastering DocBook indexes [sic]:
>
> http://www.xml.com/pub/a/2004/07/14/dbndx.html

Cool! That clarifies it. It also shows I was close, although the
indexing terms in DocBook are part of content, while in my example,
they were attribute values. The "sortas" attribute is also important,
and suggests putting the index terms as content and not in attribute
values.

From other feedback, the indexing community calls what I'm looking for
"embedded indexing", and next week I'll be consulting with one of the
top experts who is very interested in embedded indexing. From what I
gather, there's no 'standard" markup, although DocBook's approach can
be considered a "standard".

Jon Noring