My proposal is the clarification that index ranges have no meaning
within a topic prolog and should be ignored. Indexterms in a topic
prolog basically point to the topic itself. That answers 1 and 2.
3 and 4 concern where we can put indexterms and do not pertain to index
ranges: they are outside the scope of existing indexing proposals. I
have no plans to submit a new proposal for this, but anyone else is
welcome to do so.
5 and 6: an index range is just a range: any content between two index
range markers constitute the index range. An index range starts where it
starts and ends where it ends. That includes figures, part or whole
paragraphs ... anything. That is the point of the index range marker,
that it can express index ranges in a manner orthogonal of the XML
structure. I don't see the ambiguity: why should anything NOT be in an
index range if so delineated?
7: I'd answer "yes": that seems the obvious interpretation. An index
range starts where it starts, and ends where it ends.
-----Original Message-----
From: Grosso, Paul [mailto:pgro...@ptc.com]
Sent: Tuesday, July 18, 2006 9:27 AM
To: di...@lists.oasis-open.org
Subject: RE: [dita] indexing question
-----Original Message-----
From: Grosso, Paul [mailto:pgro...@ptc.com]
Sent: Monday, 2006 July 10 14:25
To: di...@lists.oasis-open.org
Subject: RE: [dita] indexing question
From: Erik Hennum [ehen...@us.ibm.com]
To follow up on the index range question, we had a fair bit of
discussion about ranges last Fall.
Yes, we had a fair bit of discussion and still missed several
important issues related to indexes. Scary, huh?
Here are some indexing issues I think we still need to answer; apologies
if some of Bruce's or Chris' or Erik's email have proposed answers to
these questions that I either missed, did not understand, or did not
feel we had consensus on.
1. What do index page ranges mean within the prolog element?
It's best for both implementors and users when elements work
the same way wherever they are allowed. So I think either
index page ranges should mean what we say they mean, or they shouldn't
be allowed there, e.g., in prologs.
2. What does an indexterm within the prolog mean?
3. Users want to be able to index words in titles and shortdesc.
Are we going to allow this?
4. Are we going to allow indexterm within related-links?
5. Whereas a pointwise index term seems unambiguous--wherever it is,
you index that--with ranges, you get into all sorts of questions about
what is within the range. If you put a para within an index range and
within that para is a figure callout and that figure ends up on another
page, is that figure's page within the range or not?
6. What constitutes a start/end pair? Can you start an index range
between two paragraphs and then end it in the middle of a paragraph?
Our proposal says "Index ranges that start within a topic must end in
the same topic, excluding nested topics." I assume that means an index
range can start outside a (nested) topic and end either within that
topic or a further nested topic, is that correct?
7. Regarding index page ranges specified within a map, can one start an
index range before topicref A and then end an index range after topicref
C where C is a child of A?
JoAnn raised some other questions that I'm not sure I fully understood,
but I'm not sure we have consensus answers to all of them either.
45 messages in org.oasis-open.lists.ditaRE: [dita] indexing question
.gif, .gif, .gif, 7 more