FW: [dita-comment] About indexterm implementation

From the dita-comment list.


Best regards,
Kris
Kristen James Eberlein | DITA Architect and Technical Specialist | SDL
Structured Content Technologies Division | (t) + 1 (919) 682-2290|


22 May | Amsterdam www.sdl.com/summit2012

Please consider the environment before printing this e-mail




-----Original Message-----
From: Toshihiko Makita [mailto:] 
Sent: Monday, March 26, 2012 9:31 PM
To: 
Subject: [dita-comment] About indexterm implementation

Dear DITA TC members,

I'm implementing DITA to PDF plug-in in DITA Open Toolkit. I found that
there are implementation guidelines in the 3.1.3.2.1 indexterm section
in the DITA1.2 specification. For instance there are descriptions about
topicref/tomicmeta/keywords/indexterm,
topic/topicmeta/keywords/indexterm and indexterm elements in topic/body.

However I noticed that there are another location that a author can
write indexterm elements in DITA. For instance:

bookmap/booktitle/mainbooktitle
bookmap/booktitle/booktitlealt
bookmap/bookmeta/keywords

toipic/title
topic/shortdesc,abstarct

I think the implementation should ignore indexterm elements in
bookmap/booktitle or bookmeta because they are usually outputted in the
cover of the publication and the cover usually does not has page number.

If the indexterm element exists in topic/title or
topic/shortdesc,abstract, I think they should be honored. My question is
the treatment of the ranged indexterm. If the ranged indexterm appears
in topic/title or topic/shortdesc,abstract what should I do?

<topic>
<title><ph>Sample title<indexterm start="INDEXTERM_IN_TITLE">Sample
Indexterm in title</indexterm></ph></title>
...
</topic>

If there are any implementation guidelines, please let me know. Or there
is no guidelines I think it should be written in the specification.

Regards,

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


-- 
This publicly archived list offers a means to provide input to the
OASIS Darwin Information Typing Architecture (DITA) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: 
Unsubscribe: 
List help: 
List archive: http://lists.oasis-open.org/archives/dita-comment/
Feedback License: http://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: http://www.oasis-open.org/maillists/guidelines.php
Committee: http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita
Join OASIS: http://www.oasis-open.org/join/