DITA Map Manager should resolve titles containing conkeyrefs

jmp120 · Post by **jmp120** » Wed Feb 05, 2020 7:27 pm

We have topic titles which contain titles such as:

<title>Configure <ph conkeyref="product/feature"/></title>

The DITA Map Manager does not resolve this conkeyref when displaying the titles of the topicrefs. It displays the topic title as "Configure " in the DITA Map Manager hierarchy. This makes it difficult for our writers to know which topic this is specifically referring to.

I found a similar feature request from 7 years ago for keyrefs not doing this: post25006.html?hilit=title%20keyref#p25006. Conkeyrefs should resolve in a similar manner.

Post by **Radu** » Thu Feb 06, 2020 9:35 am

Hi,

What version of Oxygen are you using?
Here's what I tested on my side using Oxygen 21.1:

1) Created a "Reusables.dita" topic with the content:

Code: Select all

<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="reusables">
    <title>Reusables</title>
    <body>
        <p><ph id="feature">test</ph></p>
    </body>
</topic>

2) Added a reference to it in the DITA Map:

Code: Select all

<keydef href="topics/reusables.dita" keys="product"/>

3) Used in another topic that title that you already exemplified.

4) The DITA Maps Manager properly expands the title of the topic.

If you still have problems making this work, are you working with topics from the local disk or from a CMS? Oxygen has APIs which allow a CMS to take over the computation of titles in the DITA Maps Manager so this might be a problem in which the plugin implemented by the CMS for Oxygen does not properly resolve such constructs.

Regards,
Radu

DITA Map Manager should resolve titles containing conkeyrefs

DITA Map Manager should resolve titles containing conkeyrefs

Re: DITA Map Manager should resolve titles containing conkeyrefs