8 messages in org.oasis-open.lists.ditaRE: [dita] Nested index terms| From | Sent On | Attachments |
|---|---|---|
| Grosso, Paul | Sep 30, 2005 9:48 am | |
| JoAnn Hackos | Sep 30, 2005 9:57 am | |
| Robert D Anderson | Sep 30, 2005 10:26 am | |
| Paul Prescod | Sep 30, 2005 11:59 am | |
| JoAnn Hackos | Sep 30, 2005 12:36 pm | |
| Grosso, Paul | Sep 30, 2005 1:06 pm | |
| Robert D Anderson | Sep 30, 2005 1:13 pm | |
| Paul Prescod | Oct 2, 2005 4:48 pm |
| Subject: | RE: [dita] Nested index terms | |
|---|---|---|
| From: | JoAnn Hackos (joan...@comtech-serv.com) | |
| Date: | Sep 30, 2005 12:36:13 pm | |
| List: | org.oasis-open.lists.dita | |
I would like to see an example of what you mean by "with additional text" for an index item. JoAnn
-----Original Message----- From: Paul Prescod [mailto:paul...@blastradius.com] Sent: Friday, September 30, 2005 12:59 PM To: Robert D Anderson; Grosso, Paul Cc: di...@lists.oasis-open.org Subject: RE: [dita] Nested index terms
We should agree on the appropriate behaviour for the "with additional text" and put something in the DITA spec. Either it means something useful or it is buggy extra stuff that should be warned about.
Thanks for raising this Paul G.
It is very analogous to my old favorite:
<section> This is <title>a section</title>. With a few of <title>titles</title><p>And a paragraph</p> and another <title>title</title></section>
What does this mean? What is the section title? What should be output? Should XMetaL warn that this is meaningless?
-----Original Message----- From: Robert D Anderson [mailto:roba...@us.ibm.com] Sent: Friday, September 30, 2005 10:26 AM To: Grosso, Paul Cc: di...@lists.oasis-open.org Subject: RE: [dita] Nested index terms
In the IBM internal implementation, we convert this markup: <indexterm>Top level <indexterm>Nested 1</indexterm> <indexterm>Nested 2</indexterm> with additional text </indexterm>
to this in the index: Top level with additional text Nested 1 Nested 2
So, the sample above is equivalent to this, and many other possible combinations: <indexterm>Top level with additional text <indexterm>Nested 1</indexterm> </indexterm> <indexterm><indexterm>Nested 2</indexterm> Top level with additional text </indexterm>
The DITA open toolkit has this same behavior as its goal, but is not there yet - the indexing code could not be completely reused, due to differences between the toolkit architecture and our internal toolset's architecture.
I understand that with the Blast Radius implementation, the "with additional text" part of my original sample would be dropped, with a warning. That seems equally acceptable to me, as long as there is a warning - this does not come up often with our users, though somebody did request that we support it way-back-when.
Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit
"Grosso, Paul"
<pgro...@ptc.com>
To 09/30/2005 11:49 <di...@lists.oasis-open.org>
AM cc
Subject RE: [dita] Nested index terms
Thanks for answering, Paul.
I'd be interested in hearing what others think too, both in terms of what users would do/expect and in terms of what other current implementors do.
More comments below.
-----Original Message----- From: Paul Prescod [mailto:paul...@blastradius.com] Sent: Friday, 2005 September 30 10:43 To: Grosso, Paul; di...@lists.oasis-open.org Subject: [dita] Nested index terms
I don't think that Paul got an answer to his question. Your code in the second example below should generate:
Top level Nested 1 Nested 2
That's how Blast Radius implemented it anyhow.
So, am I correct to understand that you're saying that:
<indexterm>Top level <indexterm>Nested 1</indexterm> <indexterm>Nested 2</indexterm> </indexterm>
is effectively equivalent to:
<indexterm>Top level <indexterm>Nested 1</indexterm> </indexterm> <indexterm>Top level <indexterm>Nested 2</indexterm> </indexterm>
The second example should probably be treated as an error. It
Do you mean "first example" here?
paul
is a flaw of XML schemas and DTDs (inherited from SGML!) that does not make it possible for us to specify that explicitly in the DTD/schema.
-----Original Message----- From: Grosso, Paul [mailto:pgro...@ptc.com] Sent: Wednesday, September 28, 2005 11:08 AM To: di...@lists.oasis-open.org Subject: RE: [dita] Groups - DITA 1.1 Issue #45: Add See, See Also indexing elements (IssueNumber45.html) uploaded
There is something about indexterm (irrespective of this current proposal) that has always concerned me: its mixed content model. Is something like:
<indexterm>Top level <indexterm>Nested</indexterm> index term content. </indexterm>
allowed (the DTD allows it)? If so, what are the processing expectations?
Also, what are the processing expectations of
<indexterm>Top level <indexterm>Nested 1</indexterm> <indexterm>Nested 2</indexterm> </indexterm>
(the DTD allows this too)?