使用HtmlHelp Workshop创建工程


图2 新建工程

　　启动HtmlHelp Workshop后通过File菜单下的New菜单项将弹出图2所示的对话框。列表框中给出了要建立的文件类型，分别为工程文件、文本文件、HTML文件、目录文件和索引文件。这里选取Project，以建立一个工程文件。系统将会显示如图3所示的新建工程向导，并询问是否需要转换现有的WinHelp工程。这里直接点击"下一步"以新建一个工程，向导将进入到图4所示的对话框以指定要建立的工程文件。建立的工程文件以hhp为后缀，用于管理组成帮助文档的所有文件，它包含了帮助系统中所有源文件的名字和位置以及其它有关帮助系统定义和选项的设置信息。


图3 新建工程向导


图4 创建工程文件


图5 引入已存在的文件

　　向导的下一步如图5所示，询问是否将现有的目录文件（.hhc）、索引文件（.hhk）或主题文件（.htm）添加到工程。如果选中某种文件就要指出这些文件的名字及存放路径。如果不添加，也可以在建立了工程后再行添加。最后，在图6所示的对话框结束向导并创建一个新的工程。向导将自动加上必要的工程文件设置（如图7所示），这些设置都可以在项目选项对话框中修改。左侧这三个选项卡分别用来对工程文件、目录文件和索引文件进行设置和编辑，在每个选项卡的左侧均列有与之相关的工具按钮。


图6 完成向导


图7 项目选项对话框

　　点击改变工程选项按钮，将弹出如图8所示的工程选项设置对话框。General选项卡将可以设置帮助系统的标题（Title编辑框）、在运行时显示的默认主题文件（Default File编辑框）以及将要显示在哪个窗口（Default window编辑框）。Files选项卡（如图9所示）主要用来描述编译的帮助文件、目录文件和索引文件。如果在HtmlHelp Workshop中创建了目录文件和索引文件，那么这些文件将会自动添加到相应的位置。其中目录文件能够在编译时自动生成，但需要经过修改才能够使用。Compiler选项卡（如图10所示）用于设置与文件编译相关的信息，如显示编译过程、支持增强反编译等。Merge Files选项卡则只是提供了对文件合并的设置。


图8 工程选项设置对话框


图9 文件选项卡


图10 编译选项卡


图11 窗口类型设置对话框

　　点击添加/修改窗口定义按钮将弹出如图11所示的配置对话框，通过该对话框提供的7个选项卡将可以定义CHM帮助文件的窗口显示风格。General选项卡定义了窗口名和窗口标题。也可以增加新的窗口或删除已有的窗口定义。Buttons选项卡负责定制将要显示在帮助文件工具条上的按钮。Position选项卡对窗口大小和位置进行定制，可以直接输入定制数值，也可以使用Autosizer按钮启动一个用来设置窗口位置和大小的对话框，并通过拖动此对话框窗口来完成上述定制。

　　Files选项卡通过TOC、Index、Default、Home、Jump1和Jump2等项定义了帮助窗口的目录文件名、索引文件名、默认显示的文件名、主页文件名以及跳转页文件名。Navigation Pane选项卡对左侧浏览窗口的特性进行了定制，主要包括以下几个方面的设置：窗口是否包含浏览窗格、主题窗格和按钮条；浏览窗格的宽度；是否自动显示/隐藏浏览窗格；显示时默认的浏览选项卡（Default tab选项）；是否包含搜索（高级搜索）选项卡（Advanced选项）和书签选项卡（Favorites tab选项）等。 最后两个选项卡Styles和Extended Styles用于设置窗口的风格和扩展风格。

　　在这两个选项卡中可以指定窗口是否包含最大化、最小化按钮，是否有边界，是否包含水平和垂直滚动条，是不是弹出式窗口或工具窗口等等。 总之，图11所示的配置对话框定制了帮助窗口的所有外部显示特性。

图12 主题文件的添加

　　点击增加/删除主题文件按钮，将弹出如图A1-12所示的增加/删除主题文件窗口。通过该窗口上的Add按钮将可以向工程添加有关帮助实质性内容的各主题文件。在Topic files列表框中显示了当前包含的所有主题文件，也可以通过Remove按钮从中删除已有的主题文件。