Генерируйте документ с асцидоктором с документами по весеннему отдыху, используя Maven (не Gradle)

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>

Вы также можете напрямую использовать https://github.com/asciidoctor/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>

(взято из асиидоакторной документации)