制作CHM帮助文件遇到的问题及解决方法

制作CHM工具：Microsoft HTML Help Workshop v1.3 英文版

问题1:默认首页不能显示
在Project->Change project options,在Default files里输入一个.htm的路径后，首页还是不能显示。

解决方法：
(1)要做首页的.htm文件必须也要编译到.CHM帮助文档中，比如选择一个heading，将首页的.htm的路径添

加到它的URL中；
(2)用相对路径。将要做为首页的.htm拷贝到和.hhp的相同目录或在.hhp同级目录的文件夹下，然后把要

做首页的.htm的相对.hhp的路径填入Default files中，比如：我的SIMS.hhp存放在C:\Help,首页.htm存

放在C:\Help\help files文件夹中，这样只需将help files\首页.htm填到Default files中即可。
(3)保存，重新编译。

问题2:CHM帮助文件不能显示图片

    我是先在Word中写好帮助文档，排版后，将.doc文档另存为网页:
即执行:文件->另存为网页，在弹出的"另存为"对话框中有三种网页格式:单个文件网页(*.mht;*.mhtml)

，网页(*.htm;*.html)，筛选过的网页(*.htm;*.html) 我以前选的是第二种，可后来发现有图片的地方

不能显示，总是显示为一个红色的叉叉。

解决方法：将.doc文档另存为网页，在弹出的"另存为"对话框中选择“筛选过的网页(*.htm;*.html)，这

样就能正常显示图片。我觉得这和图片格式没有关系。网上有人说，CHM帮助文件不能显示.bmp、.gif格

式的图片，可我尝试了一下。发现.jpg、.bmp、.png、.gif都能正常显示，前提是将.doc Word文档另存

为“筛选过的网页(*.htm;*.html)”。

问题3:打开CHM帮助文件的某页时，弹出类似如下的错误:
“找不到'H:\帮助\Help\查询学生学籍信息.htm'。请确认路径或Internet地址正确。”

    制作好CHM帮助文件后，有时候将它移动到另一台计算机或将原来的.htm文件移动到另一个地方，当

再打开CHM帮助文件时，会弹出这样的错误。我觉得应该是这些.htm文件没有被成功编译到.CHM帮助文档

中，可能是软件的安装没有成功，我遇到这种错误时，就是这个原因。起初安装到最后时，说是某个.dll

找不到，可我发现HTML Help Workshop还能使用，就没理会。可就是因为这一点，出现了这个错误。也就

是说，CHM帮助文件必须和原来添加的的.htm文件同时存在，且路径和编译时的保持不变。CHM帮助文档不

能作为一个独立的文档而存在。

解决方法：Windows Server 2003安装HTML Help Workshop出现错误（其它的CHM制作工具如Su
perCHM也不行)。我只好在虚拟机的XP中重新安装它，最后提示安装成功，也能正常使用了,没有出现以上

的错误， 且CHM帮助文档可作为一个独立的文档存在。

问题4:制作好的CHM帮助文档无法显示网页

    制作的CHM帮助文件不能带有#的目录中，因为会#会被当成书签。这学期我做了一个C#数据库应用程

序。当把制作好的CHM帮助文件拷贝到带有c#字样的目录下(Debug)中时，所有的。htm都无法显示。我在

制作的C盘和桌面上都能正常打开，就是在那个目录下打开时说无法显示网页，我感觉那个路径名有问题

，就把其中的特殊字符逐个检查了一遍，有"."，"("，")"，"#"，"&"。其中我发现，只有当某个文件夹

名中带有"#"时，CHM帮助文件就无法显示。后来，确定问题就出在这里。原来，"#"不能出现在chm路径中

，否则会被当成书签。

解决方法：将CHM帮助文档中带有#符号的路径改为不含#符号的路径