Class AsciidocMojo

java.lang.Object
network.ike.docs.plugin.AsciidocMojo
All Implemented Interfaces:
org.apache.maven.api.plugin.Mojo
@Mojo(name="asciidoc", defaultPhase="generate-resources") public class AsciidocMojo extends Object implements org.apache.maven.api.plugin.Mojo
Generate documentation from AsciiDoc sources using AsciidoctorJ.

Replaces asciidoctor-maven-plugin with a single goal that handles multiple backends in one execution. Extensions (Koncept inline macro, glossary postprocessor) are registered programmatically with backend-aware safety — the Prawn PDF backend does not receive postprocessor extensions that would crash JRuby.

Output validation is built in: unresolved attributes, missing includes, broken cross-references, and missing images are detected and optionally fail the build.

Usage: 

<execution>
    <id>generate-docs</id>
    <goals><goal>asciidoc</goal></goals>
    <configuration>
        <skipHtml>false</skipHtml>
        <skipPrawn>false</skipPrawn>
        <validate>true</validate>
    </configuration>
</execution>

  • Constructor Details

    • AsciidocMojo

      public AsciidocMojo()
      Creates this goal instance.

  • Method Details

    • getLog

      protected org.apache.maven.api.plugin.Log getLog()
      Access the Maven logger.
      Returns:
      the logger

    • execute

      public void execute() throws org.apache.maven.api.plugin.MojoException
      Specified by:
      execute in interface org.apache.maven.api.plugin.Mojo
      Throws:
      org.apache.maven.api.plugin.MojoException