如何制作已编译的HTML帮助文件（即CHM帮助文件）

最新推荐文章于 2021-06-17 09:01:57 发布

javazhuanzai

最新推荐文章于 2021-06-17 09:01:57 发布

阅读量4.4k

点赞数

分类专栏： javaee 文章标签： chm html 文档工具全文检索 express

javaee 专栏收录该内容

789 篇文章 0 订阅

订阅专栏

======================================================
注：本文源代码点此下载
======================================================

html帮助文档从结构上来看可分为两个部分,运行器和文档内容。它的一个好处是能使帮助文档跨平台运行,只要有不同平台上的运行器和浏览器,帮助文档不再需要重新编制,制作html帮助文档的工具是html help workshop工具包。

方法:

1、安装好html help workshop,需要重新启动一次才可以运行。运行后,单击菜单或工具栏中的“新建(new)”,这时出现选择新建内容的对话框。先选择“工程(project)”,在接着出现的工程向导中指定工程放置的目录就可以了。单击“ok”后就出现工程编辑界面。在工程编辑界面的上方是3个标签栏,第一个“project”是有关工程的编辑,第二个“contents”是目录,第三个“index”是索引。在工程编辑界面的左侧是7个按钮,它们的功能从上到下依次为:“改变工程选项”、“加入/删除封面文件”、“添加/修改窗口选项”、“htmlhelp ap信息”、“浏览html源文件”、“保存”、“存盘并编译”。

2、单击“改变工程选项”按钮,出现工程选项对话框(如图1)。这里仅改变标题(title)的内容,把标题写入,编译后这个标题将出现在窗口的标题栏中。其他的内容暂时用系统的默认值。然后单击“加入/删除封面文件”按钮,再选择“加入”按钮,把作为封面页的html文件添上。封面页的文件一定要有,否则编译的帮助文件运行后,系统会报错。好了,简单的工程编辑就完成了。

3、单击“目录”(contents)标签栏,这时系统请你选定一个新目录文件的名称,指定后出现目录的编辑界面(如图2)。然后按照内容的需要插入标题或页面目录,并对每个目录选定相应的html文件。标题可以分为多级,并在标题上也放置需要的html文件,作为标题的说明内容,这需要按照你制作的内容统一考虑。目录的内容在编译后(如图3)的左侧所示,这是3个标题,单击目录可以打开相应的文件内容。插入目录后,关于目录的属性暂时也用默认值,这样基本的目录就可完成。

4、完成目录编制后,一个html帮助文件已具备了雏形,关于索引的内容暂时空着。保存工程文件和目录文件后就可以编译,编译的特点是把所有用到的html文件统统压缩后包装在一起。在主工具栏按钮中可以找到编译按钮和试运行按钮,编译后再运行就可以看看作品的面貌了。

这就是编制html帮助文件的基本步骤,上手很容易。但软件的功能远非这些,如在窗口定义中可以设计你所喜爱的形式,几乎所有的窗口要素都可以改变。它还支持全文检索功能,而且很容易制作。详细的内容请参考html help workshop的帮助文档或微软的相应网页。相信你试过以后一定会喜欢它。

“chm”格式帮助文件制作软件far使用

制作chm格式的工具有很多,far是其中非常优秀的一款,而且已经有了比较好的汉化版本,因此我们选择用它来制作chm格式文档。

1、默认情况下,启动far时,系统会自动对我们机器的软件环境做一个检查,以决定能够支持的即将输出的文档格式。

2、启动完成后,单击工具栏上方的“添加web”(add all web files found in a selected folder and its sub folders)按钮来建立一个文件列表。在弹出的对话框中选择包含页面文件和图片文件的文件夹,单击“ok”按钮(图片和页面文件最好存放在同一文件夹下面),此时出现一个对话框,告诉你当前文件夹下面的文件总数和html文件数。并询问是否只加入html文件,如果你的页面文件未包含图片和其他多媒体文件,请选择“yes”,否则选择“no”。

此时所选文件夹下面的文件应该出现在窗口显示区。单击“保存列表”按钮即可将此列表保存在磁盘上。需要说明的是,这个“添加web”的过程支持拖放式操作,我们随时可以按下“f4”功能键打开资源管理器,找到需要添加的文件所在的文件夹,直接用鼠标拖动到该窗口显示区来完成这项操作。

图1

3、准备好了文件列表,我们就可以正式开始制作chm文件了。单击工具栏中的“快递(html help express)”按钮,弹出如图1所示的对话框,这里我们只需设置好目标文件的位置及文件名、帮助窗口的标题,选择一个文件作为首页面即可。注意一点,帮助窗口的标题也就是我们在最后的成品chm文件中看到的标题文字,应该反映整个chm文件的主题,大家一定要设置好。软件一般能够根据所添加的文件夹的名字来进行设置,如果不满意,可以自由更改。

4、设置好上面几个参数后,必须要先将文件预编译一遍才可以设置文档的界面参数。单击图1中的“创建帮助(creat help)”按钮,会弹出一个确认对话框,选择“是”则用far文件列表创建帮助,如选“否”,则自动搜索选择目录中的html文件来创建。接下来软件会自动编译文件,最后在弹出的窗口中报告编译信息。

5、点击“关闭”,这时我们可以看一看我们自己的成果了!单击“查看帮助(view help)”按钮即可。如果你对做好的chm帮助文档的形式或内容不太满意,比如窗口的类型、窗口中工具栏中显示的工具的数量甚至是遗漏的部分文件等等,怎么办?细心的读者朋友可能已经注意到了,图1的右下角还有一个“高级编辑(advanced edit)”按钮,接下来的工作我们几乎都要通过这里的功能来设置。