I believe that Dave’s example is most
appropriate. The words themselves must remain in the sentence. The
<indexterm> tag requires that we enter the words again within the index
tag. It is best to keep the sentence text and the index text completely
separate (something that FrameMaker does not require). That is the way we are
writing the Best Practice.
JoAnn T. Hackos, PhD
Comtech Services, Inc.
710 Kipling Street, Suite 400
Denver, CO 80215
From: Rodolfo M. Raya
Sent: Tuesday, July 18, 2006 4:03
To: Esrig, Bruce (Bruce)
Cc: Chris Wong;
email@example.com; Erik Hennum; JoAnn Hackos; Grosso, Paul; David
Subject: RE: FW: FW: [dita]
If <indexterm> is only used in the index, then
all we need is to recommend treating it as a "subflow" element.
On Tue, 2006-07-18 at 17:49 -0400, Esrig, Bruce (Bruce) wrote:
David's new examples help greatly.
The <indexterm> content isn't used in
place to generate output, but it is used to generate the text for the index
entries, so they do need to be translated.
From: Rodolfo M. Raya [mailto:firstname.lastname@example.org]
Sent: Tuesday, July 18, 2006 5:15 PM
To: David Walters
Cc: Esrig, Bruce (Bruce); Chris Wong;
email@example.com; Erik Hennum; JoAnn Hackos; Grosso, Paul
Subject: RE: FW: FW: [dita] indexing question
On Tue, 2006-07-18 at 15:03 -0500, David
The <p> text is complete.
<p>Paragraph that contains term one <indexterm>term one</indexterm>
and term two <indexterm>term two</indexterm> inside.</p>
If the content of <indexterm> is completely ignored when the topic is
published as XHTML, PDF or any other format, then this element should be
completely ignored at translation time.
The content of <indexterm> doesn't need to be translated if it is
only a location marker. The whole element can be replaced with a tag by the the
The information in this e-mail is intended strictly for the addressee,
without prejudices, as a confidential document. Should it reach you, not
being the addressee, it is not to be made accessible to any other
unauthorised person or copied, distributed or disclosed to any other
third party as this would constitute an unlawful act under certain
circumstances, unless prior approval is given for its transmission. The
content of this e-mail is solely that of the sender and not necessarily
that of Heartsome.