Maven Fluido Skin和Javadoc类图

我使用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 ）：

玩得开心！ 并记住检查您的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