Skip to content

A Maven plugin that uses Asciidoctor via JRuby to process AsciiDoc source files within the project.

License

Notifications You must be signed in to change notification settings

BulkSecurityGeneratorProjectV2/asciidoctor__asciidoctor-maven-plugin

This branch is 1 commit ahead of, 239 commits behind asciidoctor/asciidoctor-maven-plugin:main.

Folders and files

NameName
Last commit message
Last commit date
Jan 15, 2022
Jan 30, 2022
Jun 12, 2022
Jun 12, 2022
Jan 19, 2016
Sep 8, 2020
Jun 12, 2022
Feb 15, 2013
Jan 30, 2022
Apr 10, 2021
Jan 30, 2022
Jan 30, 2022
Jun 12, 2022

Repository files navigation

Asciidoctor Maven Plugin

Build Status (AppVeyor) Build Status (Travis CI) Build Status Coverage Status Maven Central project chat

The Asciidoctor Maven Plugin is the official way to convert your AsciiDoc documentation using Asciidoctor from an Apache Maven build.

The conversion can happen in 2 flavors:

  1. as a Maven plugin: AsciiDoc files are converted at full Asciidoctor power independently from Maven site,

  2. as a Maven site integration: AsciiDoc files are integrated with Maven reports, which comes with a few limitations (see below for details).

Full documentations is available in the USER MANUAL.

Translations of the document are available in the following languages:
📎

You’re viewing the documentation for the upcoming release. If you’re looking for the documentation for an older release, please refer to one of the following tags:
2.1.02.0.01.6.01.5.81.5.7.11.5.61.5.51.5.31.5.2.1

Quickstart

These are the minimal steps to convert your AsciiDoc documents to HTML with the asciidoctor-maven-plugin.

  1. Place your Asciidoc sources in /src/docs/asciidoc.

  2. Add the minimal configuration to your pom.xml.

    <plugin>
        <groupId>org.asciidoctor</groupId>
        <artifactId>asciidoctor-maven-plugin</artifactId>
        <version>${asciidoctor.maven.plugin.version}</version>
        <executions>
            <execution>
                <id>asciidoc-to-html</id>
                <phase>generate-resources</phase>
                <goals>
                    <goal>process-asciidoc</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
  3. Run the plugin’s associated phase.

    $ mvn generate-resources

Examples

You can find examples ready to copy-paste in the Asciidoctor Maven examples project.

Contributing

This plugin is an open source project made possible with the help of users and enthusiasts. To continue to be useful and to evolve, this plugin needs continuing contributions. There are multiple ways where you can help:

  • join the discussions

  • give feedback on ideas

  • report issue

  • test new releases

  • contribute source code to fix issues or add new functionality

  • write documentation

The Contributor Guide will help you start with the code.

Copyright © 2013-2020 Jason Porter, Dan Allen, Abel Salgado Romero and the individual contributors. Use of this software is granted under the terms of the Apache License, Version 2.0.

See the LICENSE for the full license text.

About

A Maven plugin that uses Asciidoctor via JRuby to process AsciiDoc source files within the project.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 98.3%
  • Groovy 1.6%
  • Other 0.1%