Skip to main content
EileenPalsson
Inspiring
May 21, 2010
Question

Related Topics link (created with JavaScript:RelatedTopics.Click) broken when topics opened from TOC

  • May 21, 2010
  • 1 reply
  • 1513 views

In a separate thread, Praful Jain provided us with a useful script that fixed broken "related topics/see also" links: http://forums.adobe.com/message/2513306

I find it works pretty well. The only problem is, if you access the help topics via the Contents tab (TOC) of a CHM file [I haven't tested any other output yet], then such "related topics" or "see also" links don't work. If you access the topic some other way (for example from the Search tab, Index tab, or via a link from another topic), those same links DO work.

Since I was checking via the TOC, and finding that none of the "related topics/see also" links I found that way were working, at first I thought that RH8.0.2 had somehow "lost" all of the A-keywords in the project, and I reported this in the forum: http://forums.adobe.com/message/2825485

While it's still a problem that the A-keywords (1) are not listed in the See Also pod and (2) are not listed on the See Also tab of the respective Topic Properties, I now find that the links created using the A-keywords (which somehow still exist and are still visible on the See Also tab of the See Also Properties dialog) ARE working.

So, the point: Can we get an updated script that will ensure that those "related topics/see also" links will also work when the topics are accessed from the TOC?

Regards,

Eileen

This topic has been closed for replies.

1 reply

Praful_Jain
Participating Frequently
May 24, 2010

Hi Eileen,

Can you please provide a sample project where clicking from TOC, the related topic click does not work. This will help me in finding the main problem.

Thanks

Praful

EileenPalsson
Inspiring
May 24, 2010

Hi Praful,

Thank you for your response. Unfortunately, I'm going to have to get back to you on that tomorrow. Here's what happened: I made a copy of one of my projects where this problem occurs, and deleted 99% of the topics, just keeping those that are involved in the problem.

Then I created a new TOC.

Then I ran your original script on that small project (including compilation) -- and now the links work.

So I went back to the original project and ran your script again, thinking maybe I just made a big mistake. No luck.

So tomorrow I will look for differences in the supposedly identical topics in the two projects that might explain why the small project is working but the large one is not. I'll let you know what I find. (However, feel free to comment if you have an idea what I should look for.)

Thanks and regards,

Eileen

EileenPalsson
Inspiring
May 31, 2010

Hi Eileen,

Sorry for the late reply, I verified your assumption, in case there are more than one entry to a topic in TOC, then this issue seems to appear.

Can you please verify one more thing, right click on the microsoft HTML help output SSL layout and select properties, in SSL dialog select breadcrumb option in the dialog. You can change the style and format of the breadcrumb. Now save the settings. Run the related topic script to generate the CHM output.

Let me know if this solves the problem you are facing? I tried the same on the project you shared with me, and could not find the issue.

Thanks for the help and support

Thanks

Praful


Thank you for the suggestion, Praful. I tested your suggestion. Here's the result:

  • When I navigate to "Name property" in a book where it first occurs, the "Related Topics" link (actually "Applies To" in this case) works.
  • When I navigate to "Name property" in another book where it occurs, and click on that topic, the topic TOC sometimes automatically switches back to the "Name property" in the first book where it occurs. When this happens, the "Applies To" link works.
  • When the TOC does not automatically switch back to the "Name property" topic where it first occurs, but stays in the folder where I clicked on the topic,  the "Applies To" link does not work.

What do you think?