anchor.diff:  = Asciidoctor Maven Plugin
  -:asciidoc-url: http://asciidoc.org
  -:asciidoctor-url: http://asciidoctor.org
  -:issues: https://github.com/asciidoctor/asciidoctor-maven-plugin/issues
  -:maven-url: http://maven.apache.org
  -:asciidoctor-maven-examples: https://github.com/asciidoctor/asciidoctor-maven-examples
  -:project-full-path: asciidoctor/asciidoctor-maven-plugin
  -
  +// Metadata
  +:release-version: 1.5.2
  +// Settings
  +:page-layout: base
  +:idprefix:
  +:idseparator: -
  +:toc: preamble
  +ifdef::env-github[:badges:]
  +// URIs
  +:project-repo: asciidoctor/asciidoctor-maven-plugin
  +:uri-asciidoc: http://asciidoc.org
  +:uri-asciidoctor: http://asciidoctor.org
  +:uri-examples: https://github.com/asciidoctor/asciidoctor-maven-examples
  +:uri-maven: http://maven.apache.org
  +
  +ifdef::badges[]
   image:https://ci.appveyor.com/api/projects/status/chebmu91f08dlmsc/branch/master?svg=true["Build Status (AppVeyor)", link="https://ci.appveyor.com/project/asciidoctor/asciidoctor-maven-plugin"]
   image:http://img.shields.io/travis/asciidoctor/asciidoctor-maven-plugin/master.svg["Build Status (Travis CI)", link="https://travis-ci.org/asciidoctor/asciidoctor-maven-plugin"]
  -image:http://img.shields.io/coveralls/{project-full-path}/master.svg["Coverage Status", link="https://coveralls.io/r/{project-full-path}?branch=master"]
  -
  -The Asciidoctor Maven Plugin is the official means of using {asciidoctor-url}[Asciidoctor] to render all your {asciidoc-url}[AsciiDoc] documentation using {maven-url}[Apache Maven].
  +image:http://img.shields.io/coveralls/{project-repo}/master.svg["Coverage Status", link="https://coveralls.io/r/{project-repo}?branch=master"]
  +endif::[]
  +
  +The Asciidoctor Maven Plugin is the official way to convert your {uri-asciidoc}[AsciiDoc] documentation using {uri-asciidoctor}[Asciidoctor] from an {uri-maven}[Apache Maven] build.
   
   == Installation
   
  -As this is a typical Maven plugin, there isn't much to do to use it, simply add it to your plugins section in your pom:
  -
  -[source,xml]
  -.Plugin declaration
  -----
  -...
  +As this is a typical Maven plugin, simply declare the plugin in the `<plugins>` section of your POM file:
  +
  +[source,xml,subs=attributes+]
  +.Plugin declaration in pom.xml
  +----
   <plugins>
  -  <plugin>
  -    <groupId>org.asciidoctor</groupId>
  -    <artifactId>asciidoctor-maven-plugin</artifactId>
  -    <version>${asciidoctor.version}</version>                   <1>
  -    ...
  -  </plugin>
  +    <plugin>
  +        <groupId>org.asciidoctor</groupId>
  +        <artifactId>asciidoctor-maven-plugin</artifactId>
  +        <version>{release-version}</version> <!--1-->
  +        ...
  +    </plugin>
   </plugins>
  -...
  -----
  -
  -<1> As this plugin tracks the version of asciidoctor, you can use whichever version of asciidoctor you prefer
  +----
  +<1> As this plugin tracks the version of Asciidoctor, you can use whichever version of Asciidoctor you prefer.
   
   == Usage
   
   [source,xml]
   .Execution setup
   ----
  -...
  -  <plugin>
  +<plugin>
       ...
       <executions>
  -      <execution>
  -        <id>output-html</id>                                    <1>
  -        <phase>generate-resources</phase>                       <2>
  -        <goals>
  -          <goal>process-asciidoc</goal>                         <3>
  -        </goals>
  -      </execution>
  +        <execution>
  +            <id>output-html</id>              <!--1-->
  +            <phase>generate-resources</phase> <!--2-->
  +            <goals>
  +                <goal>process-asciidoc</goal> <!--3-->
  +            </goals>
  +        </execution>
       </executions>
  -    ...
  -  </plugin>
  -...
  -----
  -
  +</plugin>
  +----
   <1> This is simply an unique id for the execution
   <2> The asciidoctor-maven-plugin does not run in a specific phase, so one must be specified
  -<3> The (only for the moment) asciidoctor maven plugin goal
  +<3> The (only for the moment) Asciidoctor Maven plugin goal
   
   === Configuration options
   
  
positive.code:         <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-site-plugin</artifactId>
              <version>3.2</version>
              <dependencies>
                  <dependency>
                      <groupId>org.asciidoctor</groupId>
                      <artifactId>asciidoctor-maven-plugin</artifactId>
                      <version>${asciidoctor.version}</version>
                  </dependency>
              </dependencies>
          </plugin>
  
negative.code: 
   mvn clean test
  
  Or any of the other goals which run tests.
  
  NOTE: If I can figure out a good way to setup a Ruby testing environment I'll do that as well, but none exists at this time.
  
  == Tips & Tricks
  
  === Generate your documentation in separate folders per version
  
  [source, xml]
  -----
  <configuration>
      ...
      <outputDirectory>target/generated-docs/${project.version}</outputDirectory>
      ...
  </configuration>
  -----
  
  === Enable section numbering
  
  [source, xml]
  -----
  <configuration>
      ...
      <attributes>
          ...
          <sectnums>true</sectnums>
          ...
      </attributes>
      ...
  </configuration>
  -----
  