UmlGraph没有自动集成在JavaDoc中

Question

我正在使用maven和maven-javadoc-plugin和umlgraph-doclet为我的项目创建javadoc.我的pom部分:

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-site-plugin</artifactId>
      <inherited>false</inherited>
      <configuration>
        <reportPlugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.8</version>
            <configuration>
              <show>public</show>
              <quiet>true</quiet>

              <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
              <docletArtifact>
                <groupId>org.umlgraph</groupId>
                <artifactId>doclet</artifactId>
                <version>5.1</version>
              </docletArtifact>

              <useStandardDocletOptions>true</useStandardDocletOptions>
              <additionalparam>
                -inferrel -inferdep -quiet -hide java.* -hide org.eclipse.* -collpackages java.util.* -postfixpackage
                -nodefontsize 9 -nodefontpackagesize 7 -attributes -types -visibility -operations -constructors
                -enumerations -enumconstants -views
              </additionalparam>
            </configuration>
            <reportSets>
              <reportSet>
                <reports>
                  <report>aggregate</report>
                </reports>
              </reportSet>
            </reportSets>
          </plugin>
        </reportPlugins>
      </configuration>
    </plugin>
  </plugins>
</build>

生成图像并且看起来很好,当使用jdk1.6构建javadoc时,它们会自动集成到所有javadoc页面中.但是当使用jdk1.7构建时,图像仍然会被创建但不在javadoc页面内.即使在官方网站上使用v5.4,javadoc也是无图像的.并且maven的调试输出也没有提供任何线索.最重要的是,没有办法通过邮件联系其中一个UmlGraph开发者.

任何人都可以在这里给我一些建议,或者有一些想法如何解决这个问题？

Answer 1

更新:版本5.6.6现在位于maven central.我用JDK 7构建,图表看起来不错.

<plugin>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.7</version>
    <configuration>
        <aggregate>true</aggregate>
        <show>private</show>
        <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
        <docletArtifact>
            <groupId>org.umlgraph</groupId>
            <artifactId>umlgraph</artifactId>
            <version>5.6.6</version>
        </docletArtifact>
    </configuration>
</plugin>

Answer 2

我检查了可能性,情况如下:

• UmlGraph中的相关错误已经修复:https://github.com/dspinellis/UMLGraph/pull/8
• 然而问题是,尚未发布包含修复的UmlGraph的稳定版本

然而,好消息是存在包含修复程序的快照存储库:https://oss.sonatype.org/content/repositories/snapshots/org/umlgraph/umlgraph/5.5.8-SNAPSHOT/

因此,您需要将jar文件放到本地存储库中(具体取决于您的基础结构设置):

• 通过向您的环境添加reffered存储库
• 或者通过导入您当地的仓库(http://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html)

之后更新:

<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
<docletArtifact>
            <groupId>org.umlgraph</groupId>
            <artifactId>doclet</artifactId>
            <version>5.1</version>
</docletArtifact>

以下(命名约定已更改):

<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
<docletArtifact>
    <groupId>org.umlgraph</groupId>
    <artifactId>umlgraph</artifactId>
    <version>5.5.8-SNAPSHOT</version>
</docletArtifact>