在 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 报告启用检测链接?