From a17771fef2a7e5978cde6ee2f0581139b60aa728 Mon Sep 17 00:00:00 2001
From: Greg Turnquist <gturnquist@pivotal.io>
Date: Tue, 3 Mar 2020 11:58:30 -0600
Subject: [PATCH] Migrate to Spring Docs asciidoctor plugins.

Resolves #149.
---
 pom.xml                      | 231 ++++++++++++++++++++++++++++++++---
 src/main/asciidoc/index.adoc |   6 +-
 2 files changed, 217 insertions(+), 20 deletions(-)

diff --git a/pom.xml b/pom.xml
index ba4af97..59213a6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 
 	<groupId>org.springframework.session</groupId>
@@ -68,7 +69,7 @@
 	<properties>
 		<source.level>1.8</source.level>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-		
+
 		<assertj.version>3.13.1</assertj.version>
 		<flapdoodle.version>2.2.0</flapdoodle.version>
 		<jackson-bom.version>2.10.0</jackson-bom.version>
@@ -127,7 +128,7 @@
 											</excludes>
 											<searchTransitive>true</searchTransitive>
 										</bannedDependencies>
-										<dependencyConvergence />
+										<dependencyConvergence/>
 									</rules>
 									<fail>true</fail>
 								</configuration>
@@ -141,8 +142,53 @@
 		<profile>
 			<id>distribute</id>
 
+			<properties>
+				<docs.resources.version>0.1.2.RELEASE</docs.resources.version>
+				<shared.resources>${project.build.directory}/shared-resources</shared.resources>
+				<generated-asciidoc-sources.directory>${project.build.directory}/generated-asciidoc-sources/source/
+				</generated-asciidoc-sources.directory>
+				<generated-docs.directory>${project.build.directory}/generated-docs</generated-docs.directory>
+				<maven.main.skip>true</maven.main.skip>
+				<maven.test.skip>true</maven.test.skip>
+				<maven.kotlin.skip>true</maven.kotlin.skip>
+				<maven.install.skip>true</maven.install.skip>
+				<maven.deploy.skip>true</maven.deploy.skip>
+				<skipTests>true</skipTests>
+			</properties>
+
+			<dependencies>
+				<dependency>
+					<groupId>io.spring.docresources</groupId>
+					<artifactId>spring-doc-resources</artifactId>
+					<version>${docs.resources.version}</version>
+					<type>zip</type>
+					<optional>true</optional>
+				</dependency>
+			</dependencies>
+
 			<build>
 				<plugins>
+					<plugin>
+						<groupId>org.apache.maven.plugins</groupId>
+						<artifactId>maven-dependency-plugin</artifactId>
+						<executions>
+							<execution>
+								<id>unpack-doc-resources</id>
+								<goals>
+									<goal>unpack-dependencies</goal>
+								</goals>
+								<phase>generate-resources</phase>
+								<configuration>
+									<includeGroupIds>io.spring.docresources</includeGroupIds>
+									<includeArtifactIds>spring-doc-resources</includeArtifactIds>
+									<includeTypes>zip</includeTypes>
+									<excludeTransitive>true</excludeTransitive>
+									<outputDirectory>${generated-asciidoc-sources.directory}</outputDirectory>
+								</configuration>
+							</execution>
+						</executions>
+					</plugin>
+
 					<plugin>
 						<groupId>org.apache.maven.plugins</groupId>
 						<artifactId>maven-source-plugin</artifactId>
@@ -156,6 +202,7 @@
 							</execution>
 						</executions>
 					</plugin>
+
 					<plugin>
 						<artifactId>maven-javadoc-plugin</artifactId>
 						<configuration>
@@ -170,10 +217,105 @@
 							</execution>
 						</executions>
 					</plugin>
+
+					<plugin>
+						<groupId>org.apache.maven.plugins</groupId>
+						<artifactId>maven-antrun-plugin</artifactId>
+						<version>1.8</version>
+						<executions>
+
+							<execution>
+								<id>copy-documentation-resources</id>
+								<phase>generate-resources</phase>
+								<configuration>
+									<target>
+										<copy todir="target/site/reference/html/images">
+											<fileset dir="${basedir}/src/main/asciidoc" erroronmissingdir="false">
+												<include name="**/*.png"/>
+												<include name="**/*.gif"/>
+												<include name="**/*.jpg"/>
+											</fileset>
+											<flattenmapper/>
+										</copy>
+									</target>
+								</configuration>
+								<goals>
+									<goal>run</goal>
+								</goals>
+							</execution>
+
+							<execution>
+								<id>create-generated-docs-resources</id>
+								<phase>process-resources</phase>
+								<configuration>
+									<target>
+										<copy failonerror="false" todir="${generated-asciidoc-sources.directory}/">
+											<fileset dir="src/main/asciidoc" includes="**/*.adoc"/>
+										</copy>
+										<copy failonerror="false"
+											  todir="${generated-asciidoc-sources.directory}/images/">
+											<fileset dir="src/main/asciidoc/images"/>
+										</copy>
+
+										<copy todir="${generated-docs.directory}">
+											<fileset dir="${generated-asciidoc-sources.directory}">
+												<include name="css/**"/>
+												<include name="js/**"/>
+											</fileset>
+										</copy>
+									</target>
+								</configuration>
+								<goals>
+									<goal>run</goal>
+								</goals>
+							</execution>
+
+							<execution>
+								<id>rename-reference-docs</id>
+								<phase>prepare-package</phase>
+								<configuration>
+									<target>
+
+										<!-- Copy files for the single-file HTML version -->
+										<copy failonerror="false"
+											  todir="target/site/reference/html/images">
+											<fileset dir="${generated-docs.directory}/images"/>
+										</copy>
+
+										<!-- Copy shared resources. Spring Data ones first to override the ones shared -->
+										<copy failonerror="false" todir="target/site/reference/html/">
+											<fileset dir="${shared.resources}">
+												<include name="css/**"/>
+												<include name="js/**"/>
+											</fileset>
+										</copy>
+
+										<copy failonerror="false" todir="target/site/reference/html/">
+											<fileset dir="${generated-asciidoc-sources.directory}">
+												<include name="css/**"/>
+												<include name="js/**"/>
+											</fileset>
+										</copy>
+
+										<copy failonerror="false" todir="target/site/reference/html/">
+											<fileset dir="${generated-docs.directory}" includes="*.html"/>
+										</copy>
+
+									</target>
+								</configuration>
+								<goals>
+									<goal>run</goal>
+								</goals>
+							</execution>
+
+						</executions>
+
+					</plugin>
+
 				</plugins>
 			</build>
 		</profile>
-		
+
 		<profile>
 			<id>docs</id>
 
@@ -182,30 +324,76 @@
 					<plugin>
 						<groupId>org.asciidoctor</groupId>
 						<artifactId>asciidoctor-maven-plugin</artifactId>
-						<version>1.5.3</version>
+						<version>2.0.0-RC.1</version>
+						<dependencies>
+							<dependency>
+								<groupId>org.jruby</groupId>
+								<artifactId>jruby</artifactId>
+								<version>9.2.6.0</version>
+							</dependency>
+							<dependency>
+								<groupId>org.asciidoctor</groupId>
+								<artifactId>asciidoctorj</artifactId>
+								<version>2.0.0-RC.1</version>
+							</dependency>
+							<dependency>
+								<groupId>org.asciidoctor</groupId>
+								<artifactId>asciidoctorj-pdf</artifactId>
+								<version>1.5.0-alpha.16</version>
+							</dependency>
+							<dependency>
+								<groupId>org.asciidoctor</groupId>
+								<artifactId>asciidoctorj-epub3</artifactId>
+								<version>1.5.0-alpha.8.1</version>
+							</dependency>
+						</dependencies>
 						<executions>
 							<execution>
 								<id>output-html</id>
-								<phase>generate-resources</phase>
+								<phase>compile</phase>
 								<goals>
 									<goal>process-asciidoc</goal>
 								</goals>
 								<configuration>
-									<sourceDirectory>${basedir}/src/main/asciidoc</sourceDirectory>
-									<outputDirectory>${project.build.directory}/content/reference/htmlsingle</outputDirectory>
-									<backend>html</backend>
+									<sourceDirectory>${generated-asciidoc-sources.directory}</sourceDirectory>
+									<outputDirectory>${generated-docs.directory}</outputDirectory>
+									<backend>html5</backend>
 									<doctype>book</doctype>
+									<sourceHighlighter>highlight.js</sourceHighlighter>
 									<attributes>
-										<allow-uri-read>true</allow-uri-read>
-										<docinfo>true</docinfo>
+										<highlightjsdir>js/highlight</highlightjsdir>
+										<highlightjs-theme>atom-one-dark-reasonable</highlightjs-theme>
+										<linkcss>true</linkcss>
+										<sectanchors>true</sectanchors>
+										<stylesdir>./css</stylesdir>
+										<stylesheet>spring.css</stylesheet>
+										<toc>left</toc>
 										<github-tag>v${project.version}</github-tag>
 										<code-dir>${basedir}</code-dir>
-										<samples-dir>https://raw.githubusercontent.com/spring-projects/spring-session-data-mongodb-examples/master</samples-dir>
+										<samples-dir>
+											https://raw.githubusercontent.com/spring-projects/spring-session-data-mongodb-examples/master
+										</samples-dir>
 										<spring-session-version>${spring-session.version}</spring-session-version>
 									</attributes>
 								</configuration>
 							</execution>
 						</executions>
+						<configuration>
+							<doctype>book</doctype>
+							<attributes>
+								<doctype>book</doctype>
+								<docinfo>shared</docinfo>
+								<icons>font</icons>
+								<sectids>false</sectids>
+								<imagesdir>images</imagesdir>
+								<version>${project.version}</version>
+								<projectName>${project.name}</projectName>
+								<projectVersion>${project.version}</projectVersion>
+								<allow-uri-read>true</allow-uri-read>
+								<toclevels>4</toclevels>
+								<numbered>true</numbered>
+							</attributes>
+						</configuration>
 					</plugin>
 					<plugin>
 						<artifactId>maven-javadoc-plugin</artifactId>
@@ -257,8 +445,10 @@
 								<configuration>
 									<tasks>
 										<zip destfile="${project.build.directory}/${project.artifactId}-${project.version}.zip">
-											<zipfileset src="${project.build.directory}/${project.artifactId}-${project.version}-javadoc.jar" prefix="api" />
-											<fileset dir="${project.build.directory}/content"/>
+											<zipfileset
+													src="${project.build.directory}/${project.artifactId}-${project.version}-javadoc.jar"
+													prefix="api"/>
+											<fileset dir="${project.build.directory}/site"/>
 										</zip>
 									</tasks>
 								</configuration>
@@ -278,7 +468,9 @@
 								<configuration>
 									<artifacts>
 										<artifact>
-											<file>${project.build.directory}/${project.artifactId}-${project.version}.zip</file>
+											<file>
+												${project.build.directory}/${project.artifactId}-${project.version}.zip
+											</file>
 											<type>zip;zip.type=docs;zip.deployed=false</type>
 										</artifact>
 									</artifacts>
@@ -562,7 +754,7 @@
 				</exclusion>
 			</exclusions>
 		</dependency>
-		
+
 		<dependency>
 			<groupId>com.google.code.findbugs</groupId>
 			<artifactId>jsr305</artifactId>
@@ -740,14 +932,17 @@
 		<repository>
 			<id>spring-libs-snapshot</id>
 			<url>https://repo.spring.io/libs-snapshot</url>
-			<snapshots><enabled>true</enabled></snapshots>
+			<snapshots>
+				<enabled>true</enabled>
+			</snapshots>
 		</repository>
 	</repositories>
 
 	<scm>
 		<url>https://github.com/spring-projects/spring-session-mongodb</url>
 		<connection>scm:git:git://github.com/spring-projects/spring-session-mongodb.git</connection>
-		<developerConnection>scm:git:ssh://git@github.com:spring-projects/spring-session-mongodb.git</developerConnection>
+		<developerConnection>scm:git:ssh://git@github.com:spring-projects/spring-session-mongodb.git
+		</developerConnection>
 	</scm>
 
 </project>
diff --git a/src/main/asciidoc/index.adoc b/src/main/asciidoc/index.adoc
index 6e1125e..60ba764 100644
--- a/src/main/asciidoc/index.adoc
+++ b/src/main/asciidoc/index.adoc
@@ -1,9 +1,11 @@
 
-= Spring Session MongoDB
-Rob Winch, Vedran Pavić, Jakub Kubrynski, Greg Turnquist
+= Spring Session MongoDB - Reference Documentation
+Rob Winch; Vedran Pavić; Jakub Kubrynski; Greg Turnquist
 :doctype: book
 :toc: left
 :toclevels: 4
+:revnumber: {version}
+:revdate: {localdate}
 
 [[abstract]]