Navigation: Providing Context-Sensitive Help >

Web Help Integration

Send comments on this topic.

  

 

You can integrate a Web Help system with your application or website and provide context-sensitive Help by using special URL parameters that allow you to link to a specific topic, or by linking to the topic's HTML file directly.

 

Linking to a Topic File

The easiest way to display a specific topic in a Web Help system is to link to the topic's HTML file directly.

 

To get the URL address of a topic:

1.Open your Web Help system in a browser program.

2.In the Table of Contents, right-click on the topic to which you want to create a link.

3.In the popup menu, click the appropriate command to copy the link location to the Clipboard.

4.Now you can simply share the copied link with others (Ctrl+V), or insert it into an HTML page on your website (as explained below).

 

For example:

http://www.example.com/webhelp/topics/my-topic.htm

 

Linking to a Topic by Context Id

You can link to a topic in a Web Help system by using the topic's Context Id.

 

For example:

http://www.example.com/webhelp/index.htm?context=10

 

where the context parameter specifies the Context Id of the topic that you want to show.

 

Linking to a Topic by Textual Id

You can link to a topic in a Web Help system by using the topic's textual Id.

 

For example:

http://www.example.com/webhelp/index.htm?id=my_topic

 

where the id parameter specifies the textual Id of the topic that you want to show.

 

Hiding Navigation Frames

When linking to a topic's HTML file (as shown in the first example), the Web Help system automatically loads the navigation pane and other frames. If necessary, you can disable the frames loading by using an additional URL parameter.

 

For example:

http://www.example.com/webhelp/topics/my-topic.htm?frames=0

 

Linking to a Bookmark

If a topic contains a bookmark, you can also add this bookmark to the URL, so the browser will open the topic and automatically scroll to the bookmark location. The bookmark can be added to the URL string linking to a topic by filename, Context Id, or textual Id.

 

For example:

http://www.example.com/webhelp/topics/my-topic.htm#bookmark

 

where bookmark is the name of bookmark within the topic, to which you want to scroll.

 

Integration with a Web Page

On an HTML page of your website or web application, you can use regular hyperlinks to display a specific topic in your Web Help system. Below is an HTML code example that you can use to insert a hyperlink into the source of a web page.

 

For example:

<a href="http://www.example.com/webhelp/topics/my-topic.htm" target="_blank">Visit This Topic</a>

 

where the href parameter specifies the URL address linking to a topic as explained in the above examples.

 

Integration with a Windows Application

You can display a specific topic in a Web Help system from your Windows (Win32/64) application. In this case, you should pass the URL address linking to a topic to the WinAPI ShellExecute() function, so it will open the link in the default browser.

 

For more details on the ShellExecute() function, you can refer to the Windows SDK documentation.

 

Integration with a .NET Application

You can display a specific topic in a Web Help system from your .NET application. In this case, you should execute the URL address linking to a topic, so it will be opened in the default browser. Below is a code example that you can use in your .NET application.

 

For example:

string url="http://www.example.com/webhelp/topics/my-topic.htm";

System.Diagnostics.Process.Start(url);



Copyright © 2007-2024 HelpSmith.com