| 出版日期：1999-08-09 总期号：847 本年期号：57 |
|
 |
制作windows帮助文档三法
许根利 在windows操作环境中，帮助文档可分为hlp（help）格式与chm（compiled html file）格式两种。hlp格式在windows 3．x／95／98下通用，以往绝大多数的windows软件采用的都是此类型。hlp格式可从包含有各帮助信息及其控制码的rtf（rich text file）文件编译生成。chm为windows 98所独有的基于html的帮助格式，它使用了与微软的ie完全相同的底层驱动引擎，利用html强大的功能，可以制做出hlp所无法比拟的生动活泼的声音、动画、网络链接等接口。 经过笔者多次实践，总结出以下几种制作windows帮助文档的方法。 一、手工编制生成hlp帮助文档 该方法最原始，也最烦琐，适用于帮助主题不太多的小型帮助文档制作。首先，通过word或richedit等可直接编辑rtf格式文件的编辑器，在正文区录入原始帮助信息，在脚注区录入相应控制代码及变量定义，主要控制代码有： ＃脚注：惟一标识每个帮助主题的变量定义。 ＄脚注：指定每个帮助主题的标题信息，可用不超过64个汉字表示。 k脚注：用来指定与每个帮助主题相关联的查询关键字。 ＋脚注：用来定义帮助文档中各帮助主题的浏览顺序。 ！脚注：用于单击后执行一条宏命令的定义，需用隐藏字体。 正文区跳转：用隐藏文本的双下划线格式表示，其后紧跟所需跳至目的帮助主题的变量定义。 正文区旁注：用隐藏文本的单下划线格式表示，其后紧跟单击后所需弹出的目的帮助主题的变量定义。 依据上述规则，编制好rtf文件后存盘，利用微软的许多大型软件，如vfp、vc＋＋等捆绑携带的hcw（help workshop）对其建立一个工程，定义好各项参数后进行编译才能生成hlp文档。若操作系统为windows 95及以上的话，还需在hcw下定义一cnt（content）的书签索引文件才行。windows 3．x可以直接进行编译。 许多人费尽心机写完rtf文档，编译生成hlp时出现“字体错误”之类的提示，就中途停止。遇到这种情况，是因为所使用的hcw不支持中文rtf格式，找一个较新的hcw后期版本重新试一下，就可以顺利完成编制任务。 二、利用帮助文档编写工具 有很多可以直接生成帮助文档的集成环境工具软件，如helpscribble 4．10、anethelptool 4．05、windows help designer 2．2．3．0、help＆manual 2．1．0（本文简称为hm2）等。笔者比较看好hm2，它是真正的“所见即所得”的编写工具，可方便地生成16位与32位版本的rtf与hlp帮助文档。同样，也可生成windows 98下独有的html help文档，而且，可以方便地将包含文档目录、用户所定义各页的页眉、页脚、页号在内的联机文档打印出来。现以hm2为例，对用工具软件生成帮助文档的过程作一介绍。 1．新建一个hm2工程文件或选择将其它格式帮助工程文件转化为hm2格式，输入如“介绍，第几章…”之类各帮助主题及其相应子主题的标题信息，也可不输入。系统将按默认的主题框架生成工程结构样本，供具体修改使用。 2．进入操作主界面，分为三个窗口区域。左上方为帮助文档目录树窗口，显示当前帮助工程文件中各主题与子主题的标题信息与从属关系。在每个主题上单击鼠标右键，弹出快捷选单，可对当前主题进行编辑修改。在此处，还可方便地利用鼠标的拖动来实现主题之间从属关系的调整。 左下方为帮助文档弹出式主题定义窗口，显示当前帮助工程文件中各弹出式主题的列表情况。类似于目录窗口操作，在各主题上单击鼠标右键将弹出快捷选单，可对当前主题进行编辑修改。同样可用鼠标的拖动来实现主题之间顺序的调整。 右边为帮助文档属性窗口，分为topic options（主题参数）和help text（帮助文本）两页。两页所有的信息对应于左边窗口内的主题热点，在主题参数页可编辑定义主题的id变量名、归属窗口、归属文件、索引关键字、主题关联关系等；帮助文本页可显示帮助主题的正文信息，在此可利用hm2编辑器录入正文，还可添加图片、动画、ole对象、宏指令函数、超级链接等。 主选单中可利用“screen capture”功能抓取屏幕图像，方便地实现应用软件操作界面图形帮助的截取插入。hm2还提供了delphi工程接口，利用它可有机地与所制做的delphi软件挂接，生成所需的帮助文档。 3．使用主选单或快捷选单中的“make”功能，生成所需的诸多如windows 3．x／95、rtf、html、html help格式的联机与帮助文档。至此，一个完整的帮助文档就生成了。 三、利用hhw（html help workshop）制做chm帮助文档 在windows 98系统中，帮助文档已淘汰hlp，全部转为chm格式。在windows 98系统中已自带了chm的打开工具hh．exe（默认安装在windows 98系统目录中），它使用activex控件将帮助主题与主题信息同屏显示，提供操作按钮，使得帮助文档看起来更像是自己编制的一个应用程序。 首先，应通过frontpage 98、homesite等工具或手工按每一主题、每一文件的形式，编制好各帮助主题的html文件，积累好所需的素材，存储在磁盘中。在编写时尽可使用html各种活泼的功能，实现你所要实现的特殊效果（如背景音乐、动画显示、css、java等），这是在以前的帮助文档中不可想像的。 hhw操作极为简便，新建一个帮助文档工程文件，出现一包含project（工程）、contents（目录）、index（索引）三页的主窗口。 工程页可修改工程的标题、默认文件、定义窗口、语言类别、字体、输出文件、目录文件名、索引文件名、各编译参数，增加删除主题html文件及修正其源代码。 目录页可修改目录的各类属性，增删编辑主题头（heading）和主题页（page），可通过按钮或鼠标的拖动实现主题头与主题页的顺序排列和从属关系的调整。 索引页可修改索引的各类属性，增删编辑索引关键字（keyword），可通过按钮或鼠标的拖动实现索引关键字的顺序排列，也可按拼音顺序自动排列。 定义好上述内容后就可按主选单或快捷按钮编译生成chm帮助文档。附图为笔者制做的一个chm帮助文档样本。 当然，生成帮助文档的方法及工具还不止这些，笔者在此不可能一一列举，只选取几个有特色软件加以介绍，供读者参考。 
|
||||||||||||||||
