Set up tabs in asciidoctor

Author: mattbertolini

docs/build.gradle.kts

@@ -2,14 +2,20 @@ import org.asciidoctor.gradle.jvm.AsciidoctorTask
 
 plugins {
     id("com.mattbertolini.buildlogic.java-conventions")
-    alias(libs.plugins.asciidoctor)
+    alias(libs.plugins.asciidoctorConvert)
+}
+
+configurations {
+    register("asciidoctorExt")
 }
 
 dependencies {
     implementation(project(":spring-webmvc-annotated-data-binder"))
     implementation(project(":spring-webflux-annotated-data-binder"))
     implementation(libs.javaxServletApi) // Version defined in Spring BOM file
 
+    add("asciidoctorExt", libs.springAsciidoctorExtBlockSwitch)
+
     testImplementation(libs.junitJupiterApi)
     testImplementation(libs.assertJCore)
     testImplementation(libs.mockitoCore)
@@ -23,6 +29,7 @@ tasks.named<AsciidoctorTask>("asciidoctor").configure {
         "resourcesDir" to project.sourceSets["main"].resources.srcDirs.first(),
         "source-highlighter" to "coderay"
     ))
+    configurations("asciidoctorExt")
 }
 
 tasks.named<JacocoReport>("jacocoTestReport").configure {

docs/src/docs/asciidoc/main.adoc

@@ -5,7 +5,30 @@
 :sourceDir: ../../../src/main/java
 :resourcesDir: ../../../src/main/resources
 
+== Installation
+To install:
 
+[source,xml,indent=0,role="primary",subs="+attributes"]
+.Maven
+----
+<dependency>
+    <groupId>com.mattbertolini</groupId>
+    <artifactId>spring-webmvc-annotated-data-binder</artifactId>
+    <version>{revnumber}</version>
+</dependency>
+----
+
+[source,kotlin,indent=0,role="secondary",subs="+attributes"]
+.Gradle (Kotlin DSL)
+----
+implementation("com.mattbertolini:spring-webmvc-annotated-data-binder:{revnumber}")
+----
+
+[source,groovy,indent=0,role="secondary",subs="+attributes"]
+.Gradle (Groovy DSL)
+----
+implementation 'com.mattbertolini:spring-webmvc-annotated-data-binder:{revnumber}'
+----
 
 == Configuration
 

libs.versions.toml

@@ -19,6 +19,8 @@ springWebmvc = { module = "org.springframework:spring-webmvc", version.ref = "sp
 springBootStarter = { module = "org.springframework.boot:spring-boot-starter", version.ref = "springBoot" }
 springBootTest = { module = "org.springframework.boot:spring-boot-test", version.ref = "springBoot" }
 
+springAsciidoctorExtBlockSwitch = { module = "io.spring.asciidoctor:spring-asciidoctor-extensions-block-switch", version = "0.6.1" }
+
 glassfishJavaxEl = { module = "org.glassfish:javax.el", version = "3.0.1-b12" } # Needed by Hibernate Validator
 hibernateValidator = { module = "org.hibernate.validator:hibernate-validator", version = "6.0.21.Final" }
 jacksonDatabind = { module = "com.fasterxml.jackson.core:jackson-databind", version = "2.12.7.1" }
@@ -30,5 +32,5 @@ equalsVerifier = { module = "nl.jqno.equalsverifier:equalsverifier", version = "
 hamcrest = { module = "org.hamcrest:hamcrest", version = "2.2" }
 
 [plugins]
-asciidoctor = { id = "org.asciidoctor.jvm.convert", version = "2.4.0" }
+asciidoctorConvert = { id = "org.asciidoctor.jvm.convert", version = "3.3.2" }
 sonarqube = { id = "org.sonarqube", version = "4.2.0.3129" }