Oxygen XML Forum

I'm using oXygen 12 and OT 1.5.3 and have not been able to get glossary keydefs to work as expected.

I have a ditamap such as the following:

<map title="DITA Topic Map">
<glossref keys="deliv" href="g_deliverable.xml"/>
<topicref href="content/c_creating_deliverables.xml"/>
</map>

This is my folder structure:

widget
[maps]
[glossentries]
..content
..images
..output

In the topic c_creating_deliverables.xml, I have the following text:

In the map(s) that comprise your <term keyref="deliv"/> , you...

When I click the key icon in oXygen that indicates a keyref, I get the following message: Specified file does not exist: file:/C:/widget/_content/Keyref@20deliv

Where in the world is this path coming from? It's not even a path in my folder structure; I don't have a _content folder.

As expected, the glossterm does not appear in the output. I have checked and rechecked my syntax and can't find anything wrong, at least based on my reading of the specs and understanding of how this works.

Thanks,
Leigh

Hi Leigh,

Oxygen is just the XML editor, the publishing of DITA content to various output formats is done using the DITA Open Toolkit.

So it is very possible to see inconsistencies between how the editor shows and navigates in the DITA topics and the published output.

In order to find the target of a key reference correctly Oxygen needs to have the main DITA Map opened in the DITA Maps Manager. So if you do not have the DITA Map opened in the DITA Maps Manager this could be an explanation for the behavior.

The error message is indeed confusing, we've already fixed this in Oxygen 12.2 (which will be available in a couple of weeks) to state things more clearly like Could not resolve target for key reference [keyname].

I tried making a small DITA project based on your suggestions but publishing it to HTML seemed to properly link the topic and the glossentry file.

In the DITA Maps Manager view you also have a Validate and check for completeness toolbar button which you can use on the main DITA Map to spot linking problems.

If you still cannot find the problem you can try to make a small cut-down DITA project on which the issue can be reproduced and send it to our support email address (support at oxygenxml dot com) for analysis.

Regards,
Radu