运用Microsoft Help Workshop

    早期的Windows程序设计人员即使编译一个很小的工程文件也要学习很多东西，那时的工具很简陋，即使一个小程序也要编很多代码。那时是DOS的天下，但随着编译程序的改进，DOS已是昔日黄花；但编译帮助文件时还是要用到那些编译程序。实际上我也很反感用DOS程序来建立帮助文件，但是在最新版的Windows95/98编译程序出现以前也只能使用它。即使是第三方厂家专门开发的编译程序有时也要和晦涩的HC31命令行程序打交道，它们在编译过程的可视性方面并没有实质性的改进。
    注释 本节专门讨论了Windows帮助文件 ，如果关心HTML帮助文件的建立技术，请阅读后续章节。
    在引入了Microsoft Help Workshop之后，编译过程有了全面的改观。再也不用依赖于基于DOS的编译程序了，Microsoft Help Workshop在Windows环境下建立并编译帮助工程文件（帮助make文件的另一种叫法）。图15.3是Microsoft Help Workshop典型的显示示例。

    注释 即使使用Microsoft Help Workshop，也还是需要一个生成RTF文件的编辑器。我不知道Microsoft为什么没有改进这一方面，事实就是如此。我还是用Microsoft Word建立RTF文件，在使用MicrosoftHelp Workshop建立帮助文件时，所用的make文件指向这些文件。
    我们看看这个工具如何降低建立过程的复杂性，所建的make文件如程序列表15.2所示（假定已经建立了包含帮助脚本的RTF文件）。第一步是建立一个新的工程文件，用File|New命令实现，系统会显示如下图所示的对话框：

    选择Help Project后，按OK完成。如图15.3所示，已经建成了一个新的帮助工程文件，它初始为一个空白文件，由你填入帮助文件的特性。
    警告 用Microsoft Help Workshop建立的文件与用DOS编译程序建立的文件互不兼容，必须预先做好决定：新的Microsoft Help Workshop对开发者更好用，但只限于32位的操作系统环境；如果还需要对Windows 3.x向下兼容，就只好用DOS编译程序了。
    定义工程的各种选项
    当开始使用一个新的工程文件时，总要先定义一些选项。例如：至少要知道调用帮助文件的目的，要加进哪些版权信息。我一般以内容主题为主目录，所以把它加在帮助文件的开头位置是适宜的。点击Options按钮，系统就会显示Options对话框：

    注意此时已经定义了一些基本选项，这些选项的含义类似于前面章节中make文件描述的内容（你会看到Compression属性页上的选项相当熟悉，它们也是用来压缩帮助文件大小的）。此时，有些人会觉得这个工具并没有什么优越性，特别是当他们的盘上有很多预定义文件时。要指出的是这个对话框使你只需填填表，而不用再一条一条地完成语句。

    Options对话框的“Files”属性页如下图所示：

    你会注意到它的许多选项我们以前都介绍过，修改Help File域可以给帮助文件改名，一般帮助编译器用工程文件名作为帮助文件名的基础；Log File域包含了记录文件的文件名，所幸的是这一项在新的帮助编译器中已不是必需的了。我还是用它来记录编译过程，但现在这是可做可不做的事情。
    在此属性页上的最重要的域是RTF文件清单框，当前帮助文件的工程文件所含的文件都列在这里，点击“Change”按钮显示“Topic Files”对话框，如下图所示：

    从这里可以增加或删除工程文件中FILES小节所列出的主题文件。注意此对话框中的两个复选框，它们很重要，因为它们控制着帮助编译器如何响应RTF文件。第一个选项允许编译器在下一次编译时自动执行对RTF所做的更改，如果未选中该项，编译器就会忽略所做的改动。第二个选项对使用双字节字符集（DBCS）的帮助文件非常重要，它改变了帮助编译器的工作方式，从而保留了特殊字符（该特征主要用于特殊的语言，比如中文等）。
    技巧 进入“Topic Files”对话框的另一途径是单击主窗口的“files”按钮。
    在“Options”菜单的“Files”属性页还有其它一些选项，其中之一就是“ContentsFile”域，如果是新建一个工程文件，Help Workshop在建立内容页时就会自动地填充该项。选中该选项的原因是已经有了一个内容页又想用于当前的工程文件中。当帮助文件超过8MB时要用到TMP Folder选项，它给出了Help Workshop编译时建立临时文件的目录，一般情况下用不到，只是当缺省目录的磁盘空间不足时才用到。最后一个域是“Substitute Path Prefix”，当移动了某些文件又不想改变工程文件中的路径信息时要用到。
    Windows 95/98的帮助文件提供了一些以前没有的功能：全文查找。当选中“帮助主题”对话框的“查找”页就会建立这个数据库，实现对全文的逐字查找。编译过程中“选项”对话框的FTS页中有一个选项用于生成这个文件，由于Windows 95/98总是要生成它，一般都不用选中。编译器建立的GID文件要在发行盘上占用很多空间并增加了编译时间。
    下面有必要学习一下“Macros”属性页，其图像如下图所示：

    从这里定义关键字宏供全文使用。而且当用户查找某一主题时，这些宏会出现在帮助主题对话框的索引页中。
  &nbs

[1] [2] [3] 下一页