Oxygen XML Forum

Posted: **Tue Jan 06, 2026 4:57 pm**

Hello,

We're using Oxygen's PDF/CSS/HTML5 transformation to render PDFs. I'd like to customize the transformation so that if a topicref in the DITAmap has a navtitle, any corresponding topicrefs in relationship tables use the navtitle text in the link, not the topic title. Is there a template I can override to accomplish this?

The following example shows the topicref in the DITAmap and the corresponding topic in the relationship table:

Code: Select all

<topicref href="m_DriverOutput-Programming.dita" format="dita" scope="local"
  type="parametersTopic" keys="m_DriverOutput-Programming" locktitle="yes">
  <topicmeta>
	<navtitle>Driver Output Menu (Programming)</navtitle>
  </topicmeta>
  
<relrow>
	<relcell>
		<topicref keyref="drivers"/>
	</relcell>
	<relcell>
		<topicref keyref="m_DriverOutput-Programming"/>
		<topicref keyref="m_DriverOutput-Monitor"/>
	</relcell>
	<relcell/>
</relrow>

Thank you for looking at this.

Posted: **Thu Jan 08, 2026 1:05 pm**

Hello,

There's no possibility to use the navtitle directly in reltable links, however, you can use the <linktext> element and copy the navtitle content:

Code: Select all

<topicref href="m_DriverOutput-Programming.dita" format="dita" scope="local"
    type="parametersTopic" keys="m_DriverOutput-Programming" locktitle="yes">
    <topicmeta>
        <navtitle>Driver Output Menu (Programming)</navtitle>
        <linktext>Driver Output Menu (Programming)</linktext>
    </topicmeta>
</topicref>

With this you should get the same text in both TOC and links.

Regards,
Julien

Oxygen XML Forum

navtitle for relationship table links

navtitle for relationship table links

Re: navtitle for relationship table links