There are many authoring tools and related products available for creating online help files on Windows. All of the authoring tools for Microsoft HTML Help files use the Microsoft HTML Help compiler (hhc.exe) to generate a finished help file.
The source files for any help system typically include:
Topic files (HTML) contain the text of your help system as well as footnote codes and commands that serve to identify the topics and provide navigation and other features.
Graphics files contain images associated with specific topics.
Project file (HHP) defines a single help collection and contains instructions for the compiler.
Contents file (HHC) provides the entries that populate the Contents tab of the help window.
Index file (HHK) provides index keywords that the author provides, similar to a traditional book index, that link to specific topics.
For each project, the compiler generates a single CHM file that can be opened in an HTML Help window.
If you are using a full-featured Help authoring tool, follow its instructions for creating the necessary source files and compiling them. The HTML Help Workshop, available from Microsoft with the HTML Help compiler, also has help describing how to author help and how to implement it in a Windows application.
For your convenience, the text of a sample project file is provided here. (It is also in one of the topics of the PBUSR125.CHM file that is installed with PowerBuilder.)
;******************************************* ; Sample HTML Help project file ; Use a semicolon (;) to start a comment ; Replace filenames and other options with values ; for your project. ;******************************************* [OPTIONS] Binary TOC=No Binary Index=Yes Compiled File=project.chm Contents File=project.hhc Index File=project.hhk Default Window=main Default Topic=doc/html/welcome.html Default Font= Flat=No Full-text search=Yes Auto Index=Yes Language= Title=Our Application Help Create CHI file=No Compatibility=1.1 or later Error log file=project.log Full text search stop list file= Display compile progress=Yes Display compile notes=Yes [WINDOWS] main="Our Application Help","project.hhc","project.hhk", "doc/html/welcome.html","doc/html/welcome.html",,,,, 0x23520,222,0x1846,[10,10,640,450],0xB0000,,,,,,0 [FILES] doc/html/pbusr.html doc/styles/main.css doc/images/logo.png
To use the sample project file:
Copy the help project code to the Windows clipboard.
Open a text editor (like Notepad, not a word processor like Word or Wordpad) and paste the clipboard text into a blank document.
Alternatively, open the project file in your favorite HTML Help authoring tool.
Save the document in text format as PBUSR125.HHP.
Edit your project file to specify the details of your help development environment, such as source file names and directory path names. For details, see the instructions in the HTML Help Workshop or your help authoring tool.
