javadoc maven_Maven Fluido Skin和Javadoc类图

javadoc maven

我使用Maven网站已有一段时间了，对此我感到非常满意。我不想在Maven 3之后更新我的项目，但是没关系，Maven 3带来了许多新奇的东西。但是，有两件事使我感到烦恼：缺乏美观和现代的外观，以及浏览复杂代码的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作为默认值）：

Maven Fluido皮肤
tap4j
TestLink Java API

关于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 ）：