rellinks inconsistency

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
tomjohnson1492
Posts: 132
Joined: Thu Apr 17, 2014 1:55 am

rellinks inconsistency

Post by tomjohnson1492 » Tue Dec 16, 2014 1:10 am

If I set the rellinks parameter to Default in my webhelp transform, and then add linking="none" as an attribute to my ditamap, it does exclude the rellinks for those sections.

However, if I set the rellinks parameter to None in my webhelp transform, and then add linking="all" as an attribute to some sections in my ditamap, it does not include the rellinks for those sections.

Why is there this inconsistency? Is it a bug?

sorin_ristache
Posts: 4144
Joined: Fri Mar 28, 2003 2:12 pm

Re: rellinks inconsistency

Post by sorin_ristache » Tue Dec 23, 2014 6:12 pm

tomjohnson1492 wrote:If I set the rellinks parameter to Default in my webhelp transform, and then add linking="none" as an attribute to my ditamap, it does exclude the rellinks for those sections.
Sorry, I get a different result. If I don't modify the args.rellinks parameter the Related Information section remains at the end of the topics, so the related links are not removed. Actually this is a correct result, because the default behavior in case of the args.rellinks parameter is the normal value, not the none one. We will correct the default value of this parameter in the list with all the DITA transformation parameters.
tomjohnson1492 wrote:However, if I set the rellinks parameter to None in my webhelp transform, and then add linking="all" as an attribute to some sections in my ditamap, it does not include the rellinks for those sections.

Why is there this inconsistency? Is it a bug?
The parameter args.rellinks sets the inclusion or exclusion of the related links. If you want to exclude them from the output you have to set the parameter to none. If you want to include them in the output you have to set it to normal or leave it untouched.
Regards,
Sorin

<oXygen/> XML Editor Support

tomjohnson1492
Posts: 132
Joined: Thu Apr 17, 2014 1:55 am

Re: rellinks inconsistency

Post by tomjohnson1492 » Tue Dec 23, 2014 8:24 pm

For some topics in my help, I want the rellinks turned on. For other sections, I want them turned off. I realize this creates some inconsistency, but it was something I was trying. In your experiment, try turning on rellinks for just one section in your ditamap. The normal approach to do this would be to turn rellinks off but to add linking="all" in the topic group where you want them included. However, that doesn't work. You have to turn rellinks on and set linking="none" for all the sections where you don't want them to appear.

sorin_ristache
Posts: 4144
Joined: Fri Mar 28, 2003 2:12 pm

Re: rellinks inconsistency

Post by sorin_ristache » Wed Dec 31, 2014 3:48 pm

In the test that I did the args.rellinks parameter set to on overrides the linking="none" attribute. So you cannot turn linking off selectively on a group of topics in the DITA map.
Regards,
Sorin

<oXygen/> XML Editor Support

Post Reply