Keys for Topicrefs Not Displaying in Webhelp Output

<oXygen/> general issues.
dgallo
Posts: 84

Keys for Topicrefs Not Displaying in Webhelp Output

Sat Apr 02, 2016 12:38 am

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
Posts: 329
Location: Craiova

Re: Keys for Topicrefs Not Displaying in Webhelp Output

Mon Apr 04, 2016 10:28 am

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.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
dgallo
Posts: 84

Re: Keys for Topicrefs Not Displaying in Webhelp Output

Tue Apr 05, 2016 8:35 pm

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
Posts: 329
Location: Craiova

Re: Keys for Topicrefs Not Displaying in Webhelp Output

Wed Apr 06, 2016 4:42 pm

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?
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
dgallo
Posts: 84

Re: Keys for Topicrefs Not Displaying in Webhelp Output

Wed Apr 06, 2016 5:26 pm

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
Posts: 329
Location: Craiova

Re: Keys for Topicrefs Not Displaying in Webhelp Output

Thu Apr 07, 2016 11:38 am

Hi,

We are going to release a new oXygen version at the beginning of May.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
dgallo
Posts: 84

Re: Keys for Topicrefs Not Displaying in Webhelp Output

Thu Apr 07, 2016 6:14 pm

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

Return to “Other Issues”

Who is online

Users browsing this forum: No registered users and 0 guests