Keys for Topicrefs Not Displaying in Webhelp Output

[dgallo]

We have created keys for our topicrefs. We then insert the key reference into the ditamap instead of the topicref itself. When we transform with webhelp, the topics do not show up. Are we doing something wrong?

Also, we are using Oxygen 17.1.

Thanks,
Danielle

[radu_pisoi]

Hello Danielle,

I cannot reproduce your problem with a simple DITA map that uses the 'keys' support to aggregate topics in map.

Usually this problem happens when users use the 'glossref' element instead of 'topicref' because the default value for the 'glossref/@toc' attribute is 'no'. If this is your case, please specify the '@toc = yes' attribute to present the topic reference in TOC.

If you are not using 'glossref' elements, please send us a sample DITA Map together with the referenced topics to support@oxygenxml.com.

[dgallo]

I have had both success and failure. For a better understanding of my problem, I wanted to provide you an idea of the maps I am working with.

Map Breakdown
Map A: Reference Guide that uses keys to aggregate topics
Map B: Container for topicref keys in Map A.
Map C: User Guide

I was able to successfully transform Map A that uses keys to aggregate topics. Map A is the parent map and contains Map B which is the child map in which the topicref keys are defined.

The trouble I run into is when I take Map A and embedded it into Map C. When I transform Map C, the topics that successfully transformed in Map A do not appear.

To sum it up:

Transform 1: Successful
Map A (Parent)
Map B (Child)

Transform 2: Unsuccessful
Map C (Parent)
Map A (Child map that also contains Map B)

Thanks,
Danielle

[radu_pisoi]

Hello,

The oXygen 17.1 comes bundled with DITA-OT 1.8.5 and DITA-OT 2.1.2. I have managed to reproduce your issue only with DITA-OT 2.1.2.
You can change the DITA-OT version from the DITA preferences page.

Fortunately, this issue seems to be fixed in DITA-OT 2.2.3 that will be bundled with the next oXygen version.

Is this your use case? Are you using DITA-OT 2.1.2?

[dgallo]

Yes. I am using 2.1.2. It now works when I switch the 1.8.

When is the next version of Oxygen scheduled to be released?

[radu_pisoi]

Hi,

We are going to release a new oXygen version at the beginning of May.

[dgallo]

I am now running into a new issue when keys are used to aggregate topics. When the parent key reference is assigned chunk = "to-content", the child key reference does not display correctly or does not display at all. When using DITA-OT 1.8, the child key references display but none of the defined css styles are applied. When using DITA-OT 1.2, the child key references do not display at all.

Thanks,
Danielle