Page 1 of 1

rellinks inconsistency

Posted: Tue Dec 16, 2014 1:10 am
by tomjohnson1492
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?

Re: rellinks inconsistency

Posted: Tue Dec 23, 2014 6:12 pm
by sorin_ristache
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.

Re: rellinks inconsistency

Posted: Tue Dec 23, 2014 8:24 pm
by tomjohnson1492
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.

Re: rellinks inconsistency

Posted: Wed Dec 31, 2014 3:48 pm
by sorin_ristache
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.