Automatic Links

cjboorman
Posts: 37
Joined: Wed Jun 19, 2013 1:49 am

Automatic Links

Post by cjboorman » Fri Sep 30, 2016 1:20 am

Hi,

When you apply the WebHelp Classic transform scenario, oXygen automatically generates links to sibling topics, and adds them to the output parent topic.

But when you use the parent topic multiple times within a ditamap, and those other instances also have sibling topics, then oXygen adds links to all of the sibling topics to each copy of the parent topic!

This is confusing for the reader because they are expecting the number of child topics that appear in parent topic output to be the same as the number of child topics that appear in the table of contents.

Is there a way that I can limit the output of child topic links in the parent topic - to be the same number of child topics that appear in the table of content - for each instance of the parent topic?


Thanks,

Chris.

radu_pisoi
Posts: 348
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Automatic Links

Post by radu_pisoi » Fri Sep 30, 2016 10:02 am

Hi,

For the case when you are referring a topic multiple times in a DITA Map, it would be better to use the copy-to attribute.

Code: Select all

<topicref href="concepts/springFlowers.dita" copy-to="springFlowers-2.dita">
In this case, you will find in the output a copy of the original topic with the name specified in the copy-to attribute and with the correct child links.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

cjboorman
Posts: 37
Joined: Wed Jun 19, 2013 1:49 am

Re: Automatic Links

Post by cjboorman » Tue Nov 01, 2016 11:09 pm

That solved my problem - thanks.

Chris Boorman.

Post Reply