生成chm格式文档详解

生成chm格式文档详解

2012-12-24

                                                        作者：莫凡

对于搞IT技术的同志们来说，尤其是做开源项目的IT技术人员，一份chm格式的文档是多么的重要。下面我就以Struts2为例详细讲解一下做chm格式文档的步骤：

1、            首先下载struts-2.3.1.2-all.zip，然后解压缩，在myeclipse里面建立一个新java项目（Struts2），然后找到Struts2的源码，在struts-2.3.1.2\src\core\src\main\java路径下，把下面的文件复制，然后粘帖到刚刚建好的项目的src下面。

2、            此时肯定有很多错误，但是别慌，Struts2需要的jar文件还没有导入呢，导入jar文件，选中Struts2，然后右键Build Path—》Configure Build Path，找到Libraries标签，然后点击， ，找到解压的Struts2文件路径，然后找到lib目录选中所有的jar文件，但是struts2-core-2.3.1.2.jar除外。导入jar文件。

3、            高兴的是很多小红叉基本消失，但是仍有一点小红叉。此时别慌，找到tomcat（别说没有Tomcat啊）的lib目录，jsp-api.jar，servlet-api.jar这两个jar文件，按照步骤2将其导入。

4、            此时发现，红叉又少了很多，让人很不舒服的是仍有一个小红叉，经仔细研究发现，还是缺少一个jar包，不知道去哪儿找了，根据缺少的类只能在网上找到了需要的jar文件，velocity-tools-1.4.jar，重复步骤2将其导入。

5、          小红叉终于没有了，现在可以生产docs文档，选中刚刚新建的项目Struts2，点击菜单栏上的ProjectàGenerate javadoc出现

点击 Next >,出现

6、            最后点击完成。

7、            哇，生成了javadocs文档了，但是现在还不是chm格式啊。

8、            此时需要一个软件，在百度输入jd2chm，然后将此软件下载。

9、            将jd2chm.exe放到生成的javadoc文件夹下，如图：

然后进入在运行里面输入cmd进入dos窗口，进入到jd2chm.exe所在的路径，然后输入jd2chm，如图：

回车，出现如图：

10、        输入你想输入的文件名称：Struts2.3.1.2（随意），这个是生产的chm文件的名称。

11、        点击回车，然后又需要输入名称：Struts2.3.1.2（随意），这个是window窗口上显示的名称。

12、        慢慢等待chm格式文件的生产吧。。。