DITA Map Manager should resolve titles containing conkeyrefs

Are you missing a feature? Request it's implementation here.
Posts: 1
Joined: Thu Aug 17, 2017 8:27 pm

DITA Map Manager should resolve titles containing conkeyrefs

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

We have topic titles which contain titles such as:

Code: Select all

<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.

Posts: 6980
Joined: Fri Jul 09, 2004 5:18 pm

Re: DITA Map Manager should resolve titles containing conkeyrefs

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


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">
        <p><ph id="feature">test</ph></p>
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.

Radu Coravu
<oXygen/> XML Editor

Post Reply