Creating help files
About help authoring tools
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.
What to include
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.
How to proceed
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.
Sample project file
For your convenience, the text of a sample project file is provided
here. (It is also in one of the topics of the PBUSR.CHM file that is
installed with PowerBuilder.)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
;******************************************* ; 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 PBUSR.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.