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


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

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

Subject: RE: [dita] indexing question

One question that comes to mind is: why would you want a page range that spans one and only one topic? For example, I pulled out my old "XML in a Nutshell" and looked up "Arabic Unicode block". This table spans 2 pages, but is only indexed with a page number pointing to the start of the topic. That is because the topic is so obviously self-enclosed that a single page reference is sufficient.
What I'd say is that an indexterm in a topic prolog points to the topic. Page range markers in a topic prolog has no meaning, since the indexterm is out of the content flow. So index-range-start/index-range-end should be ignored. This will allow an author to generate an index reference to a single topic by entering an indexterm in the topic prolog.
We can leave open the possibility that a processor may elect to treat an indexterm in a topic prolog as a page range: for example, if that topic is deeply nested.

From: Erik Hennum [mailto:ehennum@us.ibm.com]
Sent: Friday, July 07, 2006 3:08 PM
To: Grosso, Paul
Cc: dita@lists.oasis-open.org
Subject: RE: [dita] indexing question

Hi, Paul (Grosso) and Indexing Enthusiasts:

To follow up on the index range question, we had a fair bit of discussion about ranges last Fall. The consensus at the time was that ranges should be set explicitly. A sample from the thread:

I guess my perspective remains that an indexterm in the prolog could be treated as a special case of a general rule: that an indexterm covers the content of its container and that processing emits a page range if the indexed container extends to more than 2 pages.

Even so, I don't want to undo the progress we've made:

Can we isolate any anomalies in the current indexing proposal and fix those quickly without changing the fundamental approach?

Paul, are you aware of other hiccups besides the requirement to index an entire topic from start of the title through the end of the related links or the end of the nested topics?

Chris (Wong), as the lead on the indexing proposal, do you have any suggestions?

Hoping that's useful,

Erik Hennum

Inactive hide details for "Grosso, Paul" <pgrosso@ptc.com>"Grosso, Paul" <pgrosso@ptc.com>

          "Grosso, Paul" <pgrosso@ptc.com>

          06/29/2006 05:05 PM





RE: [dita] indexing question

From: Erik Hennum [mailto:ehennum@us.ibm.com]
Thursday, 2006 June 29 18:13
JoAnn Hackos
dita@lists.oasis-open.org; Grosso, Paul
RE: [dita] indexing question

That said, we still need a way to generate a range over the whole topic.

Huh? I would have thought what you just said in the first paragraph means that an indexterm within the prolog generates a range over the whole topic. Now I'm really confused.

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