Page 1 of 1

Web help does not display topic title in TOC

Posted: Wed Nov 21, 2018 8:18 pm
by Trapeze
Using the most current version of oXygen, I've been creating webhelp responsive outputs. I have a problem with one file. In the web help TOC, it displays as an ellipsis (...). All the other files display their title as expected. The title is not particularly long, shorter than many other properly displayed titles. When I click on the ellipsis, the file is properly displayed. When I create a pdf of the same document, the TOC is displayed properly. The file has no discernable DITA errors (I've run validation). I've also erased and rewritten the title without any difference. The file has this problem when published in different ditamaps, so it is not the surrounding files. The problem occurs no matter which webhelp template I use and I have replicated it on different machines. The help generates without any error messages.

Has any one else encountered this problem and have any any idea as to what is causing the problem or how I might go about debugging it.

Re: Web help does not display topic title in TOC

Posted: Thu Nov 22, 2018 1:50 pm
by ionela

When you perform the 'DITA Map Validation and Check for Completeness' action could you please make sure that 'Report references to resources outside of the DITA map folder' option is selected?
One possible cause of this problem might be if you have resources located outside of the main DITA map folder.
Using this option you make sure that the validation reports any references to DITA resources that are located outside of the main DITA map directory.
If that's the case, and you run the WebHelp Responsive transformation scenario from oXygen XML GUI, you can set the '' parameter to true in the transformation scenario: References Outside the Main DITA Map Folder

If this is not the problem, please create a minimal valid sample project and send it to us by email to support AT oxygenxml DOT com for further investigation.


Re: Web help does not display topic title in TOC

Posted: Fri Nov 23, 2018 9:19 pm
by Trapeze
The problem was not the parameters.

I discovered the issue was the metadata for the file. For some reason, this file had metadata which included a blank navtitle entry, like this


There was other metadata and the syntax was correct. But the blank navtitle seems to override the file title in the webhelp TOC.

Re: Web help does not display topic title in TOC

Posted: Mon Nov 26, 2018 2:46 pm
by radu_pisoi

This is the desired behavior, the navtitle specified in the DITA map overrides the topic's title.

See more details in DITA specification: ... title.html