OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

RE: [dita] indexing question

  • 1.  RE: [dita] indexing question

    Posted 07-18-2006 14:24
     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


    The question raised in the Translation SC concerns the different
    requirements for handling indexterms in the prolog and indexterms in
    text using CAT software. Bruce Esrig's note defined the differences and
    asked us to consider using different element names for the different
    locations. Please refer to the clarification that Rodolfo Raya sent
    about the difference between a "breaking" element and an inline element
    for the discussion of this issue.
    JoAnn
    
    JoAnn T. Hackos, PhD
    President
    Comtech Services, Inc.
    710 Kipling Street, Suite 400
    Denver, CO 80215
    303-232-7586
    joann.hackos@comtech-serv.com
    joannhackos Skype
    www.comtech-serv.com
    
    -----Original Message-----
    From: Chris Wong [mailto:cwong@idiominc.com] 
    Sent: Tuesday, July 18, 2006 8:19 AM
    To: Grosso, Paul; dita@lists.oasis-open.org
    Subject: RE: [dita] indexing question
    
     
    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.
    
    Chris
    
    
    -----Original Message-----
    From: Grosso, Paul [mailto:pgrosso@ptc.com] 
    Sent: Tuesday, July 18, 2006 9:27 AM
    To: dita@lists.oasis-open.org
    Subject: RE: [dita] indexing question
    
    
    > -----Original Message-----
    > From: Grosso, Paul [mailto:pgrosso@ptc.com]
    > Sent: Monday, 2006 July 10 14:25
    > To: dita@lists.oasis-open.org
    > Subject: RE: [dita] indexing question
    > 
    > > From: Erik Hennum [ehennum@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.
    
    paul
    
    
    


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