htmlhelp制作教程.doc

htmlhelp帮助文件介绍(一) Windows 联机帮助系统的新标准HtmlHelp 作 者 : 冯惠军 纵观 Windows 应用开发程序， 联机帮助系统是应用软件的重要组成部分，为应用软件的使用提供了极大的方便和帮助。过去微软的联机帮助系统一直采用的是 WinHelp 标准（一种基于 RTF 格式的联机帮助系统）。随着 Windows98 操作系统的发布，微软公司对联机帮助系统作了较大的改变，用 HtmlHelp 格式取代了过去一直采用的 Winhelp 格式，并且在所有应用程序的新版本中，包括 Office2000 ， Visual Studio 6.0 及 Money99 中都采用了这种新的联机帮助格式。 事实上微软已经决定将 HtmlHelp 作为基于 Windows 的应用程序联机帮助系统的新标准，尽管微软在短期内将继续支持 WinHelp 标准，但在新版本的 Windows 操作系统及应用程序中将支持 HtmlHelp 标准。 一、 HtmlHelp 的优点 1. HtmlHelp 帮助系统采用统一的窗口，改变了 WinHelp 帮助系统目录窗口和内容窗口分离的情况，其左侧包括目录、主题索引、查询和主题捷径（ Favorites ）四个可相互切换的窗格；右侧显示主题文档的内容；工具栏则采用浏览器的导航格式。这种布局可使用户随意选择目录主题进行浏览，而且随时可以知道正在阅读文档的哪一部分。 2. HtmlHelp 标准是一种非常容易而且方便的创建联机帮助系统及相应的 Web 站点的方式，比建立 WinHelp 帮助系统要容易地多。它不仅提供了传统的 WinHelp 联机帮助系统的许多特征，包括超文本连接（“ Alink ”和“ Klink ”）、目录表、索引和全文检索，同时又集成了 HTML 的特征和微软的 ActiveX 技术。 3. HtmlHelp 充分利用 Html 文档的多媒体表现力，因此联机帮助文档的内容不再局限于文字和静态图像，在其中可以插入 GIF 动画、声音文件、影像以及其它格式的多媒体内容，使帮助文档所表现的内容更加丰富多彩。通过插入 URL 地址，可直接与互连网络联系在一起。 4. HtmlHelp 对帮助系统的格式也提供了更多的控制。不像 WinHelp 只能定义一种格式页， HtmlHelp 可以使用 HTML 的层叠格式页面（ CSS ）定义，而且通过联接和嵌入允许使用多种格式页，可以对帮助系统的格式进行整体的或局部的控制，使整个帮助系统的风格一致。 5. HtmlHelp 支持 ActiveX 技术， Java Applets 以及脚本语言（如 JavaScript 和 VBScript ）可以对帮助系统的内容提供更多的控制，如提供“相关主题”超级联接为用户获得其它有用的相关信息提供方便，弹出式文本框用于内嵌的术语定义或过程的详细说明等等。 6. HtmlHelp 不仅可用于建立联机帮助系统 , 而且由于它固有的特点，能够更好地与企业网和互连网结合起来，对于企业发布联机信息也具有引人注目的优点。可用于制作企业网联机文档，如过程手册、培训指南、产品目录、参考资料等等，甚至还可以用于制作联机学习教程和电子图书杂志。通过 HtmlHelp 提供的丰富的查询和浏览特征，如动态目录、多层次索引、全文查询等，可以使企业员工能够更容易地查询和浏览文档内容。 7. HtmlHelp 文档采用单个经过编译的文件（文件的扩展名为 .chm) ，所有的帮助信息包括文本、声音、图像、影像等源文件全部压缩编译成一个文件，而且所占磁盘空间比原始文件要小的多，使得文档更易于通过 Email 、 FTP 或网络服务器进行传输和发布。 8. HtmlHelp 文档格式容易生成交叉平台联机帮助系统。 HtmlHelp 目前只支持 Windows 操作系统，但使用第三方提供的技术和组件，可以很用以的把 HtmlHelp 帮助系统转换成 Unix 或 Macintosh 等交叉平台帮助系统。 二、 HtmlHelp 的组成 微软公司为 HtmlHelp 提供了一整套解决方案，包括 HtmlHelp 运行组件、阅读器、创作工具和编译程序，以及一个 ActiveX 控件和一个 Java Applet 。 1. HtmlHelp 的运行组件 运行或阅读 HtmlHelp 帮助系统依赖于一些运行组件，它们必须安装到运行的计算机中，才能正确运行 HtmlHelp 帮助系统。主要包括以下四个组件： 组件名称说明Hhctrl.ocxHtmlHelp ActiveX 控件Itss.dll处理编译的 HtmlHelp 的动态联接库Itircl.dll用于全文搜索的动态联接库Hh.exeHtmlHelp 阅读器其中 HtmlHelp 阅读器使用微软 Internet Explorer 的基本组件来显示帮助内容，它支持 HTML 及其图形格式（包括 .gif 、 .jpg 和 .png 文件、 ActiveX 、 Java 和脚本语言（如 JavaScript 和 VBScript ），使用这个阅读器可以直接阅读（双击 .chm 文件 ) 文档的内容，如果在应用程序中调用 HtmlHelp 文档，也可以不用这个阅读器。也就是说 HtmlHelp 文档即可依附于应用程序作为联机帮助系统，也可以独立使用作为联机文档。 2. ActiveX 控件（ Hhctrl.ocx ） ActiveX 控件为 HtmlHelp 的功能提供支持，它具有许多支持特征，包括可展开的目录、关键字查询、弹出式窗口和文本框等等。它可用于支持编译的 HtmlHelp 帮助文件，也可用于支持 Web 站点未编译的 HTML 文件，可以把它插入 HTML 文件中提供某些高级特征。同时它还提供了一个 Windows 应用程序接口（ API ）函数 Htmlhelp ，可以在应用程序中调用。 3. Java Applet HtmlHelp Java Applet 是一个含有帮助系统浏览特征的控制程序，可以把它插入 HTML 文件中提供诸如目录、索引、相关主题等帮助系统的特征。它可用于任何支持 Java 的浏览器。 4. HtmlHelp Workshop HtmlHelp Workshop 是微软公司免费提供的一个 HtmlHelp 帮助文档创作工具，可在 /workshop/author/htmlhelp/download_main.asp 下载。 HtmlHelp Workshop 用一个项目文件（ .hhp ）管理组成帮助文档的所有文件，包括 HTML 文件、目录文件（ .hhc ）、索引文件（ .hhk ）以及图形、图像、声音等文件。它含有一个文本编辑器可用于编辑帮助主题的 HTML 源码，只是这个编辑器不是所见即所得方式。 HtmlHelp Workshop 还含有一个图像编辑器，它具有捕获屏幕图像、转换图像文件、图像编辑以及图像预览等功能，用于管理和编辑文档中的图形文件具有较强的功能。内嵌的编译器可把所有源文件压缩编译成一个 .chm 文件。同时它还提供一个反编译器，可以把 .chm 文件的所有源文件释放出来。另一个有用的功能就是它可以把现有的 WinHelp 项目文件及相关文件转换成 HtmlHelp 格式的项目文件。利用 HtmlHelp Workshop 制作 HtmlHelp 帮助系统非常简单，我们将在后续的文章中作介绍。 三、 HtmlHelp 的创作工具 前面我们介绍了微软公司的 HtmlHelp Workshop 的主要功能和基本特征，它的确提供了许多有用的功能，但遗憾的是它的编辑器不是所见即所得方式，许多工作要用手工来做，不过既然是免费提供的，当然还是可以使用的。 目前市场上已有由第三方开发的具有更强功能的 HtmlHelp 创作工具，价格自然也不低，下面我们简单介绍几个比较流行的创作工具。 1. ForeHelp ForeHelp 是由 ForeFront 公司（ / ）开发的所见即所得的帮助系统创作工具，它的开发环境采用与帮助系统类似的布局，使创作者随时可以观察到最终生成的帮助系统显示结果。它提供一种测试模式，可在编辑过程中，不必对正在编辑的帮助系统进行编译，即可检查文档内的超级连接来模拟最终帮助系统的运行情况。 ForeHelp 含有一个功能齐全的文本编辑工具，可直观方便的输入、编辑、格式化文本，可插入图形或多媒体文件，也可以导入由其它创作工具编辑的项目文件或 Word 文档。 ForeHelp 支持多种帮助格式所提供的特征，建立一个 ForeHelp 项目文件，可以生成多种格式的帮助系统，包括 WinHelp 、 HtmlHelp 、 Java Help 、 WindowsCE Help 、标准 HTML 文档，以及该公司提出的支持多种浏览器的帮助系统 InterHelp 。 2. DocToHelp DocToHelp 是由 WexTech 公司（ / ）开发的帮助系统创作工具，它集成了 Microsoft Word 作为它的编辑环境，对熟悉 Word 的创作者来说使用更为方便。它既可生成复杂的联机帮助系统，同时又可打印出高质量的书面文档，这也是该公司大力宣传的一个特征。 DocToHelp 提供了许多特征为创作联机帮助系统提供方便，许多工作系统都可自动完成，例如可自动建立主题浏览序列、自动生成目录表、根据关键字自动建立主题连接、自动建立弹出窗口定义、自动生成 WinHelp 、 HtmlHelp 以及 JavaHelp 项目文件等等。 利用 DocToHelp 提供的 HelpXtender ActiveX 控件，程序员可以容易地在应用程序中建立与 HTML 页面或 HtmlHelp 主题之间的连接，为制作上下文相关的联机帮助系统提供了方便。 DocToHelp 采用单一源文件技术，建立一个项目文件可生成多种格式帮助系统，包括 HtmlHelp 和支持 ActiveX 及 Java Applet 的基于浏览器的 HtmlHelp 、 WinHelp 、 Java Help 及标准 HTML 文档，并可以输出高质量的打印文档。 3. RoboHelp RoboHelp 是由 BlueSky 公司（ / ）开发的联机帮助文档和帮助系统创作工具，它采用所见即所得的直观编辑方式，系统自动管理帮助系统的创作过程，只要点击鼠标，按照屏幕提示输入需要的文本或图形，即可完成制作过程。 RoboHelp 支持多种应用开发环境，包括 Visual Basic 、 Visual C+ 、 Visual Foxpro 、 Delphi 、 PowerBuilder 等等，能过容易地为应用程序建立联机帮助系统。 RoboHelp 可生成多种格式的联机帮助系统，包括 WinHelp 、 HtmlHelp 、 Java Help 、 WindowsCE Help 、以及该公司提出的交叉平台帮助系统 WebHelp 。 RoboHelp 提供了 15 个创作辅助工具，包括图形和多媒体工具、文件格式转换工具、项目文件查错工具、快速查找工具等，为文档编辑提供了极大的方便。 以上介绍的三种帮助系统工具都提供了强大的功能，其共同特点是提供所见即所得的创作环境，支持多种应用开发环境，可生成多种格式的联机帮助系统等等，所提供的辅助工具各有其侧重及特点，对建立大型的联机帮助系统可以加快创作过程，不过使用也比较复杂。 ForeHelp 和 DocToHelp 都提供试用版，可在其公司网址下载，由兴趣的读者不妨一试。 htmlhelp帮助文件制作(二) HtmlHelp Workshop 的结构 标准的 HtmlHelp 帮助文件显示窗口是一个分成三部分（ Tri-Pane ）的窗口，上面是工具条；左侧是浏览窗格，包含目录、索引、搜索等选项卡；右侧显示相应的主题内容，如下图所示。 微软公司也提供了一个 HtmlHelp 帮助文档创作工具 HtmlHelp Workshop ，可在 /workshop/author/htmlhelp/download_main.asp 免费下载。利用 HtmlHelp Workshop 制作简单的具有目录表、索引和查询功能的 HtmlHelp 帮助文档非常容易。但是要实现更高级的特征如“相关主题按钮”，“弹出式文本框”，“上下文相关”等功能，就需要手工插入 ActiveX 代码。本文从简单的功能入手，相信读完本文你就可以制作比较专业的 HtmlHelp 联机帮助系统了。 一、 HtmlHelp Workshop 的结构 HtmlHelp 帮助系统是基于大量的 HTML 文件及相关的图形、图像等文件，它最小的文件单位是主题文件，每个主题文件都表示帮助系统中的一个主题，主题文件是一个纯 HTML 文件，可包含图形、图像、超级连接等。 HtmlHelp Workshop 实际上就是一个对构成 HtmlHelp 帮助系统的所有源文件进行管理的工具，你可以在 HtmlHelp Workshop 中创建目录、索引、建立主题和目录之间的超级连接。 在准备制作 HtmlHelp 帮助系统时，应当仔细规划文档所要表达的主题，设计目录结构，也就是说，要把所有帮助信息划分为主题，然后把每个主题文件制作为 HTML 文件，主题文件可大可小，大的话可包含类似书籍中一章的内容，小的话可能只含有几行文字。 目前支持所见即所得的 HTML 工具有很多，如 FrontPage 、 HomeSite 、 Hotdog 、 HomePage 等等，可以先用这些工具把所有主题的 HTML 文件制作好，需要的页面之间的超级连接以及 URL 地址也都设置好。然后再用 HtmlHelp Workshop 把这些文件组织起来，编译成 HtmlHelp 帮助系统。 HtmlHelp Workshop 包含的文件类型主要有以下几种： （ 1 ）主题的 HTML 文件：它包含每个主题的内容及相应的图形、图像、超级连接等。 （ 2 ）图形和多媒体文件：这些文件可包含在 HTML 文件中，包括图像文件（ .gif 、 .jpg) 、声音文件（ .wav 、 .midi ）、影像文件（ .mpeg 、 .avi ）等。 （ 3 ）项目文件（ .hhp ）： HtmlHelp Workshop 的项目文件用于管理组成帮助文档的所有文件，它包含了帮助系统中所有源文件的名字和位置，以及其它有关帮助系统定义和选项的设置信息。 （ 4 ）目录文件（ .hhc ）：目录文件定义显示在帮助系统左侧目录窗格中的内容和结构。它的内容和结构与普通书籍中的章节目录类似。目录文件包含两种类型的条目：标题和主题页。标题类似于书籍中章的概念，它可以与一个主题文件相连接，也可以不与任何主题文件相连。主题页表示具体的主题内容，它必须与一个主题文件或 URL 地址相连接。每个标题下面是相应的主题页，你可以定义多层次的目录结构。当运行编译的 HtmlHelp 文件时，点击目录框中的主题条目，相应的内容将显示在右侧窗格中。 （ 5 ）索引文件（ .hhk ）：索引文件定义帮助文档的索引和关键字，它将显示在帮助系统的索引窗格中。每个关键字必须至少与一个主题文件或互连网络地址 (URL) 连接。关键字可以与多个主题文件或 URL 地址连接，当双击该关键字时，帮助系统会弹出一个窗口，显示所有与该关键字相连接的主题，可以从中选择一个主题，主题的内容将显示在右侧窗格中。 HtmlHelp帮助文件制作(三) 建立项目文件 (1) 作 者 : 冯惠军 运行 HtmlHelp Workshop 选择 File/New ，系统显示新建文件对话框，如下图所示。 你可以选择建立五种类型的文件，分别为“项目文件”、“文本文件”、“ HTML 文件文件”、“目录文件”和“索引文件”。首先选择新建“项目文件” （ 1 ）新建项目向导 当选择新建项目文件时，系统会显示新建项目向导，询问是建立一个新项目还是转换现有的 WinHelp 项目，如下图所示。 如果要建立一个新项目，不要选择转换现有的 WinHelp 项目，点击下一步，然后按照系统提示输入项目文件名及路径。我们以本文为例建立本文的 HtmlHelp 文件，项目文件取名为 how_to_use.hhp ，如图所示。 单击下一步，系统会询问是否将现有的目录文件、索引文件或主题文件加到项目中，如果是就要指出这些文件的名字及路径，系统就会把这些文件加到项目中；如果不加，系统将生成一个项目文件，而不包括这些文件。如图所示。 这个选项也很有用，如果已经建立好了帮助系统的 HTML 文件此时可以加到项目中来。我们现在不佳，单击下一步，完成新项目文件的建立。 如果要转换现有的 WinHelp 项目，在新建项目向导中，选择转换 WinHelp 项目选项，然后输入要转换的 WinHelp 项目文件及路径和新的 HtmlHelp 项目文件及路径，如图所示。 新建项目向导就会把 WinHelp 项目转换为 HtmlHelp 项目，文件格式的转换如下表所示。 文件类型 WinHelp 项目 HtmlHelp 项目 项目文件 .hpj.hhp主题文件 .rtf.htm目录文件 .cnt.hhc索引文件 WinHelp 索引 .hhk图形文件 .bmp 或 .wmf.gif 或 .jpgHtmlHelp帮助文件制作(四) 建立项目文件 (2) 作 者 : 冯惠军 （ 2 ）修改项目文件设置 当创建一个新项目时 , 系统会自动加上必要的项目文件设置，如图所示，这些设置都可以在项目选项对话框中修改。 从上图我们可以看到 HtmlHelp Workshop 开发环境的布局，除了菜单和工具条外，整个工作区域分为两部分，左侧友三个选项卡，包含了对项目文件、目录文件和索引文件的设置和编辑；右侧将显示一个文本编辑窗口，可用于编辑文本文件、 HTML 文件和显示编译信息。每个选项卡的左侧显示可用的工具按钮，右侧显示其内容。 项目文件选项卡包含的工具含义如下： 单击改变项目文件选项，弹出项目文件选项设置窗口。 一般选项包括： Title ，描述帮助系统的标题，它将显示在帮助系统的标题栏中； Default File ，是指定帮助系统运行时所要显示的默认主题文件； Default window ，指定帮助系统显示在哪个窗口中，窗口名及属性设置是在增加 / 修改窗口选项中定义的。如果不定义窗口，帮助系统会显示在系统默认的窗口中。 文件选项卡描述编译的帮助文件、目录文件和索引文件，如果在 HtmlHelp Workshop 中创建目录文件和索引文件，这些文件会自动加到相应的位置。注意目录文件能够在编译时自动生成，但是这样生成的目录文件还需要修改才可使用。 编译选项卡设置文件编译的有关信息，如显示编译过程、支持增强反编译等，如下图所示。合并文件选项卡目前使用不到。Htmlhelp帮助文件制作(五) 建立项目文件 (3) 作 者 : 冯惠军 （ 3 ）增加 / 删除主题文件 单击增加 / 删除主题文件，弹出增加 / 删除主题文件窗口，当前项目文件中所包含的所有主题文件会显示在主题文件窗口中，你可以增加新的主题文件或删除已有的主题，如下图所示。 （ 4 ）增加 / 修改窗口定义 三、建立目录文件 （ 1 ）设置目录特性 （ 2 ）目录工具按钮 四、建立索引文件 （ 1 ）设置索引特性 （ 2 ）索引工具按钮 五、编译运行帮助文件 编辑HTML文档的利器Htmlhelp Workshop如果你已经装了Windows 98，一定会发现它的帮助文档和以前已经完全两样了。它采用新一代基于Html文件格式的帮助文档。Html帮助文档是一个统一的窗口，改变了原有帮助文档目录窗口和文档内容窗口分离的情况，左侧是目录、词汇表和查询这三个功能项，通过常见的标签栏切换。右侧是Html文档的显示部分，上部的工具栏就和浏览器一模一样。当然这是通常的形式。由于Html文件具有一定的多媒体表现力，因此Html帮助文档的内容不再局限于文字和静态图像，在其中可以插入GIF动画，也可以利用浏览器的插件在文档中播放声音文件、动画影片、或其它格式的多媒体内容，使帮助文档所表现的内容更加丰富多彩。当然，加入URL地址更是Html文件的独到功能，这样的帮助文档内容就不局限于包装好的文档内容了，可与因特网联系在一起。帮助文档从结构上来看可分为两个部分，运行器和文档内容。运行器是操作系统的一部分，而文档内容随其所附的应用程序而变化。这与以前的Winhelp的结构没有多少差别。不过运行器部分有了较大的改进，运行器很小巧并且不直接运行Html文档，而是操作一个Active X的组件，从而控制支持Active X组件的网页浏览器，如微软的Explorer 3.0以上版本的浏览器。它的一个好处是能使帮助文档跨平台运行，只要有不同平台上的运行器和浏览器，帮助文档不再需要重新编制。制作Html帮助文档的工具是微软公司的Htmlhelp Workshop工具包，目前在微软的主页上提供最新的1.2版（/workshop/author/Htmlhelp/）。这是英文版的，不过没有关系，帮助文档运行文件有简体中文版，并且运行的界面是根据用户使用的操作系统，与Workshop的语言版本没有关系。Html帮助文档的核心是充分利用Html文件的表现能力，对分散的Html文件作整体的包装，这是目前在Web网页以外利用Html文件的一个趋势。如果你用这个方式制作学习教程和电子图书杂志，或为用户提供产品目录和宣传公司的产品，比已经流行的PDF文件更简洁和方便。这么