build: update Antora to 3.1.12 and fix documentation warnings

Upgrade Antora documentation generator and resolve all build warnings for cleaner
documentation builds.

- Update Antora CLI and site generator from 3.1.4 to 3.1.12
- Update Node.js to 20.17.0 LTS and npm to 10.9.2
- Fix deprecated npm package warnings (inflight, glob, gulp-vinyl-zip)
- Replace deprecated {attachmentsdir} with modern Antora 3.x attachment syntax
- Update api-reference.adoc to use xref:attachment$ instead of link:{attachmentsdir}
- Change javadoc-base-url to use relative path instead of deprecated attribute

Author: bsbodden

docs/antora-playbook.yml

@@ -29,7 +29,8 @@ asciidoc:
     toc: ~
     xrefstyle: short
     # Javadoc-specific attributes
-    javadoc-base-url: '{attachmentsdir}/javadoc'
+    # Using relative paths from the page location
+    javadoc-base-url: '_attachments/javadoc'
     javadoc-core-url: '{javadoc-base-url}/modules/redis-om-spring'
     javadoc-ai-url: '{javadoc-base-url}/modules/redis-om-spring-ai'
     javadoc-aggregate-url: '{javadoc-base-url}/aggregate'

docs/build.gradle

@@ -12,9 +12,9 @@ description = 'Redis OM Spring Documents Site'
 
 // Define properties similar to Maven pom.xml
 ext {
-	nodeVersion = '20.5.0' // Note: no 'v' prefix for node-gradle plugin
-	npmVersion = '9.8.0'
-	antoraVersion = '3.1.4'
+	nodeVersion = '20.17.0' // LTS version
+	npmVersion = '10.9.2'
+	antoraVersion = '3.1.12'
 }
 
 // Configure Node.js plugin

docs/content/modules/ROOT/pages/api-reference.adoc

@@ -23,7 +23,7 @@ The API documentation is automatically generated from the latest release and inc
 
 The core Redis OM Spring module provides the fundamental functionality for object mapping, repositories, and search capabilities.
 
-link:{attachmentsdir}/javadoc/modules/redis-om-spring/index.html[Redis OM Spring Core API^, role="external"]
+xref:attachment$javadoc/modules/redis-om-spring/index.html[Redis OM Spring Core API^, role="external", window="_blank"]
 
 === Key Packages
 
@@ -39,7 +39,7 @@ link:{attachmentsdir}/javadoc/modules/redis-om-spring/index.html[Redis OM Spring
 
 The AI extension module provides vector embedding and similarity search capabilities with multiple AI provider integrations.
 
-link:{attachmentsdir}/javadoc/modules/redis-om-spring-ai/index.html[Redis OM Spring AI API^, role="external"]
+xref:attachment$javadoc/modules/redis-om-spring-ai/index.html[Redis OM Spring AI API^, role="external", window="_blank"]
 
 === Key Packages
 
@@ -51,7 +51,7 @@ link:{attachmentsdir}/javadoc/modules/redis-om-spring-ai/index.html[Redis OM Spr
 
 For a unified view of all modules and their interactions:
 
-link:{attachmentsdir}/javadoc/aggregate/index.html[Complete API Reference^, role="external"]
+xref:attachment$javadoc/aggregate/index.html[Complete API Reference^, role="external", window="_blank"]
 
 This aggregated documentation provides: