javadoc maven
但是,世界上充满了优秀的人才! 就像来自99soft的家伙一样 。 他们创建了Maven Fluido Skin ,并将其捐赠给Apache Software Foundation 。 它建立在Twitter的Bootstrap之上,可以从Maven中央存储库中获得。 为了在Maven项目中使用它,您要做的就是将以下设置添加到src / site / site.xml中:
<skin>
<groupId>org.apache.maven.skins</groupId>
<artifactId>maven-fluido-skin</artifactId>
<version>1.2.1</version>
</skin>
这是一些使用Maven Fluido Skin的项目的列表(希望在不久的将来Apache Commons和其他项目也将采用此skin作为默认值):
关于Javadoc浏览,也有一个不错的技巧:添加类图。 我在Apache Commons邮件列表中看到了一个新的Javadoc模板,但这是一个正在进行的工作,因此,现在我将继续使用类图。 当您使用graphviz执行Javadoc或站点目标时,将生成这些图。 还有更多。 您可以单击图类,因为它们具有指向它们所引用的Java类的链接。
您可以在Apache Maven网站上找到有关设置图生成的说明,或查看示例 (我更喜欢后者)。 但基本上,您将需要安装graphviz,并且在项目pom.xml中需要类似以下XML片段的内容。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.7</version>
<configuration>
<doclet>gr.spinellis.umlgraph.doclet.UmlGraphDoc</doclet>
<docletArtifact>
<groupId>gr.spinellis</groupId>
<artifactId>UmlGraph</artifactId>
<version>4.4</version>
</docletArtifact>
<additionalparam>
-inferrel -inferdep -quiet -hide java.*
-collpackages java.util.* -qualify
-postfixpackage -nodefontsize 9
-nodefontpackagesize 7
-edgefontname 'Trebuchet MS'
-nodefontabstractname 'Trebuchet MS'
-nodefontclassabstractname
'Trebuchet MS'
-nodefontclassname 'Trebuchet MS'
-nodefontname
'Trebuchet MS'
-nodefontpackagename 'Trebuchet MS'
-nodefonttagname
'Trebuchet MS'
</additionalparam>
</configuration>
</plugin>
这是一个图的样子(来源: http : //tap4j.org/apidocs/index.html ):
玩得开心! 并记住检查您的CI机器是否也安装了graphviz,否则Javadoc页面中将包含404。
祝您编程愉快,别忘了分享!
参考: Maven站点提示: Kinoshita博客博客中来自JCG合作伙伴 Bruno Kinoshita的Maven Fluido Skin和Javadoc类图 。
翻译自: https://www.javacodegeeks.com/2012/10/maven-fluido-skin-and-javadoc-class.html
javadoc maven