Pussy-willow

I have created and successfully integrated my Help2 collection with Visual Studio 2005. To do this, I used FAR HTML to convert chm to Help2, then used MS Help integration wizard to create merge modules and finally buit and applied msi. Exactly as it is discussed in the tutorial at: http://frank.helpware.net/ page_id=5. The Help collection is visible under Visual Studio, the index works well. However, search (local, with all categories, languages, etc. checked) returns "No results found". Why does Search ignore my collection and could anyone please advise me how to make Search properly treat my collection

Could such Search behavior be caused by that I have a license for FAR 3.x and hence used the latest version of FAR, required for some steps of the process, in a try mode



Re: Developer Documentation and Help System Why Help Search in Visual Studio 2005 does not access my integrated Help collection?

Frank Palinkas

Hi Pussy-willow,

My apologies for the late reply.

As you know, I also use Helpware FAR HTML for my H1 to H2 conversion process. I am running a fully licensed copy of FAR version 4, and can see results from my H2 Collections returned in the VS 2005 Search results pane. I haven't done anything different than yourself throughout the conversion and integration process, so let's look at expanding or broadening your Search facility in VS 2005.

In VS 2005, go to Tools > Options

  1. Under the Help topic, in the General subtopic dialog box, make sure the Show Help Using dropdown list is set to Integrated Help Viewer.
  2. In the Search Results per page textbox, set the integer to 50 (or higher if you wish)
  3. Check the Include partial matches in Local Search Results checkbox.
  4. To easily see the key words in the found pages, check the Highlight Search Items checkbox (you can disable this later after you test).
  5. To make the returned Search results easier on your eyes, uncheck the Show topic abstracts checkbox (you can re-enable this later if it suits).

In the VS 2005 Search facility Content Type filter:

  1. Make sure that Documentation and Articles is checked.

Let's see if this helps get your Search topics shown. Please let us know how it goes

Kind regards,

Frank






Re: Developer Documentation and Help System Why Help Search in Visual Studio 2005 does not access my integrated Help collection?

Pussy-willow

Hi Frank,

Thanks for your advice. My Search settings were different and now I know what they should be. However, this did not help. Could the usage of a partially trial version of FAR be the reason of such Search behavior (At the stage of creating help2 project, FAR prompts me of that the functionality is used in the try mode -- my license is for FAR 3.x)

Regards,

Pussy-willow





Re: Developer Documentation and Help System Why Help Search in Visual Studio 2005 does not access my integrated Help collection?

Eeva01

Hi Frank,

I also have a problem with my help collection not being picked up by the search, and the links from my classes do not work.

This was the first time I've created help topics for VS. I used the Sandcastle Help File Builder instead of using FAR. Is this a viable solution

Is there a way I can check the cross-references between my classes and the help

Best regards,

Eeva





Re: Developer Documentation and Help System Why Help Search in Visual Studio 2005 does not access my integrated Help collection?

Frank Palinkas

Hi Pussy-willow, you're most welcome.

I haven't experienced this problem, but if this is the cause, then try downloading the latest Beta version of Helpware FAR HTML - FAR 4.2 (Build 670):

http://www.helpware.net/FAR/index.html

Do the conversion from H1 to H2 and then the integration process with the Help Integration Wizard in VS2005.

Also, please try to install and use the latest release of the VS2005 SDK Feb 2007.

Please let us know if this helps solve the problem

Frank






Re: Developer Documentation and Help System Why Help Search in Visual Studio 2005 does not access my integrated Help collection?

Frank Palinkas

Hi Eeva,

Yes, Eric's Help File Builder is a very viable solution, with many members of this Forum using it. However, I don't believe I'm qualified enough in its use to advise you on it.

May I suggest that you start a new thread with "Sandcastle Help File Builder - Class Link Problems" as the topic so that knowlegeable users of that application can refer to it and offer their assistance to you

Hope this helps,

Frank






Re: Developer Documentation and Help System Why Help Search in Visual Studio 2005 does not access my integrated Help collection?

Eeva01

Hi Frank,

Thank you very much for your help.

Once you confirmed that Sandcastle File Builder was a way to go, I went on to test my help further and finally got it to work.

To get both the search and the F1 help to work I changed all the filters (Language, Technology and Content Type) to All and I changed the Help to be searched locally first.

I think the Sandcastle Help Builder is an easier way to create the help than FAR, but it does not have (or I could not find) any documentation for integrating with Visual Studio, so I found your instructions very helpful.

Best regards,

Eeva