RE: [dita] Index question

["Esrig, Bruce (Bruce)" <esrig@lucent.com>]

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:joann.hackos@comtech-serv.com]
Sent: Wednesday, March 15, 2006 11:16 AM
To: dita@lists.oasis-open.org
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:joann.hackos@comtech-serv.com]
Sent: Wednesday, March 15, 2006 9:13 AM
To: Michael Priestley; Chris Wong
Cc: dita@lists.oasis-open.org
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
joann.hackos@comtech-serv.com
http://www.comtech-serv.com
Skype joannhackos