Question

我知道如何通过SBT：Where does scaladoc look for the rootdoc.txt to create the root doc执行此操作，但是无法使用Maven来解决。由于SBT的缺陷，我无法将SBT用于一般版本。

在http://davidb.github.io/scala-maven-plugin/example_doc.html之后，我的pom.xml中包含以下内容

        <plugin>
            <groupId>net.alchim31.maven</groupId>
            <artifactId>scala-maven-plugin</artifactId>
            <version>3.4.4</version>
            <executions>
                <execution>
                    <configuration>
                        <args>
                            <arg>-doc-root-content rootdoc.txt</arg>
                        </args>
                        <jvmArgs>
                            <jvmArg>-Xms1024m</jvmArg>
                            <jvmArg>-Xmx4096m</jvmArg>
                        </jvmArgs>
                    </configuration>
                </execution>
            </executions>
        </plugin>

和

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-site-plugin</artifactId>
            <version>3.0</version>
            <configuration>
                <reportPlugins>
                    <plugin>
                        <artifactId>maven-project-info-reports-plugin</artifactId>
                        <version>2.2</version>
                    </plugin>
                    <plugin>
                        <groupId>net.alchim31.maven</groupId>
                        <artifactId>scala-maven-plugin</artifactId>
                        <version>3.4.4</version>
                        <configuration>
                            <args>
                                <arg>-doc-root-content rootdoc.txt</arg>
                            </args>
                            <jvmArgs>
                                <jvmArg>-Xms64m</jvmArg>
                                <jvmArg>-Xmx1024m</jvmArg>
                            </jvmArgs>
                        </configuration>
                    </plugin>
                    ...
                </reportPlugins>
            </configuration>
        </plugin>

最好包括API文档的根文档，而不必使用SBT来生成文档。

Answer 1

<arg>应该只包含一个参数，而不是2。尝试

                    <args>
                        <arg>-doc-root-content<arg>
                        <arg>rootdoc.txt</arg>
                    </args>

注意：idem为SBT，带有2个字符串：

scalacOptions in Compile ++= Seq("-doc-root-content", "rootdoc.txt")

更新：

示例已更新https://github.com/davidB/scala-maven-plugin/blob/master/src/it/test_goal_doc/pom.xml
更多详细信息，请访问https://github.com/davidB/scala-maven-plugin/issues/305

我如何配置Maven在scaladoc报告中使用'rootdoc.txt'？

1 个答案: