Description Nilesh vilankar 2011-08-04 07:36:13 EDT

Build Identifier: I20100608-0911

I have created a Plugin for providsing eclipse based user help.
it consists of two parts
1- Table of contents
2- Context help

While specifying the Table of contents - we need to provide a location for the html file that it contains the help contents.

i have included a sample toc.xml below to explain the issue
when the href is something like the following
   <topic href="bin/com/teamcenter/rac/aifrcp/help/help/index.html#uid:index_whats_new" label="what&apos;s new for TeamCenter 9.1s new">
the topic in the toc does not show anything when opened, however the same link works and shows a proper html page when opened from the "context help"'s contents link.

However if instead of the above i use a direct link to a html page like below
it works fine in both the toc window as well as the context help's contents link.

<topic href="bin/com/teamcenter/rac/aifrcp/help/help/newlink2.html" label="link2">

Is there a configuration/preference that we can set to correct this issue?

-----------------------------toc.xml------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<toc label="TeamCenter Help" topic="bin/com/teamcenter/rac/aifrcp/help/help/index.html">
   <topic href="bin/com/teamcenter/rac/aifrcp/help/help/index.html#uid:index_whats_new" label="what&apos;s new for TeamCenter 9.1s new">
      <topic href="bin/com/teamcenter/rac/aifrcp/help/help/index.html#uid:index_whats_new:tcfeatures" label="what&apos;s new for TeamCenter 9.11opic">
      </topic>
   </topic>
   <topic href="bin/com/teamcenter/rac/aifrcp/help/help/index.html#uid:index_plm00125" label="Frequently Asked Questions for Teamcenter">
   </topic>
   <topic href="bin/com/teamcenter/rac/aifrcp/help/help/index.html#uid:index_plm00125:getting_started" label="Getting started with Teamcenter">
   </topic>
   <topic href="bin/com/teamcenter/rac/aifrcp/help/help/DEtailsview11.html" label="details">
      <topic href="bin/com/teamcenter/rac/aifrcp/help/help/newlink1.html" label="link1">
         <topic href="bin/com/teamcenter/rac/aifrcp/help/help/newlink2.html" label="link2">
         </topic>
      </topic>
   </topic>
</toc>
------------------------------------------------------------------------

-----------------------contexthelp.xml---------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<contexts>
   <context id="Details_View">
      <topic href="bin/com/teamcenter/rac/aifrcp/help/help/DEtailsview11.html/aifrcp/help/help/Details_View.html" label="Details_View1"/>
      <topic href="bin/com/teamcenter/rac/aifrcp/help/help/newlink2.html" label="Details_View2"/>
   </context>
   <context id="Help_Context">
      <topic href="bin/com/teamcenter/rac/aifrcp/help/help/Details_View.html" label="details view"/>
   </context>
</contexts>
------------------------------------------------------------------------------

Reproducible: Always

Steps to Reproduce:
1. Create a blank Eclipse Plug-in project
2. Add below shown four “org.eclipse.help” plugins to the dependencies list
3. Press “Ctrl + N” and filter the type as “help”
4. Create one “Help Table of content file” and one “Context Help” file
5. Add two extensions “org.eclipse.help.toc” and “org.eclipse.help.contexts”
6. Refer earlier created XML files in these two extensions.
7. in the toc.xml,Create "topic1" with location as".......foo.html#abc:xyz".
8. in the toc.xml,Create "topic2" with location as".......foonew.html".
9. Create a plug in from the above containing the above html files in the plug-in.
10.use the plug-in in your application.
11.Add command ids for adding "help Contents" and "Dynamic help' in the help menu of the Rich client application
12.Help contents -> Toc
13.Dynami Help -> Context help
14.Launch your application and click "Help contents", Click "topic1"
15.notice that the proper page is not displayed.
16.click help contents-> topic2. notice that the proper page is displayed.
17.In your apllication, press help-> dynamic help. click "contents".
18.notice that you see the same table of contents as above. Click "topic1"
19.notice that the proper page is displayed.
20.click contents-> topic2. notice that the proper page is displayed.