0

在 Maven 站点构建中,我想生成一个聚合的 Javadoc 报告,其中包含指向其他 Javadocs 的链接(detectLinks = true)。

在我在报告部分定义的父 POM 之一中:

<reporting>
    <plugins>
        ...
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.9</version> 
            <reportSets>
                <reportSet>
                    <id>default</id>
                    <configuration>
                        <detectOfflineLinks>true</detectOfflineLinks>
                    </configuration>
                    <reports>
                        <report>javadoc</report>
                    </reports>
                </reportSet>
                <reportSet>
                    <id>aggregate</id>
                    <reports>
                        <report>aggregate</report>
                    </reports>
                </reportSet>
            </reportSets>
            <configuration>
                <detectLinks>true</detectLinks>
            </configuration>
        </plugin>
    </plugins>
</reporting>

多模块聚合器项目的有效 POM 报告部分是:

  <reporting>
    <outputDirectory>someDir</outputDirectory>
    <plugins>
      ...
      <plugin>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <reportSets>
          <reportSet>
            <reports>
              <report>javadoc</report>
            </reports>
            <configuration>
              <detectOfflineLinks>true</detectOfflineLinks>
              <detectLinks>true</detectLinks>
            </configuration>
          </reportSet>
          <reportSet>
            <id>aggregate</id>
            <reports>
              <report>aggregate</report>
            </reports>
            <configuration>
              <detectLinks>true</detectLinks>
            </configuration>
          </reportSet>
        </reportSets>
        <configuration>
          <detectLinks>true</detectLinks>
        </configuration>
      </plugin>
    </plugins>
  </reporting>

尽管如此,detectLinks 仅适用于单个 Javadoc 报告,而不适用于聚合的 Javadoc 报告。

如何为聚合的 Javadoc 报告启用检测链接?

4

1 回答 1

1

问题是聚合目标只检查根项目的依赖关系,而不是模块。刚刚创建了一个补丁问题:http: //jira.codehaus.org/browse/MJAVADOC-390

临时解决方案可以是在根项目上声明您的依赖项......但它很难看

——瓦祖尔

于 2014-04-01T12:11:06.573 回答