- 浏览: 1542215 次
- 性别:
- 来自: 北京
文章分类
- 全部博客 (225)
- JAVA (27)
- Spring (49)
- Linux (51)
- JavaScript (8)
- Scrum (23)
- IDE (2)
- JSON (2)
- Solr (0)
- Webharvest (0)
- Hibernate (8)
- 杂谈 (3)
- Windows 7 (4)
- 持续集成 (23)
- tomcat (3)
- Android (1)
- SpringSecurity (11)
- Maven (9)
- jotm (3)
- C3P0 (1)
- Active Directory (2)
- cas (1)
- JQuery (2)
- ajax (1)
- plsql (2)
- nginx (4)
- apache (1)
- thrift (7)
- python (3)
- oracle (4)
- php (2)
- redis (1)
- fedora (1)
- windows7 (0)
- SVN (1)
- NFS (1)
- SAMBA (1)
- Atomikos (1)
- apache-poi (1)
- mysql (2)
- vncserver (1)
- mac (2)
- firefox (1)
- JIRA (1)
- p6spy (1)
- git (1)
- github (1)
- gitlab (1)
- gogs (1)
- Druid (1)
- MyBatis (1)
- docker (8)
- zabbix (1)
最新评论
-
lialatd:
您好,我用您的方法通过java api往jira系统中添加is ...
JIRA REST API ---- JAVA -
sprcen945:
可以了,是因为没加intercept-url 的拦截, 尼玛, ...
SpringSecurity3.X--Cas client 配置 -
sprcen945:
请问为什么我配了security.xml后切入点不起作用(之前 ...
SpringSecurity3.X--Cas client 配置 -
linxingyul:
根据楼主的代码 继承了WebMvcConfigurationS ...
SpringMVC4零配置--Web上下文配置【MvcConfig】 -
java_老头:
MvcConfig.java的FilterType.ANNOT ...
SpringMVC4零配置--Web上下文配置【MvcConfig】
doxygen是用于从java源代码生成技术文档的工具,有些类似javadoc,但是比javadoc界面要漂亮许多,而且配合graphviz,可以生成带UML图表的文档。
doxygen可以通过ant插件集成到ant构建任务中,这样可以通过ant构建任务自动从最新的源代码中生成最新的文档。
看一下效果图吧:
Doxygen官网地址:http://www.stack.nl/~dimitri/doxygen/index.html
这么漂亮的文档时如何生成的呢?
一。安装
需要安装三个工具
1.graphviz linux安装参考http://hanqunfeng.iteye.com/blog/869293
2.doxygen linux安装参考http://hanqunfeng.iteye.com/blog/874154
3.doxygen的ant插件
前两个工具在windows下都有安装包,一步一步安装就行,linux安装参考所给连接即可。
这里只介绍第三个工具的安装,实际上就是一个ant的插件。
官网地址:http://sourceforge.net/projects/ant-doxygen/
目前最新版本为1.6.1
下载后解压即完成安装:
tar -zxvf ant-doxygen-bin-1.6.1.tgz --directory=ant-doxygen
其实我们要用到的就是ant-doxygen/lib/ant_doxygen.jar
二。编写ant任务
<!-- ant-doxygen lib包路径 --> <property name="ant_doxygen.lib" location="${ant_doxygen.home}/lib" /> <!-- doxygen路径 --> <property name="ant_doxygen.dir" location="${reports.dir}/doxygen" /> <taskdef name="doxygen" classname="org.doxygen.tools.DoxygenTask" classpath="${ant_doxygen.lib}/ant_doxygen.jar"/> <target name="doxygen"> <delete dir="${ant_doxygen.dir}" /> <mkdir dir="${ant_doxygen.dir}" /> <doxygen> <property name="PROJECT_NAME" value="${ant.project.name}" /> <property name="PROJECT_NUMBER" value="0.1" /> <property name="OUTPUT_DIRECTORY" value="${ant_doxygen.dir}" /> <property name="JAVADOC_AUTOBRIEF" value="YES" /> <property name="TAB_SIZE" value="4" /> <property name="OPTIMIZE_OUTPUT_JAVA" value="YES" /> <property name="INPUT" value="${src.dir}" /> <property name="RECURSIVE" value="YES" /> <property name="HAVE_DOT" value="YES" /> <property name="UML_LOOK" value="YES" /> <property name="CLASS_GRAPH" value="YES" /> <property name="COLLABORATION_GRAPH" value="YES" /> <property name="GROUP_GRAPHS" value="YES" /> <property name="DIRECTORY_GRAPH" value="YES" /> <property name="SHOW_DIRECTORIES" value="YES" /> <property name="SOURCE_BROWSER" value="YES" /> <property name="STRIP_CODE_COMMENTS" value="NO" /> <property name="GENERATE_LATEX" value="NO" /> <property name="GENERATE_TREEVIEW" value="YES" /> </doxygen> </target>
以上配置基本上可以保证生成一个比较完整的文档,关于各个属性的介绍,可以参考如下地址:
http://hi.baidu.com/zkheartboy/blog/item/8ed283cae6a06c80c8176858.html
执行这个ant任务即可自动生成文档。
三。后记
doxygen生成的文档确实比javadoc生成的文档要漂亮许多,而且可以生成uml图表,不过javadoc配合UmlGraph,也可以生成uml图表,而且通过UmlGraph还支持外部api的导航。不过doxygen比较强的的地方是其对注释格式的简单要求,以及可以在文档中显示源代码,使文档更加完成。
关于UmlGraph的介绍可以参考http://hanqunfeng.iteye.com/blog/869576
两个工具各有优势,可依据具体情况进行选择。
发表评论
-
Oracle数据库文档构造器--Oraschemadoc
2011-06-30 18:23 1482Oraschemadoc---Oracle Schema Do ... -
用SchemaSpy制作数据库结构文档
2011-02-14 16:12 2408在包含数据库的项目管理中,数据库文档是一个不可缺少的资源,一般 ... -
用UmlGraph在Javadoc中嵌入UML图表
2011-01-12 17:35 3882最近在看《Java Power Tools》,对UmlGrap ... -
hudson--构建存档
2011-01-11 11:25 1933每一次构建,hudson都会在HUDSON_HOME/jobs ... -
hudson--javadoc报告
2011-01-11 10:30 2245使用hudson可以很方便的将javadoc报告集成进来,当然 ... -
hudson--findbugs报告
2011-01-06 11:13 7031如果我们的ant构建文 ... -
hudson--构建依赖
2011-01-04 14:39 2085hudson一个比较好的功能是提供了构建依赖,就是说,一个jo ... -
hudson--环境变量
2011-01-04 14:17 4437在执行构建时,我们可以为每个JOB指定一些环境变量,方法如下: ... -
hudson--build配置
2011-01-04 11:55 3127在每个job中,我们可以指定其构建方式,比如是通过ant或ma ... -
hudson--安全设置
2011-01-01 17:44 4717hudson默认是不需要登录 ... -
hudson--junit测试报告
2010-12-31 18:46 6420如果你的项目在构建时进行了单元测试,可以在hudson中直接查 ... -
hudson--部署设置
2010-12-31 18:23 3756需要为hudson安装Deploy to container ... -
hudson--JOB_WORKSPACE
2010-12-31 18:04 2336JOB_WORKSPACE:就是构建时使用的目录,也就是从代码 ... -
hudson--构建执行顺序
2010-12-31 17:30 2320hudson的构建顺序与普通的持续集成一样,遵循着先更新代码- ... -
hudson--scp设置
2010-12-31 17:18 4190如果是远程部署,你就会需要一个scp插件,可以在hudson的 ... -
hudson--配置邮件
2010-12-31 15:52 3353如果希望在构建完成后将构建结果以邮件的形式发送给相关的用户,推 ... -
hudson--系统管理
2010-12-31 15:08 2141hudson的总体配置,都是在“系统管理”中进行配置的,hud ... -
hudson--URL选项
2010-12-31 14:11 1446hudson为我们提供了一些通过url快速执行的功能 htt ... -
hudson--HUDSON_HOME
2010-12-31 13:54 4520Hudson需要一些磁盘空间来执行构建 ... -
hudson--插件管理
2010-12-30 18:25 7510hudson的好用基本体现在其众多而强大的插件上,在“系统管理 ...
相关推荐
google 上搜了很久的关于 Doxygen 使用方法的咚咚,只不过都是英文,而且都很多的规则。实际上大家只需要告诉基本的规则就可以。下面是我对 Doxygen 的摸索 首先熟知 Doxygen 产生的文件的基本结构
doxygen是一款强大的源代码文档生成器,广泛用于各种编程语言,尤其是C、C++和C#。 【描述】提到的内容揭示了doxygen的主要功能和用途。首先,它能够处理C语言的代码,解析头文件和源文件,从中提取出函数、类、...
"用doxygen+graphviz自动化生成代码文档"是一个高效的方法,能够帮助开发者节省时间并提高工作效率。本文将详细介绍doxygen和graphviz这两个工具,以及如何结合它们来自动化地创建高质量的代码文档。 **Doxygen** ...
windows下使用doxygen为C C++程序生成中文文档 1.html文件讲解怎么使用 2.需要的一些工具 3.所需要的批处理文件 步骤: 1.阅读 使用doxygen为C/C++程序生成中文文档html文件 2.安装doxygen.rar,graphviz.rar ...
它能够自动生成源代码的API文档,帮助开发者理解和使用代码库。Doxygen的强大在于它可以解析源代码中的注释,通过特定的注释格式(如C++的`///`或Java的`/** */`),自动构建出结构化的文档,包括类图、协作图、继承...
**doxygen**是一款强大的源代码文档生成工具,广泛应用于C++、C、C#、Java、Python等编程语言。它能够自动从源代码中提取注释,并生成结构化的专业文档,帮助开发者理解和维护代码库。doxygen不仅仅适用于个人开发者...
Doxygen最新版,给源代码生成文档的利器,支持多种编程语言!
这些标记将帮助Doxygen生成结构化的文档,让读者能快速理解代码功能和使用方式。 此外,Doxygen还支持输入和输出多种格式,如HTML用于网页浏览,PDF用于打印和离线阅读,XML用于进一步处理,以及CHM(Windows帮助...
**doxygen代码文档生成工具** Doxygen是一款强大的开源文档生成工具,主要面向C++,但同时也支持其他编程语言,如C、C#、Java、Python等。它通过解析源代码中的注释,自动生成结构化的专业文档,帮助开发者理解和...
Doxygen是一个文档生成工具,它可以分析源代码中的注释,并据此生成相应的文档。Graphviz是一个图形可视化软件,它可以用来绘制各种图形,例如函数调用关系图。HtmlHelp是一个帮助文件生成器,可以将生成的文档转换...
3. **自动文档更新**:当源代码发生变化时,Doxygen可以自动检测并更新文档,确保文档始终与代码同步。 4. **多语言支持**:除了C++,Doxygen还支持C、C#、Java、Python等语言,甚至可以处理Fortran、PHP、IDL等...
C++代码文档生成器是一种工具,它能够自动分析C++源代码,并基于代码中的注释生成详细的文档。这种工具在软件开发过程中非常有用,因为它可以帮助开发者快速了解代码结构,节省了手动编写文档的时间,同时也确保了...
要使用Doxygen生成文档,需要进行三个步骤:首先,在代码中加入符合Doxygen规范的注释格式;接着,使用Doxywizard配置文档生成的相关参数;最后,通过Doxygen工具生成注释文档。在Doxywizard中,可以填写工作目录、...
Doxygen是一个广泛使用的文档生成工具,特别是在C和C++程序中,因为它可以自动从源代码中提取注释,生成文档。它能够生成多种格式的文档,比如HTML,LATEX以及RTF格式的参考手册,还有Windows平台下的.chm(compiled...
在VS代码中生成Doxygen注释 通过启动Doxygen注释块并按Enter,此VS Code扩展可以即时生成Doxygen文档。 目录 产品特点 对准 有关其工作原理,请参见 属性 析构函数 广泛的定制 档案说明 功能指针 经营者 参量 退货...
1. **自动文档生成**:Doxygen能自动识别和解析源代码结构,如类、函数、枚举、变量等,生成对应的文档页面。 2. **图表生成**:包括类图、继承图、协作图等,帮助理解项目中类与类之间的关系。 3. **自定义输出...
Doxygen是一款强大的源代码文档生成工具,它能够从C++, C#, Objective-C, Fortran, Java, IDL, PHP, Python, Ruby等多种编程语言的源代码中自动提取文档。这个压缩包“Doxygen代码注释标准.7z”包含了最新版本的...
该文档是直接从源代码中提取的,这使得使文档与源代码保持一致变得容易得多。 您可以配置 doxygen从未记录的源文件中提取代码结构。这对于在大型源代码发行版中快速找到您的方式非常有用。Doxygen还可以通过包括依赖...