OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

RE: [dita] indexing question

  • 1.  RE: [dita] indexing question

    Posted 06-29-2006 23:13
     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


    Hi, Paul and JoAnn:

    The prolog is a container for metadata about the topic as a whole and thus doesn't occupy a position of the flow. That is, an index on the prolog applies to the entire topic.

    That said, we still need a way to generate a range over the whole topic. Last year, we talked about whether an index on a container could generate a range if the container spans more than two pages and rejected that approach.

    I don't recall whether we've addressed the question of whether an index range could start in the title or abstract and end at the end of the topic's body or even at the end of the body of the last nested topic.

    As a minor point, I wouldn't think it would make sense to include the related links in an index range, given that they don't provide any of the topic content and thus don't cover an index subject.

    If we allow index to appear either inside the prolog or before the abstract, do we provide a precedent for for moving other metadata out of the prolog? Do we create confusion by having two places to assert an index on the topic?

    In passing, I'd note that some vocabularies put the metadata container before title. The counterargument is that, with the emphasis on linking in a topic-oriented architecture, separating the title and short description from the body has value in reminding the writer that the title and short description can appear in linking contexts without the body.


    Hoping that's useful,


    Erik Hennum
    ehennum@us.ibm.com


    "JoAnn Hackos" <joann.hackos@comtech-serv.com> wrote on 06/29/2006 03:51:27 PM:

    > I'd like to see Indexterm as a child of topic. It feels awkward to wait
    > until prolog.
    > 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
    >
    >