Add SpringBoot guide and update example
MODIFY
CHANGELOG.adoc
CHANGELOG.adoc
@@ -18,6 +18,10 @@ Build Improvement::
* Fix URL for distribution in sdkman (#990)
* Update gradle plugin biz.aQute.bnd to 5.2.0 (#991)
+Documentation::
+
+* Add Spring Boot integration test and usage guide (@abelsromero) (#994, #995)
+
== 2.4.3 (2021-02-12)
Improvement::

MODIFY
asciidoctorj-springboot-integration-test/springboot-app/build.gradle
asciidoctorj-springboot-integration-test/springboot-app/build.gradle
@@ -25,7 +25,6 @@ dependencies {
}
bootJar {
- requiresUnpack '**/jruby-complete-*.jar'
requiresUnpack '**/asciidoctorj-*.jar'
}

MODIFY
docs/modules/guides/nav.adoc
docs/modules/guides/nav.adoc
** Running in Frameworks
*** xref:run-in-osgi.adoc[]
*** xref:run-in-wildfly.adoc[]
+*** xref:run-with-springboot.adoc[]
** xref:access-jruby-instance.adoc[]
** xref:load-ruby-library.adoc[]
** xref:gem-path.adoc[]

ADD
docs/modules/guides/pages/run-with-springboot.adoc
+= Running AsciidoctorJ with Spring Boot
+:url-springboot-docs: https://docs.spring.io/spring-boot/docs/current
+
+Due to Spring Boot's packaging system, Asciidoctorj won't work out of the box from a single JAR application.
+Luckily SpringBoot plugins for Gradle and Maven provide options to fix it.
+
+== Gradle configuration
+
+You just need to add the following configuration to your Gradle build.
+
+
+```groovy
+bootJar {
+ requiresUnpack '**/asciidoctorj-*.jar'
+}
+```
+
+For full details, check the official {url-springboot-docs}/gradle-plugin/reference/htmlsingle/#packaging-executable-configuring-unpacking[Spring Boot Gradle Plugin documentation].
+
+== Maven configuration
+
+Similarly, for the Maven plugin add the following configuration to your POM.
+
+```xml
+<plugin>
+ <groupId>org.springframework.boot</groupId>
+ <artifactId>spring-boot-maven-plugin</artifactId>
+ <configuration>
+ <requiresUnpack>
+ <dependency>
+ <groupId>org.asciidoctor</groupId>
+ <artifactId>asciidoctorj</artifactId>
+ </dependency>
+ </requiresUnpack>
+ </configuration>
+</plugin>
+```
+
+For full details, check the official {url-springboot-docs}/maven-plugin/reference/htmlsingle/#goals-repackage[Spring Boot Maven Plugin documentation].
+
+

Add SpringBoot guide and update example