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


Help: OASIS Mailing Lists Help | MarkMail Help

dita-comment message

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

Subject: About the range of indexterm written in topic/prolog/metadata.

Dear DITA TC members,

I recently downloaded the newest DITA1.2 draft dated 15 June, 2010 from 
the following URL:


I read the description about range indexterm written in 
topic/prolog/metadata on page 418 (PDF). There are following sentence.

"In the following example, the range begins with the start of the 
topic's title, and covers the entire topic and any sub-topics.
The range ends within the same prolog, regardless of whether <indexterm 
end="acct"/> is specified in the

This description limits the range of indexterm from the start of the 
topic's title to the "end of the topic".

However there is following description.

"Now assume that the topic in the previous sample is named acct.dita. 
Ranges defined in a prolog cover sub-topics,
including those nested based on a map; in the following example, this 
means that the range covers all of acct.dita, as
well as procedures.dita and forms.dita:" (*2)

This description *EXTENDS* the end of the range indexterm to the end of 
the forms.dita. It is not a good idea to extend a range indexterm 
written in topic/prolog/metadata to the outside of the topic.

Also I think it is impossible to implement this feature, because if 
stylesheet is processing topic/prolog/metadata, it cannot know where 
topicref is extended to.

In this example:

<topicref href="acct.dita">
   <topicref href="procedures.dita"/>
   <topicref href="forms.dita"/>

The range indexterm written in topicref/topicmeta/keywords/indexterm of 
first topicref can extend the range to the end of forms.dita because an 
stylesheet is processing topicref/topicmeta/keywords/indexterm and it 
can know where the acct.dita ends. So I think the second description 
(*2) should apply to the topicref/topicmeta/keywords/indexterm.

Please reconsider the specification.

Sorry for poor English.


  Toshihiko Makita
  Development Group. Antenna House, Inc. Ina Branch
  E-Mail tmakita@antenna.co.jp
  8077-1 Horikita Minamiminowa Vil. Kamiina Co.
  Nagano Pref. 399-4511 Japan
  Tel +81-265-76-9300 Fax +81-265-78-1668
  Web site:

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