2024年4月7日发(作者：)

HTML Help Workshop 使用教程

一、创建项目文件

单击Htmlh elp Workshop菜单或工具栏中的“New（新建）”命 令，

这时出现“选择新建内容”的对话框。这里有五个选项：“Pr oject

（项目）”、“Text（文本）”、“HTML Fi le（HTML文件）”、

“Table of Contents （目录）”、“Index（索引）”。选择“Project

（项 目）”，接着出现“Project（项目）”向导，告诉你这个向 导

可以转换的文件格式，一般情况下我们是要创建项目（.hhp） 文件，

不需要转换。直接进入“下一步”指定放置的目录和输入文件 名就

可以了，单击“下一步”，进入了“现有文件”对话框，如果你 想

将已经存在的文件包含进“项目”里，在下面列表中选择。这里一 般

空着，这些文件（包括已经编辑好的主题文件）以后可以添加。进 入

“下一步”后再“确定”就进入了Htmlhelp Works hop工作窗口。

在窗口的上方是3个选项卡，分别是“Proje ct（项目）”、“Contents

（目录）”、“Index（ 索引）”。在“项目”窗口的左侧是7个按

钮，它们的功能名称自上 而下分别是：“Change project options

（ 改变项目选项）”、“Add/Remove topic fil es（添加/删除主

题文件）”、“Add/Modify win dow definitions（添加/修改窗口

定义）”、“H tmlHelp API information（HTML帮助 API信息）”、

“View HTML source（校验HT ML源文件）”、“Save Project Contents

and Index files（保存项目、目录和索引文件） ”、“Save all file

and Compile（保 存全部文件并编译）”。

单击“Ch ange project options（改变项目选项）”按 钮，出现

“Options（选项）”对话框，光标在“Gener al（常规）”选项卡

的“Title（标题）”文本框内闪烁，在 这里加入标题，编译后这个

标题将出现在chm文件窗口的标题栏中 。其它的内容暂时用系统的

默认值。然后单击“Add/Remov e topic files（添加/删除主题文

件）”按钮，再选 择“Add（添加）”按钮，把作为封面页的HTML

文件添上。封 面页的文件一定要有，否则编译的帮助文件运行后，

系统会报错。好 了，简单的“项目”编辑就完成了。

二、创建目录文件

单击“Cont ents（目录）”选项卡，这时系统弹出一个对话框，

提示你“项 目”还没有关联目录文件（.hhc），你可以创建一个新的

目录文 件，或者指定一个现有的。这里选择“Create a new contents

file（创建一个新目录文件）”，进入下一 步请你选定一个新目录

文件的名称和存放路径，指定后出现目录编辑 窗口。在目录窗口的

左侧有11个按钮，前5个分别是：“Cont ents properties（目录

工具）”、“Insert a heading（插入标题）”、“Insert a pa ge

（插入页面）”、“Edit selection（编辑选择 ）”、“Delete

selection（删除选择）”，中间 4个箭头用来调整指定标题或页面

的位置，最后两个已在项目编辑窗 口中出现过。根据需要插入标题

或页面目录，按下“Insert a heading（插入标题）”或“Insert a

pag e（插入页面）”按钮，都会弹出“Table of Conte nts Entry

（目录条目）”对话框，在“Entry ti tle（条目标题）”文本框中

输入条目的标题，并根据情况选定对 应的主题（HTML文件），单击

“Entry title（条目 标题）”下的“Add（添加）”按钮，在弹出

的对话框的下面“F ile or URL（文件或URL地址）”文本框中输入

文件名 或URL地址并确定；单击“Advanced（高级）”选项卡， 在

“Image index（图像索引）”栏中为条目指定图标， 比如包含其它

条目的条目可以用书形图标，而页面条目的可以用问号 图标。如果

在单击“Insert a page（插入页面）”按 钮之前所选择的条目不包

含别的条目，也不被别的条目所包含，那么 会询问“是否要创建一

个起始条目”，选择了“是”会增加起始条目 （一级条目），选择了

“否”会增加一个子条目。标题可以不添加主 题文件或URL地址，

也可放置需要的主题文件，作为标题的说明内 容。标题可以分为多

级，要按照制作的内容统一考虑。如果觉得不满 意，可以用左侧的

箭头进行调整，也可以选定该条目，单击鼠标右键 ，不但可以调整，

还可以插入标题、主题或目录文件。编辑目录文件 是制作chm文件

最关键的工作，目录文件应该包含一个chm文件 所有目录（主题），

而每个目录又包含条目标题（名称）和该条目的 主题文件，要避免

条目标题与对应的主题不一致的情况出现。等所有 目录都添加好后

目录就算完成了。

完 成目录编制后，一个chm文件已具备了雏形，索引的内容暂时

空着 。保存项目文件和目录文件后就可以编译，编译就是把所有用

到的H TML文件统统压缩后包装在一起，形成一个后缀名是.chm的

文 件。在主工具栏按钮中可以找到编译按钮和试运行按钮，也可直

接按 项目窗口左下方的“Save all file and Com pile（保存全部

文件并编译）”按钮进行编译。编译后再运行就 可以看到作品的面

貌了。目录的内容在编译后显示在chm文件窗口 的左侧，可以展开

标题后显示以下的目录，单击目录可以打开相应的 主题文件，显示

相应的内容。如果发现问题，还可以进行修改调整。

三、创建索引文件

在Htmlhelp Workshop的工作窗口上 单击“Index（索引）”选项

卡，和创建目录文件一样，也会弹 出一个对话框，操作也是一样的。

进入索引编辑窗口，左侧也有11 个按钮，有8个是已经熟悉的，还

有3个分别是：“Index p roperties（索引工具）”、“Insert a key

word（插入关键字）”、“Sort keywords al phabetically（排序

关键字）”。所谓关键字是用户可 能用到的并与一个或多个帮助主

题文件关联在一起的字、词或短语， 索引文件（.hhk）也是一个HTML

文件，它包含若干个关键字 ，当用户打开chm文件后，单击索引标

签并输入一个关键字后，c hm文件将显示与这个关键字有关的主题

的列表，非常方便地找到相 关主题。单击“Insert a keyword（插

入关键字） ”按钮，出现一个与“Table of Contents En try”对

话框十分相似的“Index Entry（索引项）” 对话框，在“General

（常规）”选项卡的“Keyword （关键字）”文本框中输入关键字，

单击“Add（添加）”按钮指 定与该关键字相关联的主题文件。如果

想跳转到另一个关键字，在“ Index Entry（索引项）”对话框中按

“Advance （高级）”选项卡，选中下面的“Destination is Another

Keyword（目的地是另一个关键字）”，单 击“General（常规）”

选项卡，单击“Add（添加）”按 钮，在“File or URL（文件或URL

地址）”框中输入 要跳转的关键字，单击“OK”。

四、创建搜索

chm文件的“Sea rch（搜索）”选项卡允许用户在所有主题文件

中搜索字、词或短 语，将它们的标题显示出来，而且在主题中用醒

目的方式来显示。打 开一个项目文件，单击“Project（项目）”选

项卡的“Ch ange project options（改变项目选项）”， 在“Options

（选项）”对话框的“Compiler（编译 ）”选项卡中选中“Compile

Full Text Sea rch Information（编译全文搜索信息）”即可。< br>