Topic number with the title in cross references

Post here questions and problems related to editing and publishing DITA content.
Maick
Posts: 2
Joined: Wed Oct 15, 2025 10:01 am

Topic number with the title in cross references

Post by Maick »

Hi
When cross referencing topics within a ditamap, the PDF output (using XSL-FO) shows the link in format "Topic title on page 123". How can I edit the configuration that the link also contains the topic number? So the output I'd like would be in format "1.2 Topic title on page 123".

Example from PDF output:
Untitled.png
I found that the cross references are controlled through file links.xsl but for the life of me cannot figure out what must be added to get the topic number appear before the title text.

Code: Select all

<xsl:variable name="referenceTitle" as="node()*">
      <xsl:apply-templates select="." mode="insertReferenceTitle">
        <xsl:with-param name="href" select="@href"/>
        <xsl:with-param name="titlePrefix" select="''"/>   <-- should something be added here?
        <xsl:with-param name="destination" select="$destination"/>
        <xsl:with-param name="element" select="$element"/>
      </xsl:apply-templates>
    </xsl:variable>
...

Code: Select all

<xsl:when test="not(@scope = 'external' or not(empty(@format) or  @format = 'dita')) and exists($referenceTitle)">
	<xsl:copy-of select="$referenceTitle"/>
</xsl:when>
Thanks,
Mika
You do not have the required permissions to view the files attached to this post.
julien_lacour
Posts: 723
Joined: Wed Oct 16, 2019 3:47 pm

Re: Topic number with the title in cross references

Post by julien_lacour »

Hi Mika,

Could you indicate which version of Oxygen you are using? Or are you using Oxygen Publishing Engine (default) or DITA-OT?
Are you using the DITA Map PDF - based on XSL-FO scenario (or any pdf2 transtype)?
Do you have any custom plugin in Oxygen Publishing Engine/DITA-OT?

Regards,
Julien
Maick
Posts: 2
Joined: Wed Oct 15, 2025 10:01 am

Re: Topic number with the title in cross references

Post by Maick »

Hi Julien,
Currently running Oxygen XML Author v25.1 and using the default Apache FOP publishing engine. And yes the transformation scenario is based on "DITA Map PDF - based on XSL-FO scenario" with my own customization scripts, mainly for visual updates.

Best,
Mika
julien_lacour
Posts: 723
Joined: Wed Oct 16, 2019 3:47 pm

Re: Topic number with the title in cross references

Post by julien_lacour »

Hi Mika,

This customization requires multiple modifications in the XSLT stylesheets which falls outside the scope of our support. For this kind of request you can try to ask the DITA Users group.

On the other side you could try to migrate your customization from XSL to CSS and use DITA Map PDF - based on HTML5 & CSS, it already includes multiple numbering scheme and this kind of link customization can be done with ::before pseudo-elements.

Regards,
Julien
Post Reply