使用maven生成asciidoctor文檔，並使用maven（不是gradle）

Question

使用gradle生成asciidoctor文檔，您需要在命令行中輸入gradle asciidoctor，此文檔由此任務生成。

有了maven，我可以用mvn package生成asciidoctor文檔。但是這個包裹了所有的項目。有沒有辦法只使用mvn來生成文檔而不打包所有項目？

Answer 1

請參閱Introduction to the Build Lifecycle。通常在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 documentation截取）