制作chm文档记录

最近在使用Linux下的SANE扫描接口开发，需要经常打开网页查找，有点麻烦，随产生了弄一个chm文档的想法。

搜索了一番，决定还是使用微软的HTML Help Workshop软件（版本4.74）。有不少国产软件更方便使用，但是要么需要购买注册，要么破解。

下载地址：https://www.helpandmanual.com/downloads_mscomp.html（开始搜索微软官网，但是不能下载了，进新的下载中心，没找到，汗。。。）。

 

正常安装，安装后直接打开。

准备过程：

制作Html网页：使用IE打开相应链接，全部复制网页内容，粘贴至Word中（注意：图片需要单独复制）。根据喜好编辑一下内容，然后另存为，保存类型选择“筛选过的网页”，如果有图片，会产生对应的一个文件夹。

重复上述过程，将需要的网页全部保存下来。

 

制作过程：

1，新建工程，选File--New--Project，不勾选“Convert WinHelp project”，选择工程保存路径及文件名，下一步选择第三项“html”，然后不添加任何文件，直接下一步到完成。

2，在Project标签页，选左侧的“Add/Remove topic files”，选中刚才保存的网页，点OK。

3，切换至Contents标签页，选新建工程文件。

4，在Contents标签页，选左侧的“Insert a page”，输入名称，Add选择刚才添加的html网页，依次将所有的网页都添加上。

5，返回Project标签页，选左侧最下面的“Save all files and complie”即可生成chm文件。

 

遇到的问题：

1，根据制作过程制作的chm文件，第一次打开时，网页无法打开，看不到内容。

　　解决办法：在Project标签页，点中第一个html文件，点左侧的“View HTML source”按钮，打开网页编辑窗口，将网页中的所有链接删除。<a href=xxx></a>，然后保存，重新生成chm文件后解决（本次只编辑了第一个网页）。

2，chm文件中图片无法正常显示。

　　解决办法：找到图片所在网页，进入网页编辑窗口，找到原来图片的html内容，修改。

　　例如：原网页图片附近的代码为：

<p class=MsoNormal align=center style='text-align:center'><span lang=EN-US><a
href="https://sane-project.gitlab.io/standard/_images/hierarchy.svg"><img
border=0 width=32 height=32
src="3%20The%20SANE%20Environment.files/image001.png" title=""></a><img
width=961 height=471 id="图形 4"
src="3%20The%20SANE%20Environment.files/image002.png"></span></p>

　　修改为：

<p class=MsoNormal align=center style='text-align:center'><img
width=961 height=471 id="图形 4"
src="3%20The%20SANE%20Environment.files/image002.png"></span></p>

　　依次将所有的图片修改完成。然后保存，重新编译生成chm文件。图片可正常显示。

 

目前没有实现的功能：

1，章节无法直接跳转；

2，没有做索引。

未完成的功能待后续有时间再研究吧。

 

感谢链接：
https://blog.csdn.net/zhoufoxcn/article/details/2213955
解决图片不显示的链接：
http://www.cnitblog.com/zhangys0218/archive/2008/03/12/40835.html