Question

设置Maven生成Javadoc时，出现以下警告：

javadoc：警告-您尚未指定要使用的HTML版本。当前默认值为HTML 4.01，但是在将来的版本中它将更改为HTML5。要取消显示此警告，请使用-html4或-html5选项指定在文档注释中使用的HTML版本，并由此doclet生成。

我该怎么做？

Answer 1

为此，我在Javadoc插件的additionalOptions部分中添加了configuration：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>3.0.1</version>
            <configuration>
                <additionalOptions>-html5</additionalOptions>
            </configuration>
        </plugin>
    </plugins>
</build>

Answer 2

为此，我在配置中添加了另一个JOption

<additionalJOptions>
  <additionalJOption>-J-Dhttp.agent=maven-javadoc-plugin-${project.name}</additionalJOption>
  <additionalJOption>-html5</additionalJOption>
</additionalJOptions>

Answer 3

最好将其放入配置文件中，因为1.9以下不支持-html5：

  <profile>
        <id>javadoc-html5</id>
        <activation>
            <jdk>[1.9,)</jdk>
        </activation>
        <build>
            <pluginManagement>
                <plugins>
                    <plugin>
                        <artifactId>maven-javadoc-plugin</artifactId>
                        <configuration>
                            <additionalOptions>-html5</additionalOptions>
                        </configuration>
                    </plugin>
                </plugins>
            </pluginManagement>
        </build>
    </profile>

如何使用Maven指定Javadoc HTML版本？

3 个答案: