Table of Contents



Using Context-Sensitive Help in HTML Help

Context-sensitive help links allow you to open a specific help topic. For example, the Help button on a window in a software product can open a specific help topic that describes the window and provides links to related topics. The help topic can also be embedded in the window itself, such as an HTML pane that displays the content of the help topic.

You can reference topics in HTML Help using the file name or an internal identifier called a topic ID or topic alias. To use file names, use a Filename marker to assign a file name to a topic. Then, you can open that specific topic with that name. However, if your file naming changes, you need to change the link to the topic. To use an internal identifier, use a TopicAlias marker to define the identifier for each topic. The benefit of using this approach is that it allows file names to change without impacting the links from the product. The writer inserts this marker in a topic and specifies a unique value for that topic. Then, HTML Help uses a mapping file that defines these topic aliases.

To simplify the coding of your source documents, you can use the same marker to define both the name and the topic alias for each topic file. In Style Designer, set the Marker type option for the marker you want to use to Filename and topic alias. However, if you change the value of this marker, you need to change the application that uses this value.

To use context-sensitive help in HTML Help

  1. Determine whether you want to create and maintain the mapping file, or do you want ePublisher to create and maintain the mapping file. For more information, see “Understanding Mapping Files in HTML Help” on page 208.

  2. If you want to create and maintain the mapping file, complete the following steps:

  3. Work with your application developer to determine who will create and maintain the mapping file.

  4. Store the mapping file in the Files folder in your project. Make sure to keep this file up-to-date with the latest version of this file. Both the application and the help must be built using the same version of this file.

  5. In your source documents, use TopicAlias markers to identify the internal identifier for each topic.

  6. Set the mapping options to define your mapping file. For more information, see “Setting Mapping File Options for HTML Help” on page 210.

  7. Generate output from your project and test your context-sensitive help links. For more information, see “Testing Context-Sensitive HTML Help” on page 210.

ePublisher/2009.1/Help/02.Designing_Templates_and_Stationery/04.026.Customizing_Stationery (last edited 2009-05-01 02:13:01 by TonyMcDow)