Re: [dita] Preferred Index Terms

From
Kristen James Eberlein <>
Date
2019-08-13T16:25:11+00:00
ID
Thread
Re: [dita] Preferred Index Terms
Option 2 could be a tall order for some companies. I think Option 1 has a lower barrier to entry.

Thanks,

--Scott

ïOn 8/13/19, 10:10 AM, " on behalf of Eliot Kimber" < on behalf of > wrote:

    An indexing requirement that DITA does not currently satisfy out of the box is identify an instance of an index term as being the "preferred" instance. Preferred instances are usually rendered by highlighting the page number (or other locator) for that entry.
    
    DocBook provides for this with the @significance attribute of the <indexterm> element: 
    
    https://urldefense.proofpoint.com/v2/url?u=https-3A__tdg.docbook.org_tdg_5.2_indexterm.singular.html&d=DwICaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=funuX7JZzWPj0ZrlF6lD84qqUTut2bhaS9OPCKwaLA4&s=MMy33hmVxReB9hxZj451pAEh4ufIv-FgbWTTOmq_DQE&e= 
    
    Where the @significance attribute has the value "normal" or "preferred":
    
    <indexterm significance="preferred"><primary>apple</primary></indexterm>
    
    It seems reasonable to add this mechanism to DITA.
    
    I can see two ways it could be done:
    
    1. Add an attribute like @significance to <indexterm>, basically exactly what DocBook does.
    2. Specialize <indexterm> to <indexterm-preferred>.
    
    Option 2 could of course be done by anyone who wants to define the specialization, and maybe that's the answer: if you have this requirement, implement the specialization and the processing for it.
    
    But I wanted to at least record the requirement for discussion.
    
    Cheers,
    
    E.
    --
    Eliot Kimber
    https://urldefense.proofpoint.com/v2/url?u=http-3A__contrext.com&d=DwICaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=funuX7JZzWPj0ZrlF6lD84qqUTut2bhaS9OPCKwaLA4&s=UNU71uffVV18F8FqFuGN7P0zak83tZQUei3LZlBQV9w&e= 
     
    
    
    
    ---------------------------------------------------------------------
    To unsubscribe from this mail list, you must leave the OASIS TC that 
    generates this mail.  Follow this link to all your TCs in OASIS at:
    https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_apps_org_workgroup_portal_my-5Fworkgroups.php&d=DwICaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=funuX7JZzWPj0ZrlF6lD84qqUTut2bhaS9OPCKwaLA4&s=hhtmP7wyTw2zABE0UCKFAKqqMk-rJDHiiyUn2ORjwMs&e=