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: [dita] indexing question

Hi, Paul:

In the conclusion of this thread about inline vs. subflow, we've cleared up a misunderstanding that an <indexterm> in DITA 1.0 can delimit a span of text within the body flow.

I don't think that clarification argues any changes in the resolutions recorded on Tuesday:



Erik Hennum

Inactive hide details for "Grosso, Paul" <pgrosso@ptc.com>"Grosso, Paul" <pgrosso@ptc.com>

          "Grosso, Paul" <pgrosso@ptc.com>

          07/21/2006 06:32 AM





RE: [dita] indexing question

We could resolve the issue this way. The problem with this solution is the case where you have a long shortdesc (which precedes the prolog) so that the point-wise, subflow indexterm in the prolog ends up on the second page of the topic so your index entry does not have the page number of the first page in the topic. So, in fact, an indexterm in a prolog really has no useful purpose, since you cannot guarantee that its effect is going to be the desired one.

So I could live with this solution provided that we allow indexterm in other places that it is currently not allowed (e.g., title) so that a user can ensure they get an index entry pointing to the first page of a topic.

And once we do that, we would then issue a "best practices" statement saying not to put indexterm within prolog.


From: Chris Wong [mailto:cwong@idiominc.com]
Friday, 2006 July 21 07:49
Erik Hennum; Rodolfo M. Raya
David Walters; dita@lists.oasis-open.org; Esrig, Bruce (Bruce); JoAnn Hackos; Grosso, Paul
RE: FW: FW: [dita] indexing question

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?


From: Erik Hennum [mailto:ehennum@us.ibm.com]
Tuesday, July 18, 2006 6:16 PM
Rodolfo M. Raya
Chris Wong; David Walters; dita@lists.oasis-open.org; Esrig, Bruce (Bruce); JoAnn Hackos; Grosso, Paul
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

Inactive hide details for "Rodolfo M. Raya" <rodolfo@heartsome.net>"Rodolfo M. Raya" <rodolfo@heartsome.net>

                  "Rodolfo M. Raya" <rodolfo@heartsome.net>

                  07/18/2006 02:15 PM


David Walters/Rochester/IBM@IBMUS

"Esrig, Bruce (Bruce)" <esrig@lucent.com>, Chris Wong <cwong@idiominc.com>, dita@lists.oasis-open.org, Erik Hennum/Oakland/IBM@IBMUS, JoAnn Hackos <joann.hackos@comtech-serv.com>, "Grosso, Paul" <pgrosso@ptc.com>

RE: FW: FW: [dita] indexing question

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


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

GIF image

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