RE: [dita] indexing question

From
Chris Wong <>
Date
2006-07-10T22:04:46+00:00
ID
Thread
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. 

 

Chris

 

From: Erik Hennum 
[mailto:] 
Sent: Friday, July 07, 2006 3:08 
PM
To: Grosso, Paul
Cc: 

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:

http://www.oasis-open.org/apps/org/workgroup/dita/email/archives/200510/msg00020.html
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:

http://www.oasis-open.org/apps/org/workgroup/dita/download.php/18917/IssueNumber45b.html
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


"Grosso, Paul" 
<>

  
  

    
      
        
          
            "Grosso, Paul" 
              <> 
              
06/29/2006 05:05 PM

    
      
        
        

          

            
To

          
<>

        

          

            
cc

          

        

          

            
Subject

          
RE: [dita] indexing question

      
        
        

          
          

From: Erik Hennum [mailto:] 
Sent: Thursday, 2006 June 29 
18:13
To: JoAnn 
Hackos
Cc: 
; Grosso, Paul
Subject: 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.