3 messages in org.oasis-open.lists.dita-chairRe: [dita-comment] About indexterm im...| From | Sent On | Attachments |
|---|---|---|
| Toshihiko Makita | Mar 26, 2012 6:30 pm | |
| Don Day (LbyW) | Mar 28, 2012 9:18 pm | |
| Toshihiko Makita | Mar 28, 2012 9:53 pm |
| Subject: | Re: [dita-comment] About indexterm implementation | |
|---|---|---|
| From: | Don Day (LbyW) (don...@learningbywrote.com) | |
| Date: | Mar 28, 2012 9:18:37 pm | |
| List: | org.oasis-open.lists.dita-chair | |
Thank you, Makita-san, for commenting about possible improvements for the indexterm section of the DITA specification. The DITA TC will soon review this issue, and someone from the DITA TC will follow up with you once we understand this issue better. Don R. Day <mailto:don...@learningbywrote.com> DITA and XML Consultant, Learning by Wrote <http://learningbywrote.com/> Co-Chair, OASIS DITA Technical Committee <http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita> "Where is the wisdom we have lost in knowledge? Where is the knowledge we have lost in information?" --T.S. Eliot
On 3/26/2012 8:31 PM, Toshihiko Makita wrote:
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,