现在的位置: 首页 > 综合 > 正文

自己生成struts2.3.1.2帮助文档方法

2018年01月26日 ⁄ 综合 ⁄ 共 1405字 ⁄ 字号 评论关闭

首先在MyEclipse中建一个JavaProject(取名:struts_doc),然后找到struts2的源代码(到apache官网上下载)的目录(如:F:\TDDOWNLOAD\struts-2.3.1.2\src\core\src\main\java),把java目录下的org文件夹全部拷贝到struts_doc项目下的src目录下,肯定会有一堆错误,不用着急,这是因为我们没有添加对应的jar包导致的,下面我们一个一个解决。

        右击struts_doc项目-->BuildPath-->Configure Build Path-->在右边选择Libraries-->再点击右边的AddExternal JARs...-->找到lib目录(如:F:\TDDOWNLOAD\struts-2.3.1.2\lib)-->全选里面的jar包,再把struts2-core-2.3.1.2.jar排除掉(注意:不同版本名字不同)-->点击打开,这样大部分的错误就解决了,接下来我们到tomcat中找另外两个jar文件:右击struts_doc项目-->Build
Path-->Configure Build Path-->在右边选择Libraries-->再点击右边的AddExternal JARs...-->找到tomcat中的lib目录(如:F:\TDDOWNLOAD\apache-tomcat-6.0.35\lib)-->找到jsp-api.jar和servlet-api.jar并选择,点击打开,好的,我们还剩下最后一个错误了,到网上下载velocity-tools-1.3.jar这个包,然后同上面一样添加进来即可。好了,所有的错误都已经解决了,对不同的版本可能添加的包不尽相同,自己再上网找解决办法就行。

        OK,我们在桌面建一个名为struts_doc的文件夹,准备把文档生成到这个文件夹里,接下来选中项目struts_doc-->在工具栏中点击Project-->Generate Javadoc...-->选中Use standard doclet,点击Browse…,选择刚刚建好的目录struts_doc,如下图:


-->Next>-->在ExtraJavadoc options(path names with white spaces must be enclosed in quotes):一栏中写上‘-encodingUTF-8 -charset UTF-8’,否则可能出现乱码,另外在下面的JRE source compatibility:中选择1.5,个人觉得1.6生成的样子不好看,而且在生成chm格式时不能搜索(我生成的是这样,不知道大家有没有更好的办法,欢迎拍砖并分享,谢谢!),如下图:


-->选中Document title:给文档取名字为:struts2.3.1.2-->接下来选择要归档的文件,这里我们全选(即点击右边的Select All) -->Next-->Finish-->这时可能会弹出一个对话框,这个是更新记录的,更不更新都行,我们选Yes To All,好了,现在开心的等待吧,可能会有很多警告,不过没关系,到桌面上struts_doc文件夹下看看你的成果吧!这个帮助文档是网页形式的,如果不满意,可以用帮助文档生成工具转换成chm格式,便于查询!

网页版本的视图:

chm版本的视图:

抱歉!评论已关闭.