RE: [dita] Index question

From
Esrig, Bruce (Bruce) <>
Date
2006-03-15T16:26:22+00:00
ID
Thread
RE: [dita] Index question
Hi 
Joanne,

 

Here's an attempt to answer your 
question.

 

The 
indexterm is allowed in metadata at the top of the topic.

 

It is more appropriate as topic metadata 
than an insert in the title that is intended to apply to the entire topic. The 
chain of elements is:

 

<topic>

  <prolog>

     
<metadata>

         
<keywords>

             
<indexterm>

 

Best 
wishes,

 

Bruce

  
-----Original Message-----
From: JoAnn Hackos 
  [mailto:]
Sent: Wednesday, March 15, 
  2006 11:16 AM
To: 
Subject: FW: 
  [dita] Index question

  
 

  

  
  

  

  
It would also be 
  helpful to put an <indexterm> in a short description - you can't do that 
  either.

  
Jen

  
 

  

  
Jen 
  Linton

  
Comtech Services, 
  Inc.

  
Senior Consultant and 
  Web Manager

  
710 Kipling St. Suite 
  400

  
Denver, CO 
  80215

  
P: 
  303-232-7586

  
F: 
  303-232-0659

  
skype: 
  jenlinton

  
 

  
 

  

  
  From: JoAnn Hackos 
  [mailto:] 
Sent: Wednesday, March 15, 
  2006 9:13 AM
To: Michael Priestley; Chris Wong
Cc: 
  
Subject: [dita] Index 
  question

  

  
Micheal and Chris,

  
 

  
My staff just told me that they cannot add 
  an <indexterm> tag to a title. In most indexing best practices, you do 
  include index tags at the title level to point a reader to an entire topic. Is 
  there a reason that an <indexterm> tag is not allowed in a topic title? 
  Can we include it there? Why is <indexterm> not a universal attribute? 
  It would also be useful to place an index tag at the beginning of a property 
  list or table.

  
 

  
JoAnn 

  
JoAnn T. Hackos, PhD 
President 
Comtech Services, 
  Inc. 
710 Kipling Street, Suite 400 
  
Denver, CO 80215 
303-232-7586 
 
http://www.comtech-serv.com 
Skype joannhackos