符合windows 98规范的帮助文件的开发
·衣秀勇 闫明
windows 98的在线帮助系统较windows 95有较大的改变，它使用的是一个以网络超级文本（html）为特征的新型帮助系统，即html帮助系统。它是来自microsoft公司的下一代联机帮助系统，它使用microsoft internet explorer的基础组件来显示帮助内容，它支持html、activex、java、脚本（java 脚本和microsoft visual basic脚本）以及html图像格式（.jpeg、.gif、.png）。html帮助文件的扩展名也由winhelp的.hlp变为.chm。一个典型的html帮助系统如图1所示。
图1．一个典型的html帮助系统示例
鉴于以上原因，开发符合windows 98规范的帮助文件就成为编程人员的迫切需要。microsoft html help workshop正是microsoft公司针对这种新型帮助系统而提供的一个集成开发环境，使用它您能简捷、方便、快速地开发帮助文件。
1．创建帮助主题文件
创建一个帮助文件最重要的工作就是创建若干您需要的主题文件。html帮助的主题文件是使用超级文本语言（html）创建的html文件，其扩展名是.htm或.html。
您可以使用microsoft html help workshop创建帮助主题文件，但是笔者认为使用microsoft word 97来创建更方便。因为word 97可以把word文档（.doc）文件另存为html文件；甚至word 97还包括一个将.doc文件转换为html文件的批量文件转换工具。这样您就可以完全按您撰稿拟文的习惯编写word文档文件，然后再转换成html文件，而不必面对html复杂的源代码。在word 97中还可以使用插入（insert）菜单定义超级链接（html help workshop中称为正文链接）和书签。
2．创建帮助项目文件
2.1 html help workshop的帮助项目文件
html 帮助项目 (.hhp) 文件是一个纯文本文件，可以使用任何一个字处理软件（如windows的记事本等）打开并编辑它。html帮助项目文件将创建一个帮助文件将所需要的所有元素都联系在一起。这些元素包括帮助主题文件 (.html， .htm)、 图像文件 (.jpeg、.gif、.png)、索引文件 (.hhk)、内容文件 (.hhc)以及其他文件。它也包含关于如何编译一个帮助项目文件及帮助文件界面的信息。最后html help workshop将所有的这些内容编译成一个单个的帮助文件 (.chm) 。
2.2 创建帮助项目文件
进入microsoft html help workshop，在file菜单下选择new，在弹出的new对话框中选择project， html help workshop将启动new project向导，跟随向导就可以创建一个帮助项目文件。在其中第三步，existing files（已存在的文件）应核选html files框（见图2），以保证在第四步中能将使用word 97制作的html文件包括在帮助项目文件中。
图2．new project向导的第三步
3． 创建目录（content）文件
3.1目录和目录文件
帮助文件的目录类似于windows资源管理器的左半部分，其形式如图1中左半部分窗口所示。目录文件是包含一个帮助文件的所有目录，而每个目录又包含条目名称（或条目标题）、跳转到帮助主题的捷径以及每个条目属性的文件，该文件是一个html格式的文件。当用户在帮助文件的目录页中单击一个条目标题时，与该条目的标题相链接的html文件将被打开。
3.2 创建目录文件
创建目录文件有两种方法：
（1）在html help workshop中打开项目文件。在file菜单上单击new选项，选择table of contents，workshop将创建一个未命名的目录文件，将其保存。然后在项目文件窗口的project选项卡中单击“chang project options（改变项目选项）”按钮打开options对话框并进入files选项卡（见图3），在contents file栏中选择刚保存的目录文件。
图3．project options对话框
（2）如果项目文件中尚没有包括目录文件，那么，在刚创建的项目文件的窗口中单击contents选项卡，html help workshop将显示目录文件尚未建立的提示并允许您创建一个新的目录文件或打开一个已存在的目录文件，选择create a new contents file（创建一个新的目录文件）（见图4），单击“ok”，html help workshop创建一个空的目录文件。
图4．目录文件尚未建立对话框
3.3 向目录文件添加目录
在contents选项卡中单击“insert a heading”按钮，出现“tables of contents entry”对话框（见图5），在该对话框的“entry title”栏中输入条目标题，并单击“add”按钮为条目添加链接的帮助主题。
图5．“tables of contents entry”对话框
单击“advanced”选项卡，在“image index”栏中为条目指定图标，如包含其他条目的条目可以用书形图标，而其他条目用问号图标，如图1中所示。
在contents选项卡中单击“insert a page”按钮；如果在单击“insert a page”按钮之前，您选择的条目不包括别的条目且不被别的条目所包括，那么，html help workshop将询问您是否要创建一个起始条目，否则单击该按钮将会增加一个子条目。
contents选项卡中的其他按钮的功能包括：删除一个条目、改变一个条目的位置和级别以及修改目录的属性。
3.4 让目录文件包含另一个目录文件
打开目录文件，选择一个条目，鼠标右键单击，在弹出的菜单中单击“insert file”，在出现的include file对话框中选择另外一个目录文件（.hhc），在您选择的条目下将出现一条语句：include:filename.hhc，其中filename.hhc代表您要包含的带路径的目录文件名。
4．创建索引（index）
4.1 关键字（keyword）和索引文件
关键字是用户可能用到的并与一个或多个帮助主题文件关联在一起的字、词或短语。索引文件(.hhk)也是一个html文件，它包含若干个关键字。当用户在编译过的帮助文件里单击索引页并选择一个关键字时，帮助文件将显示与这个关键字有关的帮助主题或显示有关帮助主题的标题的列表。
4.2 创建索引文件
创建索引文件的方法与创建目录文件完全相同。
4.3 创建关键字
打开项目文件，在index选项卡中单击“insert a keyword”按钮，出现“index entry”对话框（该对话框与“tables of contents entry”对话框十分相似），在“general” 选项卡的keyword栏中输入关键字的名称，单击“add”按钮指定与该关键字相关联的帮助主题文件。
4.4 设置关键字跳转到另一个关键字
打开索引文件，选择你需要跳转到另一个关键字的关键字，单击“edit selection”按钮，在“index entry”对话框中单击“advance”选项卡（见图6），核选“destination is another keyword（目的地是一个关键字）”框。单击“general” 选项卡，单击“add”按钮，在“file or url”框中，输入您需要跳转到的关键字，单击“ok”。
图6．“index entry”对话框的advance选项卡
5．丰富帮助主题文件的内容
5.1 查看html文件的源代码
查看html文件的方法有两种。
（1）在html help workshop的file菜单上单击open打开一个html文件。
（2）在项目文件的“project”选项卡或“contents”选项卡中双击一个html文件或先选择一个html文件，然后单击“view html source”按钮。
html文件的源代码将显示在项目文件窗口的右半部分。
5.2 向html文件中插入html help activex控件
5.2.1 html help activex控件简介
html help activex控件是activex控件的一种，它是针对html帮助而设计的。向帮助主题文件中插入html help activex控件使您可以为您的帮助文件添加诸如快捷方式、相关主题、klinks及alinks等帮助文件的特征。html help activex控件所提供的功能和界面能在支持activex技术的浏览器中显示。
5.2.2 插入html help activex控件的一般方法
（1）在workshop中打开一html文件。
（2）把光标放在html文件body部分的您希望activex控件出现的地方。
（3）在“tags（标签）”菜单上， 单击 html help control （html帮助控件）， 出现hhctrl向导（见图7）。
图7．hhctrl向导的第一和
第一步，在该对话框的“specify the command（指定命令）”栏中选择一个您将使用的命令名字，在id name栏输入控件的id名称；第二步选择控件的显示类型，缺省的显示类型为按钮（button）；接着按屏幕上的提示继续操作即将html帮助控件插入html文件。向html文件中插入html help activex控件都采用这种方法，以下不再赘述。
5.2.3 向html 文件中插入快捷方式（shortcut）
使用一个快捷方式可以在帮助文件中打开或初始化一个可执行的程序。例如，用户可以在帮助文件中单击一个按钮或者一个链接（如windows 98帮助中的单击此处）来启动一个可执行的程序如（windows的记事本）或对话框（如windows的添加/删除程序对话框）。插入快捷方式的步骤如下：
