下面就以struts的帮助文档为例
在学习Java的时候我们曾经学习过,Java有很强大的注释功能,其中 /****/ 这种注释可以用来生成文档,
更具这个思路,一个开源的项目,我们可以下载到他们的源文件,那么其注释应该是完整的,通过这些注释就能生成完整的apidoc文档。
下载最新的struts包:http://struts.apache.org/download
下载文档生成的辅助工具,我用的是jd2chm
准备工作完成
接下来开始升沉文档
一:找到struts的源代码的位置 \struts-2.3.15\src\core\src\main\java
二:在eclipse里面新建一个Java project ,将struts源代码拷贝到src目录中
三:我们看到代码复制进去后有一堆的错误,因为源代码所依赖的包还没导入,接下来我们倒入包,
所需的包就在下载的struts的文件里面 struts-2.3.15\lib
选中工程=》右键=》Build path=》configure build path =》在libraries里面=》add external jars
找到 struts-2.3.15\lib Ctrl+A全部导入,这时发现红叉少了许多,找到剩下的错误文件的错误之处
因为我们这是一个java项目,所以当然不包含HttpServlet的依赖jar包,但是记得Apache的lib里面有需要的jar包,
继续Build path =>add external jars,导入 在apache-tomcat-6.0.36\lib目录里面的 jsp-api.jar 和servlet-api.jar
错误消除
四:在eclipse中 Project=》Generate javadoc
五:得到文档的html文件,并将jd2chm文件放到文件目录下
(如果电脑没有安装htmlhelper的话要先安装htmlhelper,htmlhelper.exe已经在jd2chm.zip里面了)
六:打开命令行,cd到html文件目录中
八:enjoy!
生成的文档:struts-2.3.15.chm