Question

我需要从一个存在于Maven依赖项中的接口继承Javadoc。为了继承文档，我在模块中添加了对javadoc插件的覆盖。我把它放在POM的<reporting>部分，因为我想生成Javadoc作为mvn site目标的一部分。

我的问题是转向<includeDependencySources>意味着指定的依赖项的源是作为我的模块的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>

Answer 1

我没有发现任何线索，这可以在Maven网站插件的页面上实现。

但是，请参阅Apache Maven Site Plugin / FAQ, How do I Integrate static (X)HTML pages into my Maven site?：

您可以按照以下步骤集成静态页面：



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

中

创建site.xml并将其放入${basedir}/src/site



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

来自Maven依赖的Javadoc继承

1 个答案: