From
what I understand, the issue of treating indexterm differently in topic
prolog vs content was due to the misunderstanding that the content of indexterm
in content actually appears as part of that content. Since we have now
clarified that indexterm's content is always a subflow, we can treat indexterm
uniformly in both topic prolog and content. Is my understanding correct that
this issue is now resolved?
Chris
From: Erik Hennum [mailto:]
Sent: Tuesday, July 18, 2006 6:16 PM
To: Rodolfo M.
Raya
Cc: Chris Wong; David Walters; ; Esrig,
Bruce (Bruce); JoAnn Hackos; Grosso, Paul
Subject: RE: FW: FW: [dita]
indexing question
Hi, Rudolfo, Dave, and other index enthusiasts:
A lightbulb went off
for me. I think we're conflating two cases here.
In the case of
<keyword>, the element is an inline within content and a subflow in the
prolog as Rudolfo has stated.
In both cases, <keyword> identifies
a word from a vocabulary. In the inline case, the vocabulary word is delimited
within the flow. In the prolog case, the vocabulary word is identified as
potential metadata for search engines.
In neither case do we have a base
processing expectation of producing published indexes for the <keyword>
element. We have sometimes speculated about the possibility of generating
indexes from inline mentions (in Eliot's term) of vocabulary words, but I
believe we've always deferred that.
By constract, <indexterm> is a
subflow in all cases as Chris has stated. The contents of <indexterm> must
be translated, but the translation of the content in which <indexterm> is
embedded isn't affected in any way by the positioning of <indexterm>. That
is, <indexterm> does not delimit part of the flow.
In the prolog,
<indexterm> is specified as serving two purposes: feeding index terms to
search engines as part of the metadata and indexing the
topic.
Digression: The case could be made to treat <term> in
exactly the same way as <keyword>, using <keyword> for words from
formal languages and <term> for words from cultural or social
vocabularies. That would require adding <term> to the prolog.
Hoping that clarifies,
Erik
Hennum
'
src="gif00111.gif" width=16 border=0>"Rodolfo M. Raya"
<>
"Rodolfo M. Raya"
<>
07/18/2006 02:15 PM
To
David Walters/Rochester/IBM@IBMUS
cc
"Esrig, Bruce (Bruce)" <>, Chris Wong
<>, , Erik
Hennum/Oakland/IBM@IBMUS, 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.
