Windows 版 (精华区)

发信人: opengl (醍醐灌顶), 信区: Windows
标  题: Html Help
发信站: 哈工大紫丁香 (2001年04月12日10:18:43 星期四), 站内信件

                 创建并管理一个帮助网站
Microsoft HTML Help Workshop（以下简称Workshop）是Microsoft公司发布的一个开发
HTML帮助系统的集成环境。HTML帮助系统是Windows 98所采用的帮助系统，它支持Acti
veX、Java及多媒体等技术。使用Workshop可以简单、方便、快速地开发HTML帮助系统。

因为HTML是一种支持网络的超级文本语言，所以HTML帮助系统既可以是HTML帮助文件，
也可以是网络上的帮助网站。所谓帮助网站是指网络上的某个站点的内容是帮助信息。
帮助网站应具有帮助文件的大部分特征，实际上帮助网站和帮助文件的区别主要有两点
：
1.帮助文件是Workshop将帮助文件需要的所有文件编译而成的一个单个的CHM文件，而帮
助网站不需进行编译。
2.帮助文件发布在磁盘或CD上，而帮助网站发布在网络上。
一、帮助的主要组成部分和主要特征
帮助的主要组成部分和主要特征如图1所示。
1.目录（cont ent）：包含若干的条目（图1中带图标的文字），条目分为不同的级别，
级别高的叫“heading（头）”（图1中带书的图标），级别低的叫“page（页）”（图
1中带问号的图标）。页条目链接着帮助主题，当用户选择并单击一个页条目时，与该条
目相链的帮助主题将显示出来。
2.索引（Index）：包含若干的关键字，当用户选择并单击其中一个关键字时，帮助将显
示该关键字所链接的帮助主题的内容（当只链接一个主题文件时）或帮助主题的标题的
列表（当链接多个主题文件时）。关键字也分为不同的级别。
3.帮助主题（help topic）：若干的HTML文件，它们包含帮助的具体内容。
4.帮助主题中的弹出式窗口（pop-up windows）：当用户单击帮助主题中的某个链接时
弹出在帮助主题之上的窗口。该窗口能根据自己所包含的文字和图像的尺寸来自动调整
窗口大小并且将一直保持在屏幕之上供用户阅读，除非用户进行任何别的操作。
5.帮助主题中的相关主题（Related Topics）：相关主题是某个主题文件中的一个链接
，它能显示预先定义的与该主题文件相关的主题文件的标题的列表。
以下三个特征在图1中没有包括。
6.帮助主题中的快捷方式（ShortCut）：使用快捷方式可以从主题中运行可执行程序或
打开对话框。
7.帮助主题中的正文链接（Text Link）：正文链接是一个“热点”，它包括提示文字，
一般为蓝色，带下划线，可以从此处跳转至其他位置，如：硬盘或局域网上的文件、In
ternet 地址、书签或幻灯片。
8.帮助主题中的书签（bookmark）：命名的位置或文本。
二、创建帮助主题文件
因为HTML帮助系统的主题文件是HTML文件，所以可以使用任何能够创建HTML文件的软件
来创建帮助主题文件，如：Workshop、Office97、FrontPage、Visual J++、Visual In
terDev等软件。笔者喜欢用Office97中的Word97来创建，因为使用它创建HTML文件就不
必面对HTML文件复杂的源代码。
在Word97中创建帮助主题文件时还可以使用插入（Insert）菜单定义超级链接（Worksh
op中称为正文链接）和书签。
1.向主题文件中插入HTML Help ActiveX控件
HTML Help ActiveX控件是ActiveX控件的一种，它包括快捷方式、相关主题、KLinks及
Alinks等命令，它是专为HTML帮助而设计的控件。HTML Help ActiveX控件只有在支持A
ctiveX技术的浏览器中才能显示。
向主题文件中插入HTML Help ActiveX控件实际上就是向HTML文件中插入OBJECT标签，除
去左面的行号，下面是一个典型的HTML Help ActiveX控件的OBJECT标签：
1
2 classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
3 codebase="hhctrl.ocx#Version=4,72,7325,0"
4 width=100
5 height=100
6 >
7
8
9
10
第7行的“value”值应该用HTML帮助控件中的命令来代替。HTML帮助控件中的所有命令
见表1。
第8行中参数的名字为“Button”，代表HTML Help ActiveX控件在HTML文件中以按钮的
方式显示，“value”值代表显示在按钮上的文字、图像或图标；如果想以文字方式而不
是按钮来显示控件，须将“Button”改成“Text”，这时“value”值定义的是提示文字
，它是不带下划线的，要想改成带下划线的文字只要在第8行和第9行之间加入类似下面
的参数行：
第9行中的“value”值定义了HTML Help ActiveX控件需要的其他参数如相关主题所链接
的帮助主题的标题、快捷方式所链接的可执行程序或对话框的带路径的名字等。
HTML Help ActiveX控件的OBJECT标签可以手工加入主题文件中，但使用HHCTRL向导来创
建更方便。方法是：将光标置于打开的主题文件的BODY部分，然后在Workshop的“Tags
（标签）”菜单上单击HTML Help Control （HTML帮助控件）启动并完成HHCTRL向导。

2.向主题文件中插入Java Applet（Java小程序）
使用下面的APPLET标签将Java Applet加入主题文件：
codebase应指明Applet的 Class文件的路径。
该APPLET标签中两个参数的含义与前文所述的OBJECT标签的第7行和第9行的意义是一样
的。只是在该标签中Command参数可选的命令只有Table of Contents、Index和Related
 Topics三个。
3.向主题文件中插入JavaScript（Java脚本）
Java脚本在帮助网站中的主要用途是向主题文件中加入弹出式窗口。加入弹出式窗口的
方法是在主题文件的BODY部分希望弹出式窗口显示的地方加入类似于下面的标签：
("a pop-up window.","Verdana,10",9,9,-1,-1)>Popup
其中括号中的文字就是显示在弹出式窗口中的文字，可以按该语句所示的格式修改成需
要的文字。
三、创建目录文件和索引文件
1.创建目录文件和索引文件
创建目录文件和索引文件的方法基本一样：在Workshop的“File”菜单上单击“New”，
启动“New”对话框（见图2），在对话框中选择“Table of Contents（目录）”或“I
ndex（索引）”，单击“OK”，Workshop将打开一个目录文件或索引文件的创建窗口。
窗口中的主要按钮及它们的功能如下：
1） ：修改目录或索引的属性。
2）： ：修改所选择的目录中的条目或索引中的关键字的属性。
3） ：删除所选择的目录中的条目或索引中的关键字。
4） ：改变所选择的目录中的条目或索引中的关键字的位置或级别。
5） ：向索引文件中插入一个关键字，并定义该关键字的名称和所链接的主题文件或关
键字。
6） ：向目录文件中加入“头”条目或“页”条目，同时定义该条目的名称和它所链接
的主题文件。
2.关于索引文件
在Workshop中索引分为两种类型：一种是二进制索引（Binary Index），另一种是网站
影射索引（Site Map Index），在帮助网站中只能使用网站影射索引。有两种方法可以
保证创建的索引文件为网站影射索引：
1）当创建了一个索引文件并且没有编译它时该索引文件就是网站影射索引。
2）如果创建的索引文件包括在Workshop的项目文件中并进行了编译，那么就需要在该项
目文件窗口的“Project（项目）”页中单击“Change Project Options（改变项目的选
项）”按钮启动“Options”对话框选择“Compiler（编译）”页见图3，在“Compatib
ility（兼容性）”栏选择“1.0”或者去除“Create a binary Index”核选框的核选标
志。
3.将目录文件或索引文件插入HTML文件
只有将目录文件和索引文件插入HTML文件中才能在帮助网站中使用它们。插入方法有两
种：
1）使用HTML Help ActiveX控件：在HHCTRL向导或OBJECT标签中将“Table of Content
s”或“Index”作为命令。
2）使用Java Applet：同样的，在Applet标签中也要将“Table of Contents”或“Ind
ex”作为命令。
将OBJECT标签或Applet标签中的“Item1”参数的“Value”值设为带路径的目录文件名
或索引文件名。
4.目录的外观特征
目录有许多外观特征，一些特征在帮助文件和帮助网站上都可以使用，而另一些特征只
有在帮助文件中才可以使用（见表2）。帮助文件中使用的目录的外观特征可以通过单击
目录属性按钮在目录属性（Table of Contents Projects）对话框中定义（见图4），而
帮助网站中的目录的外观特征需要在将目录文件插入HTML文件的HHCTRL向导中选择（见
图5），当改变了HHCTRL向导的缺省选择后HHCTRL向导会在OBJECT标签中加入一个名为“
Flags（特征）”的参数，示例如下：
随着在向导中选择的特征不同，该参数的“value”也有所不同。
四、创建框架(Frame)和框架集合(Frameset)
1.在HTML文件中创建框架的Frame标签
Frame标签中主要有两个参数需要定义：
（1） NAME= window_name | _blank | _parent | _self | _top
指定框架的名字以使别的文件中的链接能将它作为目标。
window_name：一个用来指定框架名字的字符串。
_blank：将链接加载到一个未命名的窗口。
_parent：在父窗口中加载链接。如果该框架没有定义父窗口，则指向“_self”。
_self：使链接替换该页面。
_top：在整个游览器窗口加载链接。
（2）SRC=string
指定框架关联文件的路径和名称。
2. 在HTML文件中创建框架集合的Frameset标签
1) Frameset标签中的主要参数
（1）COLS=string
用一个字符串定义框架集合的分列方式，字符串将用逗号分隔成若干项，分隔的项数代
表框架集合的列数，每一项又定义了对应列的初始尺寸。
（2）ROWS=string
与COLS的意义相似，只是ROWS定义的是框架集合的分行方式。
这两个参数共同定义了框架集合中的框架的个数和各个框架的尺寸。
2) Frameset标签的一个示例
该Frameset标签首先将框架集合分为左右两个框架，然后又用一个Frameset标签将左面
的框架分为上下两个框架，这样该框架集合就包含三个框架。同时该标签还定义了各个
框架的名称、尺寸及关联的HTML文件的文件名。
需要特别说明的是在HTML文件中定义框架集合时必须将HTML文件中的BODY标签删除，否
则Frameset标签将不起作用。
五、制作帮助网站的主页
帮助网站的主页的形式应类似于帮助文件的界面(如图1)，实现的方法有以下两种：将帮
助主页分为三部分；将帮助主页分为两部分。
1. 将帮助主页分为三部分
将帮助主页分为三部分，如图6。同时我们设想在左上部分显示以目录和索引为提示文字
的正文链接，单击目录在左下部分显示目录文件，单击索引则在左下部分显示索引文件
，而单击目录中的条目或索引中的关键字与它们相链的主题文件将显示在右半部分。
为此我们建立一个HTML文件并将BODY标签删除然后在该HTML文件包括一个如上述“Fram
eset标签”示例的包括“top”、“bottom”和“right”三个框架的框架集合。同时“
top”框架关联的HTML文件应包括两个正文链接即目录和索引，这两个正文链接分别指向
包含目录文件的HTML文件和包含索引文件的HTML文件。“bottom”框架关联的HTML文件
应为包含目录文件的HTML文件和包含索引文件的HTML文件中的一个，到底为那一个取决
于打算在用户浏览帮助网站时缺省打开目录文件还是索引文件。“right”框架关联的应
是在用户游览帮助网站时缺省打开的主题文件。作了以上设置后在IE中打开帮助主页如
图7：
从表面上看，这个主页已经符合要求了，但是现在如果单击目录的一个条目或索引的一
个关键字与它们相链的主题文件并不是像设想的那样显示在“right”框架中，而是显示
在“bottom”中；单击正文链接目录或索引时它们所链接的HTML文件也不是像设想的那
样显示在“bottom”中，而是显示在“top”中。那么怎样才能让它们按设想的那样显示
呢？
（1）在Workshop中打开目录文件或索引文件，在窗口中单击目录属性或索引属性（Ind
ex Properties）按钮启动目录属性或索引属性对话框，在“General”页的“Defult f
rame（缺省框架）”栏中指定当单击目录的条目或索引的关键字时与它们相链的主题文
件所显示的框架的名字，在这里是“right”（见图8）。
（2）要实现单击正文链接时与之相链的HTML文件显示在指定的框架中须在该正文链接的
标签中加入“target”参数示例如下： 目录
“target”参数定义了单击正文链接时，用来显示与该正文链接相链的HTML文件的框架
的名字。通过以上设计帮助主页就按我们的设想来工作了。
2. 将帮助主页分为两部分
象图1那样将帮助主页分为左右两部分，左半部分包括目录、索引两个提示文字及目录文
件或索引文件（这一部分Workshop中称为导航框架），右半部分显示主题文件（Worksh
op中称为主题框架）。要实现这一点需定义一个包含两个框架的框架集合方法如下：
要实现单击目录中的条目或索引中的关键字时与它们相链的主题文件显示在右半部分可
以象本文5.1（1）中那样设置。
但是如何实现导航框架中的目录和索引两个提示文字始终显示而目录文件和索引文件交
替显示呢？笔者从Windows 98的Whatnew帮助中得到了启示：制作两个HTML文件（见图9
），一个文件包含目录提示文字、索引正文链接和目录文件；一个文件包含目录正文链
接、索引提示文字和索引文件，这两个HTML文件通过正文链接互相跳转，其中一个定义
为框架的关联文件以定义用户浏览帮助网站时缺省打开目录文件还是索引文件。从Micr
osoft IE上游览帮助网站主页时的界面见图10，这样帮助主页就有了与帮助文件类似的
界面效果。
六、从帮助网站上打开帮助文件（CHM文件）
要从帮助网站上运行一个经过编译的帮助文件即CHM文件，就需要从帮助网站的某个HTM
L文件包含一个链接，该链接用下面的语法来定义： 链接文字
http://filename.chm代表要运行的.chm文件的路径/地址和文件名，default.htm代表要
打开的主题文件。要注意的是只有用户使用Microsoft IE4.x 以上版本的IE时才能从帮
助网站上打开.chm文件。
七、在搜索引擎上注册帮助网站
当因特网用户为获得信息而浏览网络时为节省时间他们通常通过搜索引擎来定位网站，
也就是说在一个或多个搜索引擎上注册了的帮助网站就容易被访问，因此既然创建了帮
助网站， 就应该在流行的搜索引擎（如Yahoo、Lycos、Excite、Webcrawler、AltaVis
ta以及 Infoseek等）上注册它。
各个搜索引擎对在其上注册网站都有自己的要求，搜索引擎的主页上一般有一个指向包
含如何注册网站信息的页面的链接，单击该链接，然后根据要求来注册帮助网站。
八、管理帮助网站
创建了一个帮助网站以后最重要的任务就是如何管理它，以保证帮助网站上的信息是最
新和最正确的。如果帮助网站上包含过期的或错误的信息，它就会失去访问者，这个帮
助网站也就失去了存在的意义和价值成了一个失败的网站。为了防止这种情况的发生就
必须很好地管理帮助网站，管理帮助网站的主要工作有：
1）向帮助网站中加入新的内容和信息。
2）更新网站中原有的内容和信息。
3）检查文件位置(如内容和索引文件的位置) 。
4）检查网站中的各种链接。
表1 HTML帮助控件中的命令
命令 帮助网站中是否能使用
Alink Search 不能使用
Close Window 不能使用
HHCTRL version 可以使用
Index 可以使用
Keyword Search 不能使用
Related Topics 可以使用
ShortCut 可以使用
Splash screen 可以使用
Table of Contents 可以使用
Training Card 可以使用
WinHelp topic 可以使用
表2 目录的外观特征
特征名称 帮助文件 帮助网站 中文含义
Automaitcally track selection √ × 自动的选择轨道
Border √ √ 边框
Dialog Frame √ √ 对话框架
Draw lines between items √ √ 在项目之间画线
Only expand a single heading √ × 只展开一个“头”
Plus/Minus squares √ √ 正/负 正方形
Raised edge √ √ 凸边界
Right-to-left reading order √ √ 从右到左的阅读规则
Scroll bar on left side √ √ 滚动条在左边界
Select entire row √ × 选择整行
Show selection when focus lost √ √ 当失去焦点时显示选择
Start line from the root √ √ 从根部开始画线
Sunken edge √ √ 凹边界

--
※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: as.hit.edu.cn]