UmlGraph не интегрируется автоматически в JavaDoc - PullRequest
Новая
       1

UmlGraph не интегрируется автоматически в JavaDoc

3 голосов
/ 23 декабря 2011

Я использую maven и maven-javadoc-плагин с umlgraph-doclet для создания javadoc для моего проекта. Часть из моего пом: 

<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>

Изображения генерируются и выглядят хорошо, при сборке javadoc с jdk1.6 они автоматически интегрируются во все страницы javadoc. Но при сборке с jdk1.7 изображения все еще создаются, но не находятся внутри страниц javadoc. Даже при использовании v5.4 с официального сайта, Javadoc не имеет изображения. И выходные данные отладки maven также не дают никакой подсказки. Кроме того, невозможно связаться с одним из разработчиков UmlGraph по почте.

Кто-нибудь может дать мне какой-нибудь совет или есть идеи, как это исправить?

Ответы [ 4 ]

11 голосов
/ 04 сентября 2013

Обновление: версия 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>
6 голосов
/ 06 декабря 2012

Я проверил возможности, и ситуация следующая:.

  • соответствующая ошибка в UmlGraph уже исправлена: https://github.com/dspinellis/UMLGraph/pull/8
  • проблема, однако, в том, что еще не выпущена стабильная версия UmlGraph, которая включала бы исправление

Однако хорошая новость заключается в том, что существует репозиторий снимков, содержащий исправление: https://oss.sonatype.org/content/repositories/snapshots/org/umlgraph/umlgraph/5.5.8-SNAPSHOT/

Для этого вам необходимо загрузить файл JAR в локальный репозиторий (в зависимости от настроек вашей инфраструктуры):

последующее обновление: 

<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>
2 голосов
/ 18 февраля 2012

UmlGraphDoc версия 5.4, изменяющая предупреждение javadocs, не может найти строку, соответствующую шаблону '/ H2'

HTML-код просто отличается.

Java7 JavaDocs НАЧАЛО ДАННЫХ КЛАССА h2 title= "бла-бла

Java6 JavaDocs НАЧАЛО ДАННЫХ КЛАССА H2

Вы можете декомпилировать и изменить UmlGraphDoc.java

1 голос
/ 10 января 2012

У меня такая же проблема.Я думаю, что это ошибка:

https://issues.jboss.org/browse/APIVIZ-10

...