Migrate documentation to Antora.

Author: meistermeier

.gitignore

@@ -32,3 +32,10 @@ target/
 .flattened-pom.xml
 dependency-reduced-pom.xml
 .gradle
+
+build/
+node_modules
+node
+package.json
+package-lock.json
+

README.adoc

@@ -146,14 +146,14 @@ class MyService {
 
 === Building SDN
 
-Please have a look at the documentation: https://docs.spring.io/spring-data/neo4j/docs/current/reference/html/#building-sdn-rx[Building SDN].
+Please have a look at the documentation: https://docs.spring.io/spring-data/neo4j/reference/#building-sdn-rx[Building SDN].
 
 == Getting Help
 
 Having trouble with Spring Data? We’d love to help!
 
 * Check the
-https://docs.spring.io/spring-data/neo4j/docs/current/reference/html/[reference documentation], and https://docs.spring.io/spring-data/neo4j/docs/current/api/[Javadocs].
+https://docs.spring.io/spring-data/neo4j/reference/[reference documentation], and https://docs.spring.io/spring-data/neo4j/docs/current/api/[Javadocs].
 * Learn the Spring basics – Spring Data builds on Spring Framework, check the https://spring.io[spring.io] web-site for a wealth of reference documentation.
 If you are just starting out with Spring, try one of the https://spring.io/guides[guides].
 * If you are upgrading, check out the https://docs.spring.io/spring-data/neo4j/docs/current/changelog.txt[changelog] for "`new and noteworthy`" features.
@@ -166,7 +166,7 @@ Spring Data uses GitHub as issue tracking system to record bugs and feature requ
 
 * Before you log a bug, please search the
 https://github.com/spring-projects/spring-data-neo4j/issues[issue tracker] to see if someone has already reported the problem.
-* If the issue doesn’t already exist, https://github.com/spring-projects/spring-data-neo4j/issues/new[create a new issue].
+* If the issue doesn't already exist, https://github.com/spring-projects/spring-data-neo4j/issues/new[create a new issue].
 * Please provide as much information as possible with the issue report, we like to know the version of Spring Data Neo4j, the database version and the JVM version that you are using.
 * If you need to paste code, or include a stack trace use Markdown +++```+++ escapes before and after your text.
 * If possible try to create a test-case or project that replicates the issue. Attach a link to your code or a compressed file containing your code.

pom.xml

@@ -68,10 +68,9 @@
 	</developers>
 
 	<properties>
+		<antora.playbook>${project.basedir}/src/main/antora/antora-playbook.yml</antora.playbook>
 		<apiguardian.version>1.1.1</apiguardian.version>
 		<archunit.version>0.23.1</archunit.version>
-		<asciidoctor-maven-plugin.version>2.1.0</asciidoctor-maven-plugin.version>
-		<asciidoctorj-diagram.version>2.1.0</asciidoctorj-diagram.version>
 		<blockhound.version>1.0.8.RELEASE</blockhound.version>
 		<byte-buddy.version>1.14.3</byte-buddy.version>
 		<cdi>3.0.1</cdi>
@@ -115,7 +114,6 @@
 
 		<skipUnitTests>${skipTests}</skipUnitTests>
 
-		<spring-data-commons-docs.dir>../../../../spring-data-commons/src/main/asciidoc</spring-data-commons-docs.dir>
 		<springdata.commons>3.2.0-SNAPSHOT</springdata.commons>
 	</properties>
 
@@ -725,34 +723,41 @@
 					</execution>
 				</executions>
 			</plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-resources-plugin</artifactId>
+				<executions>
+					<execution>
+						<goals>
+							<goal>resources</goal>
+						</goals>
+					</execution>
+				</executions>
+			</plugin>
 		</plugins>
 
 	</build>
 
 	<profiles>
 		<profile>
-			<id>distribute</id>
+			<id>antora-process-resources</id>
+			<build>
+				<resources>
+					<resource>
+						<directory>src/main/antora/resources/antora-resources</directory>
+						<filtering>true</filtering>
+					</resource>
+				</resources>
+			</build>
+		</profile>
+
+		<profile>
+			<id>antora</id>
 			<build>
 				<plugins>
 					<plugin>
-						<groupId>org.asciidoctor</groupId>
-						<artifactId>asciidoctor-maven-plugin</artifactId>
-						<version>${asciidoctor-maven-plugin.version}</version>
-						<dependencies>
-							<dependency>
-								<groupId>org.asciidoctor</groupId>
-								<artifactId>asciidoctorj-diagram</artifactId>
-								<version>${asciidoctorj-diagram.version}</version>
-							</dependency>
-						</dependencies>
-						<configuration combine.self="append">
-							<attributes>
-								<spring-data-commons-docs>${spring-data-commons-docs.dir}</spring-data-commons-docs>
-							</attributes>
-							<requires>
-								<require>asciidoctor-diagram</require>
-							</requires>
-						</configuration>
+						<groupId>io.spring.maven.antora</groupId>
+						<artifactId>antora-maven-plugin</artifactId>
 					</plugin>
 				</plugins>
 			</build>

src/main/antora/antora-playbook.yml

@@ -0,0 +1,42 @@
+# PACKAGES antora@3.2.0-alpha.2 @antora/atlas-extension:1.0.0-alpha.1 @antora/collector-extension@1.0.0-alpha.3 @springio/antora-extensions@1.1.0-alpha.2 @asciidoctor/tabs@1.0.0-alpha.12 @opendevise/antora-release-line-extension@1.0.0-alpha.2
+#
+# The purpose of this Antora playbook is to build the docs in the current branch.
+antora:
+  extensions:
+    - '@antora/collector-extension'
+    - require: '@springio/antora-extensions/root-component-extension'
+      root_component_name: 'data-neo4j'
+site:
+  title: Spring Data Neo4j
+  url: https://docs.spring.io/spring-data/neo4j/reference/
+content:
+  sources:
+    - url: ./../../..
+      branches: HEAD
+      start_path: src/main/antora
+      worktrees: true
+    - url: https://github.com/spring-projects/spring-data-commons
+      # Refname matching:
+      # https://docs.antora.org/antora/latest/playbook/content-refname-matching/
+      branches: [ main, 3.2.x ]
+      start_path: src/main/antora
+asciidoc:
+  attributes:
+    page-pagination: ''
+    hide-uri-scheme: '@'
+    tabs-sync-option: '@'
+    chomp: 'all'
+  extensions:
+    - '@asciidoctor/tabs'
+    - '@springio/asciidoctor-extensions'
+  sourcemap: true
+urls:
+  latest_version_segment: ''
+runtime:
+  log:
+    failure_level: warn
+    format: pretty
+ui:
+  bundle:
+    url: https://github.com/spring-io/antora-ui-spring/releases/download/v0.3.5/ui-bundle.zip
+    snapshot: true

src/main/antora/antora.yml

@@ -0,0 +1,12 @@
+name: data-neo4j
+version: true
+title: Spring Data Neo4j
+nav:
+  - modules/ROOT/nav.adoc
+ext:
+  collector:
+    - run:
+        command: ./mvnw validate process-resources -am -Pantora-process-resources
+        local: true
+      scan:
+        dir: target/classes/

src/main/antora/modules/ROOT/examples/config

@@ -0,0 +1 @@
+../../../../java/org/springframework/data/neo4j/config

src/main/antora/modules/ROOT/examples/core

@@ -0,0 +1 @@
+../../../../java/org/springframework/data/neo4j/core

src/main/antora/modules/ROOT/examples/documentation

@@ -0,0 +1 @@
+../../../../../test/java/org/springframework/data/neo4j/documentation

src/main/antora/modules/ROOT/examples/integration

@@ -0,0 +1 @@
+../../../../../test/java/org/springframework/data/neo4j/integration

src/main/antora/modules/ROOT/examples/repository

@@ -0,0 +1 @@
+../../../../java/org/springframework/data/neo4j/repository