Authoring Help Information

The topics in this chapter of the JavaHelp System User's Guide describe the aspects of the JavaHelp system of primary interest to online help authors. These topics assume that the author is responsible for creating the metadata files that JavaHelp uses to present information, as well as the topics that inform the application's users. Together the metadata and topic files are referred to as a HelpSet.

If you use a help authoring tool to create your help system, most of the details described in this chapter are managed for you by the tool.

The following is a summary of the tasks required to create a HelpSet. All of these tasks are described in this chapter of the JavaHelp System User's Guide:

• Create HTML topics
• Create a HelpSet file
• Create a map file
• Create a table of contents file
• Create an index file
• Create a full-text search database
• Compress and encapsulate the help files into a JAR file for delivery to customers

Consider the following strategy as a way to get started:

1. Use the demonstration programs included with the release to acquaint yourself with JavaHelp system features. The most useful demo for this purpose is idedemo. This program demonstrates a fully functional help system.
2. Read the remainder of this chapter of the JavaHelp System User's Guide, and explore the HelpSet files created for idedemo (demos\hs\idehelp).
3. Create your own HelpSet:
   1. Create HTML topics using an editor of your choosing (be sure to use only HTML 3.2 tags).
   2. Copy the metadata files from demos\hs\idehelp to the folder that contains your topic files.
   3. Edit the metadata files to match your help information.
   4. Use the hsviewer command to display your HelpSet.