[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: <indexterm> questions raised by Toshihiko Makita
Here is a list of the questions raised by
Toshihiko-san on March 26: 1) How should implementations treat <indexterm> entries that are located in the following places?
2) How should implementations treat a "ranged indexterm" when it begins in a title or shortdesc/abstract, for example: Analysis of DITA 1.2 spec<topic> <title><ph>Sample title<indexterm start="INDEXTERM_IN_TITLE">Sample Indexterm in title</indexterm></ph></title> ... </topic> The bulk of the content is in 3.1.3.2.1 indexterm . It distinguishes between the following types of <indexterm> entries:
It does not specify how <indexterm>
entries located in <title> or <shortdesc> or
<abstract> elements should be handled. 1. <indexterm> entries in bookmap
<mainbooktitle> or <booktitlealt> Why do we allow <indexterm> entries in
the bookmap title elements but not the <title> element in
a map? Because <maintbooktitle> and <booktitlealt>
are specialized from <ph>? 2. <indexterm> entries in bookmap/bookmeta/keywords
or map/topicmeta/keywords 3. <indexterm> entries in non-body content of
topics My personal take is that <indexterm>
entries located in a <title> element should be treated as
<indexterm> entries located in the <prolog>; here is
the current wording in the spec: And <indexterm> entries located in <shortdesc> or <abstract> should be treated as "a point reference that will contribute the number of the current page". If other TC members agree, we could clarify this point by tightening the language and examples in the <indexterm> element topic."An indexterm that occurs in a topic prolog is interpreted as a point reference to the title of the topic. Likewise, an indexterm that occurs in <topicmeta> inside of a <topicref> is interpreted as a point reference to the title of the referenced topic." Best, |
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]