本文发表于《电脑》2000年第3期
-------------------------------------------------------------------------------- 制作HTML格式的Help文件王昌达    不知你是否注意到,Visual Studio 6.0和Windows 98的帮助文件风格,和以前的版本大不一样,这种被微软称为下一代的在线帮助(next-generation online help)形式,是一种编译过的HTML文件,后缀是.CHM。它不仅制作容易,而且支持超文本的全部语法特征,换句话说,只要是你能在主页上制作出来的效果,几乎都可以在这种形式的帮助文件中体现出来。想当年,自己为发表在《电脑报配套光盘》上的共享软件写帮助时,需先用Word写出具有脚本形式的RTF文档,然后再用Visual C++ 5.0附带的Help Workshop编译,我晕……。    制作这种形式的帮助文件,需要使用Microsoft HTML Help Workshop编译你已经写好的超文本文件,它就附带在Visual Studio 6.0第一张光盘的Htmlhelp目录下。当你按着提示完成安装后,别忘了察看安装目录下的redist文件夹中是否有一个名叫hhupd.exe的文件,它是用来给HTML Help Workshop升级的,如果有,就执行它升级你的HTML Help Workshop;没有,也能凑合着用了。下面就请你跟我一步一步学做HTML格式的帮助文件吧。1、建立工程文件        工程文件是项目的管理文件,它用来保存你的工作环境及相关设置。启动HTML Help Workshop,用鼠标点工具条上的“New”按钮,在弹出的对话框中选“Project”,单击“OK”,其后的工作我们将在向导的带领下完成。    向导的首页告诉我们,它可以将用于制作老式帮助文档的文件(后缀为.RTF、.CNT等),统统转换成新式的HTML Help Workshop所使用的文件格式,如果你需要这样的转换,就选中“Convert WinHelp Project”前的复选框,否则进入下一步,指定需要制作帮助文档的工程文件的名称和位置。完成上述工作,向导询问你是否有后缀为.hhc(HTML格式帮助文档的目录文件)、.hhk(HTML格式帮助文档的索引文件)和.htm文件需要添加进当前的工程,作为一个新建的工程文件,这些可以统统不必理会,我们直接进下一步,完成新建工程的工作,并见到图1所示的界面。2、添加超文本文件    在图1所示的界面中,用鼠标点“Add/Remove topic files”,出现图2所示的界面,用“Add” 向当前的工程中添加已经编辑好的HTML文件;用“Remove”将不需要的HTML文件从当前工程中删除。    上述工作完成后,若是用鼠标点击图1中的“Save all project files and compile”按钮对当前工程保存并进行编译的话,即可生成一个后缀是.CHM的帮助文件,此时,可以通过工具条上的“View complied file”查看文件编译后的效果。尽管已加入的HTML文件能看到了,但令人遗憾的是这个帮助文件既没有目录,也没有索引,是个丑小鸭。3、制作帮助文件的目录    如图3所示,一个完整的帮文件应该有目录、索引和搜索功能。在图1所示界面的选项卡中,切换到“Content”,在随即弹出的对话框中选“Create a new contents file”,然后指定一个文件名,将目录管理文件保存,露出图4所示界面。在左侧的工具条中,点“Insert a heading”,向当前的工程中插入一个主题,给它起上一个恰当的名字后,就可以将属于这个主题的HTML文件,用“Insert a page”依次插入到当前的主题下。用工具条上的“↑”、“↓”两个按钮可以调整各个页面在主题下出现的次序,“←”、“→”两个按钮可以调整目录的层次结构。4、制作帮助文件的索引    使用索引的目的是,能通过关键词迅速定位到需要的文章。在图1所示界面的选项卡中,切换到“Index”,在随即弹出的对话框中选“Create a new index file”,然后指定一个文件名,将索引管理文件保存,露出创建索引文件的工作界面。在左侧的工具条上用的“Insert a keyword”插入事先选定的关键词,并且要指定它与工程中的哪个HTML文件相连,以便将来用户能通过该关键词迅速定位到这个文件,找他所需要的内容。关键词可以一个一个地插入,也可以一组一组地插入。    制作索引文件的工作界面与图4基本一致,工具条按钮也大致对应相同,但是多了对关键词排序和察看超文本的源文件这两项功能。5、制作帮助文件的搜索    这里搜索是指按字符串的匹配形式,在工程中已包含的HTML文件中查找出相等的值,并突出显示出来。Word、IE都有类似的功能,相信大家不会太陌生吧。让帮助文件具有搜索功能,需要切换回“Project”项(图1),点左侧工具条上的“Change project options”,在随即弹出的“Options”对话框的“Compiler”项下,选中“Compile full-text search information”前的复选框,然后编译。用“View complied file”看看效果吧,怎么样,有没有高兴得跳起来。这时,在您保存工程文件的目录下,已经有一个后缀是.CHM的文件静静地躺在那里了,这个文件在Windows环境下是可以独立运行的。    至此,你已经能够为软件制作具有强大超媒体功能的帮助文件了。干吗不试试将你在Internet上搜集来的大量网页资料,用上述方法编译后存放呢?不仅仅是只有一个文件、随身携带方便,更有索引与查找功能,是一本真正的电子图书。再看看微软的MSDN吧,还不就是这种风格!    最后需要告诉大家,文中提及的每一步均可以单独编译,察看效果。但在做第五步之前,最好先将前四步的效果都搞满意了以后才进行。因为,在帮助文件中包含查找信息后,编译的速度会大大下降,让人不堪忍受。    限于篇幅,无法为您细细讲解HTML Help Workshop的强大功能,希望本文能带您入门。更多的信息可到http://icai.uhome.net访问,或用[email protected]与我探讨。