Cannot get args.rellinks to work with Webhelp (Oxygen 15.1)

[jaspera]

In our top-level parent topics, we need to generate related-links TOCs of the child topics. In the Parameters tab of our Webhelp transform, setting args.rellinks to "all" has no effect. Is there something else we need to set? Are there other settings that could be conflicting with this?

[sorin_ristache]

Do you mean there is no Related information section or Related tasks section or Related concepts section at the end of the content in the top-level topics? The links in these sections should be generated by default by the built-in DITA WebHelp transformation without setting any parameter.

The all value is the correct value for the args.rellinks parameter for allowing the related links in the output WebHelp pages.

Please send us a set of sample files for investigating the problem: a sample DITA map and the DITA XML topic files included in the map, and the WebHelp pages generated by Oxygen 15.1.

[jaspera]

Thanks, Sorin ... You provided a key piece of information, namely that the built-in Webhelp transform should generate the links by default. This let me focus on a small set of customized files to determine what had turned off the default. One of the customizations someone made was to add the following to webhelp_topic.css:

.ullinks {
list-style-type: none;
visibility: hidden;
}

Removing the "visibility" setting allowed the links to be generated.

Question: I notice that args.rellinks is set to "none" in the default Webhelp transform parameters; yet the related links are still generated. I thought the default setting of "none" would not have allowed that. It's as if the args.rellinks parameter has no effect.

[sorin_ristache]

Question: I notice that args.rellinks is set to "none" in the default Webhelp transform parameters; yet the related links are still generated. I thought the default setting of "none" would not have allowed that. It's as if the args.rellinks parameter has no effect.

In fact the default value is all but it is wrongly displayed as none. We corrected that already for the next Oxygen version. You can see that you get exactly the same result if you explicitly set the args.rellinks parameter to all.