struts2.2.3.1API文档制作图解（chm格式）

在struts2.2.3.1发布不久，网上很多人都在求struts2.2.3.1文档。

现在各式各样的API文档都已经出现了，但是制作教程大多是struts2.2.1.1版本的，虽然都是struts2 ，但是2个不同的版本做API文档还是有一点出入。

下面我们来制作struts2.2.3.1的API文档，struts2.2.1.1版本网上教程比较多，大家也可以利用搜索引擎去查找。

工具:
1   Myeclipse
下载 http://xiexiejiao.cn/?r=http://downloads.myeclipseide.com/downloads/products/eworkbench/galileo/myeclipse-8.6.0-win32.exe
然后安装
2   struts2.2.3.1
下载  http://mirror.bjtu.edu.cn/apache//struts/binaries/struts-2.2.3.1-all.zip
然后解压
3   部分jar包   velocity-tools-2.0.jar
下载    http://dldx.csdn.net/fd.php?i=171535329482705&s=ba06c5970851a68b244e55939896fa7f
4 jd2chm
下载    http://www.burgaud.com/download/jd2chm_exe_03.zip
然后解压

因为struts2是开源的框架，而javaAPI文档的制作就是生成源代码里面的/*  */的东西

开始正文了

首先打开 Myeclipse
file—new—java project

随意命名  这里命名为struts_hx了

上面我们解压了struts-2.2.3.1

找到 struts-2.2.3.1-all\struts-2.2.3.1\src\core\src\main\java这个目录 有个org的文件

复制org 文件到  struts_hx项目下的src目录

我们看到全是红色的错误信息，因为我们没有把struts2里面的jar包导入

在当前项目点击鼠标右键build path—configure build path

点击右边第二项  然后找到struts-2.2.3.1-all\struts-2.2.3.1\lib目录
lib目录为struts2的所有jar包
全选  打开

然后点击OK。

我们看到现在还是有错误信息，查看下相关错误信息

可以看出是支持servlet   API jar包没有被导入

按照之前的方法导入jsp-api.jar和servlet-api.jar
这两个jar包都可以在tomcat\lib目录下找到，如果没有安装tomcat可以在百度搜索这2个jar包下面然后导入

在当前项目点击鼠标右键build path—configure build path

点击右边第二项找到jsp-api.jar和servlet-api.jar所在目录

点击打开   OK

但是还是不行  还是有错误，查看错误信息

可以看出缺少velocity-tools  jar包

前面我们已经下载了，现在按照前面的方法

在当前项目点击鼠标右键build path—configure build path

点击右边第二项找到velocity-tools-2.0.jar包所在目录

点击打开   OK 。
现在没有错误信息了  ，然后我们就可以开始制作API文档了
如图

选择struts_hx项目文件，next
然后如图

点击next，点击finish，点击yes to all

开始生成

这里的是警告信息，不影响我们的制作。

现在我们的API基本就完成了。

打开你的项目存放文件 myworkspace\struts_hx\doc

双击 index.html

html格式的API文档就制作好了，下面我们转化为chm格式

到了这里就要使用我们下载的第四个工具   jd2chm
复制解压后的jd2chm.exe文件到myworkspace\struts_hx\doc目录下

点击 开始 运行 cdm 确定
使用 cd命名 切换到 myworkspace\struts_hx\doc目录

到了这里我们的制作就完成了

打开看看吧

其实制作还是比较简单，在网上搜索没有发现相关教程，所以在此详细图解！