OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: RE: FW: FW: [dita] indexing question


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

 

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


From: Rodolfo M. Raya [mailto:rmraya@heartsome.net]
Sent: Tuesday, July 18, 2006 4:03 PM
To: Esrig, Bruce (Bruce)
Cc: Chris Wong; dita@lists.oasis-open.org; Erik Hennum; JoAnn Hackos; Grosso, Paul; David Walters
Subject: RE: FW: FW: [dita] indexing question

 

Hi,

If
<indexterm> is only used in the index, then all we need is to recommend treating it as a "subflow" element.

Best regards,
Rodolfo

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.

 

Best wishes,

 

Bruce

-----Original Message-----
From: Rodolfo M. Raya [mailto:rodolfo@heartsome.net]
Sent: Tuesday, July 18, 2006 5:15 PM
To: David Walters
Cc: Esrig, Bruce (Bruce); Chris Wong; dita@lists.oasis-open.org; Erik Hennum; JoAnn Hackos; Grosso, Paul
Subject: RE: FW: FW: [dita] indexing question

On Tue, 2006-07-18 at 15:03 -0500, David Walters wrote:

Hi,



 
New example:
   The <p> text is complete.
                                                                                                     
    <topic>                                                                                          
    <prolog>                                                                                         
    <indexterm>term one</indexterm>                                                                  
    <indexterm>term two</indexterm>                                                                  
    </prolog>                                                                                        
    <body>                                                                                           
    <p>Paragraph that contains term one <indexterm>term one</indexterm>                              
    and term two <indexterm>term two</indexterm> inside.</p>                                         
    </body>                                                                                          
    </topic>                                                                                         


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 translation tool.

Best regards,
Rodolfo

 

 

 

--
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.

 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]