Links does not works for Help1x Files

Topics: Developer Forum
Dec 28, 2007 at 8:13 PM
Hi Eric,

With SHFB 1.6.0.2 Help1x generated files, i get problems with some links between header of the help page and the corresponding target.

In other words I choose a class help page for one of my classes, and when I click on the Members link in the header of the page, i get this error

Sorry, no topics were found for the selected link.

Keywords = ""
IndexMoniker =
Source URL =

I also got this error when I choose a link to another of my class from the summary of one of my members classes in the 'Members' pages.

Does not happen with Help 2x files nor website.

I use VS2005 transforms and my solutionn XML doc files are generated by VS2008 that does not complains about reference in xml doc comments.

Any cases, whenever you want to answer, I already whish you a Happy new year for you and yours...

PS : what is also strange is the fact that i get no errors nor warnings in the build log file. Should it can that come of a wrong version of the MS Help Workshop 1.x?
Coordinator
Dec 29, 2007 at 1:33 AM
This usually occurs when you have the SdkLinkType and/or ProjectLinkType set to Index. Index only works in Help 2 files and then only if the help file is integrated into a collection. It doesn't work for Help 1 files or websites.

Eric
Dec 29, 2007 at 6:24 AM


EWoodruff wrote:
This usually occurs when you have the SdkLinkType and/or ProjectLinkType set to Index. Index only works in Help 2 files and then only if the help file is integrated into a collection. It doesn't work for Help 1 files or websites.

Eric



Thx for this usefull input Eric. This indeed does the job.

In other word, Is it also mean that I should made two separate builds:

  1. A build for Help 1x with Project link set to Local and SdkLink set to MSDN providing an independant help file.
  2. A Second build for Help 2x with both Project and SDK Link set to index in order to have a help that can be integrated with VS collection.

If it is, maybe could you insist on this in your topic about Link types. Being not a specialist of help files, it does make me not se clear when reading help of SHFB. Maybe you will think that it is not in the scope of your project. But on the other side, your tool eleminate so much need of tedious docs reading about MS Help files that I think that some precisions about those litlle details could help to not disturbe you with ridiculous questions...

At all a great tool. I think I will recomend my Boss that all the enterprise use this.
Coordinator
Dec 29, 2007 at 8:29 PM
I'll make a note in the property documentation as requested.

Eric