Page 1 of 1

How to customize Related Links section with a single heading

Posted: Wed Nov 29, 2023 3:05 pm
by ann.jensen
Hi,
I want to collapse all items defined in a topic's <related-links> so that there is one generic heading "Related topics" and the links are not divided up into groups by topic type with different headings.
I am reviewing plugins
\org.dita.base\xsl\common\related-links.xsl and \org.dita.html5\xsl\rel-links.xsl
but am unsure which template I can customize to either
1. not look at the related links as groups
or
2. only output one heading for all groups

Has anyone tried this before?
Thanks in advance,
Ann

Re: How to customize Related Links section with a single heading

Posted: Tue Dec 05, 2023 1:20 pm
by marius
Hello,
The presentation of the related links is controlled by a WebHelp transformation parameter called webhelp.rellinks.group.mode.
Its default value is single-group and should group all types of related links under one category called Related Information which I think is the behavior you expect.
This is what I get in the output when changing the value of the webhelp.rellinks.group.mode parameter:
rlb.png
Can you check the value of this parameter in your transformation?
If is the default value, maybe you have a customization that overrides its behavior.

Re: How to customize Related Links section with a single heading

Posted: Tue Dec 05, 2023 1:27 pm
by ann.jensen
Hi Marius,
Thanks so much for your reply. Can you help me understand what that setting impacts in relation to the base org.dita.html5 transform? Does it customize one of the base templates?
Regards,
Ann

Re: How to customize Related Links section with a single heading

Posted: Tue Dec 05, 2023 2:28 pm
by ann.jensen
Hi Marius,
Your reply managed to help me on a path to find a general solution in https://groups.google.com/g/dita-ot-use ... N3_e3lAQAJ.
Sharing here in case someone else needs it.
Thanks again,
Regards,
Ann