Page 1 of 1
Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Sat Apr 02, 2016 12:38 am
by 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
Re: Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Mon Apr 04, 2016 10:28 am
by 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.
Re: Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Tue Apr 05, 2016 8:35 pm
by 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
Re: Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Wed Apr 06, 2016 4:42 pm
by 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?
Re: Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Wed Apr 06, 2016 5:26 pm
by 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?
Re: Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Thu Apr 07, 2016 11:38 am
by radu_pisoi
Hi,
We are going to release a new oXygen version at the beginning of May.
Re: Keys for Topicrefs Not Displaying in Webhelp Output
Posted: Thu Apr 07, 2016 6:14 pm
by 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