匯總文檔的maven-javadoc-plugin目標目錄

Question

我有一個關於聚合javadocs的目標目錄的問題。

我所擁有的是：

一個包含多個模塊的Maven項目。 看起來有點像這里的例子

Project
  |-- directory_to_contain_docs/
  |-- pom.xml
  |-- Module1
  |   `-- pom.xml
  |-- Module2
  |   `-- pom.xml
  `-- Module3
    `-- pom.xml

我無法完成使javadoc在名為“ directory_to_contain_docs”的目錄中生成文檔的工作。

這是我嘗試的：

我稱這一代為“ mvn javadoc：aggregate ”。 這是pom.xml的一部分：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.10.4</version>
            <configuration>
                <!-- Default configuration for all reports -->
                <failOnError>false</failOnError>

                <destDir>${basedir}/directory_to_contain_docs</destDir>
                <!-- as there are lots of incorrectly documented sources -->
                <additionalparam>-Xdoclint:none</additionalparam>
            </configuration>
            <executions>
                <execution>
                    <id>aggregate</id>
                    <goals>
                        <goal>aggregate</goal>
                    </goals>
                    <phase>site</phase>
                    <configuration>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

javadoc總是在{project} / target / site / apidocs中生成，該生成會在該目錄下的destDir中創建完整路徑。 我正在尋找一種將整個文檔放在其他地方的方法。

有機會實現這一目標嗎？

謝謝石ido

Answer 1

不知道為什么我沒有看到它。缺少的鏈接是configuration/reportOutputDirectory 。 它指定生成文檔的目錄。 可以由destDir進一步指定。