自己动手将在线文档制作成CHM文件

原文地址：http://blog.csdn.net/lostaway/article/details/6337095

在线帮助文档转CHM方法

用到的工具：

wget工具(Linux自带，Windows下请自行下载)，htm2chm(共享软件，不过没什么限制)

具体步骤：

1、使用wget工具下载在线文档整个目录

简单介绍一下wget的几个用到的参数。

-c 断点续传(ps : 使用断点续传要求服务器支持断点续传)

-r 递归下载(目录下的所有文件,包括子目录)

-np 递归下载不搜索上层目录

-k 把绝对链接转为相对链接(这样下载之后的网页才能离线浏览)

-L 递归时不进入其他主机

-p 下载网页所需要的所有文件

故，使用的命令为：

$wget -c -r -np -k -L -p http://www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace/index.html

2、使用htm2chm将下载的网页文件转化为CHM

如前例，我下载了 ACE库，5.7.4版本的在线文档。接着，打开htm2chm软件。主界面如下图：

Note:

这里不得不提一下CHM文件索引制作的事。能够自动生成CHM索引文件的工具还不存在，只能手动制作。顶多有根据网页文件目录层次生成CHM目录的功能，其实没什么用。各种CHM制作工具都是根据HTML文件的标题生成的索引信息，像制作精良的CHM帮助文档那样方便快捷搜索能力是很难达到的。因为一般来说网页的标题和内容之间关系不是很密切，标题中常常会有多余的信息。比如，说明某个类的页面其标题并不是某个类名，这样你在CHM的搜索框里面搜索这个类的时候是没有结果的。

我们要选择的是 Compiler 。Compiler 窗口如下

这里说明一下其中的 Preset(预置) 选项。包含 Downloaded website、Help、Saved page 三种预置方案。由于CHM 的 Help 文档并不能智能的生成目录结构和索引，所以我直接选择了 Downloaded website 方案。

D:/WorkSpace/www.dre.vanderbilt.edu 是前例中下载的文件的根目录。

我的 Folder: D:/WorkSpace/www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace

我的 Home: D:/WorkSpace/www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace/index.html

我的 Output: D:/WorkSpace/www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace.chm

接着，按 Start 开始编译 CHM 文件。片刻之后，CHM 文档生成。如下：

3、生成的CHM文件的使用技巧

由于这种方法制作的 CHM 文档没有索引功能，所以会给日常的使用带来不便。但是，一般的在线手册都会有一个索引页，里面罗列了所有的主题，所有的类名，所有的函数之类的信息。我们只需在此页上 Ctrl + F 打开查找对话框，输入关键字，就可以查找我们感兴趣的内容。我们也只能期待高人们开发出智能生成 CHM 目录和索引的工具了。

参考

1、方便的网络下载工具wget 可下载网站目录下的所有文件

http://www.alibuybuy.com/posts/6701.html

2、htm2chm FAQ 手册(htm2chm可执行文件所在目录 FAQ.chm)