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

Question

使用 gradle 生成 asciidoctor 文档，您需要gradle asciidoctor在命令行中生成文档，并且此任务会生成文档。

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

Answer 1

请参阅构建生命周期简介。通常在 Maven 中，文档生成/打包绑定到site生命周期，这意味着它将在运行时创建mvn site。

下面是一个 Javadoc 示例，如何将插件绑定到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 文档）