Page 1 of 1

Parent index topic includes page numbers for all child index

Posted: Fri Aug 23, 2013 6:09 pm
by UrsulaT
Hello, when I generate a PDF file with an Index, the parent topics in the index list the page numbers for all of the children topics as follows (I am putting it into code tags for this post, so you can see the indentation):

Code: Select all

   shutting down the connection 562
Server Disconnect 562
When I read through the dita spec it clearly shows that this should not happen. It should look like:

Code: Select all

   shutting down the connection
Server Disconnect 562
This is how I have index terms tagged up in the DITA:

<indexterm>shutting down the connection<indexterm>Server Disconnect</indexterm></indexterm>

This would not be a big deal, except I have some parent index topics with a number of children topics, so I get something like this in my index:

Code: Select all

functions
44–45, 57, 85–90, 93, 96–97, 100–109,
111–112, 117–119, 127, 136, 139–141,
145–147, 160, 179, 195, 212, 215–222,
226, 235, 246, 254–258, 261, 264, 268–
271, 277, 281, 283–285, 287, 293, 297–
302, 305–308, 317–320, 322–326, 328,
331–333, 340–341, 343–344, 346–347,
349–351, 353–355, 357–362, 365, 368,
372–375, 378–381, 386–390, 392, 395–
401, 418, 427–430, 433–437, 441, 443,
445–446, 448, 450, 462, 468–469, 471–
473, 483, 486–488, 497, 500, 503, 509,
515–517, 519–520, 523–524, 531, 621,
632–640, 642–647, 650, 656, 658, 662–
664, 666–667, 669, 671–674, 678–680,
684–685, 691
Abs( )
44
Acos( )
45
AdornmentInfo( )
57
ApplicationDirectory$( )
85
ApplicationName$( )
86
Area( )
86
...
We had a home-grown ditaot implementation where I could comment out some code to suppress the duplication of child page numbers in the parent topic. We would change the following in the index.xls file (under \ditaot\demo\fo\xsl\fo) of our earlier version of the ditaot from this:

Code: Select all

             <xsl:when test="opentopic-index:index.entry">
<xsl:for-each select="child::opentopic-index:refID[last()]">
<fo:inline index-key="{@value}"/>
</xsl:for-each>
</xsl:when>
To this (just commented out the one section):

Code: Select all

             <xsl:when test="opentopic-index:index.entry">
<!--<xsl:for-each select="child::opentopic-index:refID[last()]">
<fo:inline index-key="{@value}"/>
</xsl:for-each> -->
</xsl:when>
We have recently started working with the ditaot that comes with Oxygen. I was wondering if this issue is on the radar for a fix, or if there is a solution for this?

Thanks
Ursula

Re: Parent index topic includes page numbers for all child i

Posted: Tue Aug 27, 2013 9:24 am
by Radu
Hi Ursula,

I am not sure what the behavior should be, if the page number should also appear next to the ancestor index entry or not.
I added an issue on the DITA OT bugs list some time ago with a similar issue and giving an example from the DITA specs:

https://github.com/dita-ot/dita-ot/issues/1525

Based on this post I added a comment to the end of this issue requesting maybe some clarifications if the page number should appear only for the leaf index terms or also on the ancestor index term.

Maybe the DITA Users List would be a good place for you to ask this question, the DITA Specs writers are registered on it.

Regards,
Radu

Re: Parent index topic includes page numbers for all child i

Posted: Mon Sep 16, 2013 5:37 pm
by UrsulaT
Hi Radu, thank you for looking at this. I'll follow up on the DITA users list.

Cheers
Ursula