Please also include out-of-band indexterm entries. I've had a lot of utility
from DocBook indexterm's zone attribute:

http://www.docbook.org/tdg/en/html/indexterm.html#d0e96507

The generel idea is that you should be able to annotate content with indexterm's
without changing the content. Quite often, the index authoring is completely
separate from the content authoring.

Also be sure to include attributes or elements that allow hinting about the
purpose of the indexterm, e.g. subject index vs. author index.

kind regards
Peter Ring

> -----Original Message-----
> From: openreader-format@yahoogroups.com
> [mailto:openreader-format@yahoogroups.com]On Behalf Of Jon Noring
> Sent: 5. oktober 2006 07:25
> To: openreader-format@yahoogroups.com
> Subject: Re: [openreader-format] "Book Indexing" markup in
> XML documents
> ?
>
>
> 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
>
>
>
> ----------------------------------------------------
> Post a message: openreader-format@yahoogroups.com
> Unsubscribe: openreader-format-unsubscribe@yahoogroups.com
> Switch to digest: openreader-format-digest@yahoogroups.com
> Switch to normal: openreader-format-normal@yahoogroups.com
> Put mail on hold: openreader-format-nomail@yahoogroups.com
> Administrator: openreader-format-owner@yahoogroups.com
> ----------------------------------------------------
> Yahoo! Groups Links
>
>
>
>
>
>
>
>
>
>