Maven依赖中的Javadoc继承

Question

我需要继承一个存在于Maven依赖中的接口的Javadoc。为了继承文档，我在我的模块中添加了Javadoc插件的重写。我将它放在POM文件的部分，因为我想将Javadoc作为mvn site目标的一部分生成。

我的问题在于，打开选项意味着指定的依赖项源代码将被作为我的模块的Javadoc的一部分生成，这是不希望发生的。是否有一种方法可以在不生成依赖项源代码的Javadoc的情况下继承依赖项源代码的文档？

<reporting>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.9</version>
            <configuration combine.self="append">
                <source>${jdkVersion}</source>
                <includeDependencySources>true</includeDependencySources>
                <includeTransitiveDependencySources>false</includeTransitiveDependencySources>
                <dependencySourceIncludes>
                    <dependencySourceInclude>com.mysource.object:*</dependencySourceInclude>
                    <dependencySourceInclude>com.mysource.object2:*</dependencySourceInclude>
                    <dependencySourceInclude>com.mysource.common:*</dependencySourceInclude>
                </dependencySourceIncludes>
            </configuration>
            <reportSets>
                <reportSet>
                    <reports>
                        <report>javadoc</report>
                    </reports>
                </reportSet>
            </reportSets>
        </plugin>
    </plugins>
</reporting>

- Lisa Jenkins

---

一项修正：在 mvn site 中，site 不是一个目标，而是 Maven 站点生命周期 的一个 _阶段_（尽管默认绑定到此阶段的是 maven-site-plugin 的 site 目标，缩写为 site）。 - Gerold Broser

Answer 1

我在Maven Site Plugin的页面上没有找到任何线索表明这是可能的。

然而，请查看Apache Maven Site Plugin / FAQ，如何将静态（X）HTML页面集成到我的Maven站点中？：

您可以通过以下步骤集成静态页面：

• 将静态页面放在资源目录中：${basedir}/src/site/resources

• 创建您的site.xml并将其放在${basedir}/src/site中

• 通过修改菜单部分链接到静态页面，创建项目并将它们映射到静态页面的文件名

- Gerold Broser