OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
Back to discussions
Expand all | Collapse all

RE: [dita] indexing question

  • 1.  RE: [dita] indexing question

    Posted 07-21-2006 14:49 
     MHonArc v2.5.0b2 -->



























    dita message
    







    [Date Prev]
 | [Thread Prev]
 | [Thread Next]
 | [Date Next]

--

[Date Index]
 | [Thread Index]
 | [List Home]
    


    







    Subject: RE: [dita] indexing question
    







    






    Hmm, I forgot what I recorded myself as the TC decision 
this Tuesday: we said that an indexterm within the prolog points to the first 
page of the topic, and no one on the TC objected.
    

     
    

    So unless someone comes back with serious pushback from 
some user community, that's the decision (and I'm okay with that). Sorry to 
cause confusion (so many committees and telcons that I forget sometimes how far 
we got on a certain topic).
    

     
    

    We do still have (I believe) some outstanding issues 
about indexes--questions 4-7 in my email at
    


     
    

    paul

    

    
  
    
  
    
  From: Grosso, Paul [mailto:pgrosso@ptc.com]
    Sent: Friday, 2006 July 21 09:38
    To: 
  dita@lists.oasis-open.org
    Subject: RE: [dita] indexing 
  question

    
  
    
  
    Actually, the point specified by an indexterm in the 
  prolog never gets associated with any page since the prolog never gets put 
  into the output (under the usual styling of "prolog"), so per the standard 
  indexterm processing, an indexterm within a prolog would simply be ignored 
  (i.e., never generate an index entry).
    
  
     
    
  
    So I misstated when I said such might create an index 
  entry pointing to the second page of the topic.
    
  
     
    
  
    But I was correct that an indexterm in a prolog is 
  useless (under the standard indexterm processing), so we should certainly 
  suggest people don't do this.
    
  
     
    
  
    Bruce is suggesting something akin to what Erik (I 
  believe) implied a while ago: that an indexterm within a prolog have "special 
  semantics" and "act as if" there is an indexterm on the first page of the 
  topic.
    
  
     
    
  
    We could do this. And perhaps this would address the 
  user requirement to be able to have an index entry that points to the first 
  page of a topic and therefore imply we don't need to allow indexterm within 
  title and shortdesc and such. I'm just not sure if having to insert a prolog 
  containing a keyword containing an indexterm--as opposed to just putting an 
  indexterm in the title--will be acceptable to users.
    
  
     
    
  
    Users on (and represented by members of) the 
  TC--what do you say?
    
  
     
    
  
    paul

    
  
    
    
    
    
    
    From: Esrig, Bruce (Bruce) 
    [mailto:esrig@lucent.com]
    Sent: Friday, 2006 July 21 
    09:08
    To: Grosso, Paul; 
    dita@lists.oasis-open.org
    Subject: RE: [dita] indexing 
    question

    
    
    
    
    Paul,
    
    
     
    
    
    The "point" specified by an indexterm in the prolog 
    isn't necessarily after the title or shortdesc.
    
    
     
    
    
    We 
    can interpret that when the source markup contains an indexterm in 
    the prolog, the indexterm is understood to be tied to a point at the 
    beginning of the title.
    
    
     
    
    
    That's just to preserve the primary method, in 
    which an indexterm that applies to the entire topic is entered in the 
    prolog.
    
    
     
    
    
    Best wishes,
    
    
     
    
    
    Bruce


Related Content