spring - 使用 maven(不是 gradle)生成带有 spring rest docs 的 asciidoctor doc

Question

使用 gradle 生成 asciidoctor 文档，您需要 gradle asciidoctor在命令行中，文档由该任务生成。

使用 maven，我可以使用 mvn package 生成 asciidoctor 文档。 .但这包含了所有项目。有没有办法使用mvn只是为了生成文档而不打包所有项目？

Answer 1

见 Introduction to the Build Lifecycle .通常在 Maven 中，文档生成/打包绑定(bind)到 site生命周期，这意味着它将在运行时创建 mvn site .

这是一个 Javadoc 示例，如何将插件绑定(bind)到 site阶段:

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <phase>site</phase>
      <goals>
        <goal>jar</goal>
      </goals>
      <configuration>
      ...
      </configuration>
    </plugin>
  </plugins>
</build>

也可以直接使用asciidoctor-maven-plugin :

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-site-plugin</artifactId>
            <version>3.4</version>
            <dependencies>
                <dependency>
                    <groupId>org.asciidoctor</groupId>
                    <artifactId>asciidoctor-maven-plugin</artifactId>
                    <version>{release-version}</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

(取自 asciidoctor documentation )