How to customize Related Links section with a single heading

Post here questions and problems related to editing and publishing DITA content.
ann.jensen
Posts: 289
Joined: Wed Jun 17, 2015 10:19 am

How to customize Related Links section with a single heading

Post 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
marius
Posts: 37
Joined: Thu Mar 05, 2009 11:44 am

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

Post 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
rlb.png (24.09 KiB) Viewed 304 times
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.
Marius Ciolacu
Syncro Soft / Oxygen XML
ann.jensen
Posts: 289
Joined: Wed Jun 17, 2015 10:19 am

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

Post 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
ann.jensen
Posts: 289
Joined: Wed Jun 17, 2015 10:19 am

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

Post 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
Post Reply