Update to Match Spring Security Docs Configuration

This commit specifically removes configuration that customizes
the playbook file name, moves dependency management to npm,
updates antora packages to match Spring Security versions, and
adds the syncAntoraResources task.

Issue gh-1297

Author: jzheaux

cached-antora-playbook.yml renamed to antora-playbook.yml

@@ -3,15 +3,12 @@
 # The purpose of this Antora playbook is to build the docs in the current branch.
 antora:
   extensions:
-  - '@antora/collector-extension'
-  - id: '@antora/atlas-extension'
-    require: '@antora/atlas-extension'
-    enabled: false
-  - '@springio/antora-extensions/latest-version-extension'
-  - require: '@springio/antora-extensions/root-component-extension'
-    root_component_name: 'ldap'
+    - require: '@springio/antora-extensions'
+      root_component_name: 'ldap'
 site:
   title: Spring LDAP Reference
+  url: https://docs.spring.io/spring-ldap/reference
+  robots: allow
 content:
   sources:
   - url: .
@@ -27,6 +24,7 @@ asciidoc:
   - '@asciidoctor/tabs'
   - '@springio/asciidoctor-extensions'
   - '@springio/asciidoctor-extensions/include-code-extension'
+  - '@springio/asciidoctor-extensions/javadoc-extension'
   sourcemap: true
 urls:
   latest_version_segment: ''

antora.yml

@@ -6,7 +6,7 @@ nav:
 ext:
   collector:
     run:
-      command: gradlew -q -PbuildSrc.skipTests=true "-Dorg.gradle.jvmargs=-Xmx3g -XX:+HeapDumpOnOutOfMemoryError" generateAntoraYml
+      command: gradlew -q -PbuildSrc.skipTests=true "-Dorg.gradle.jvmargs=-Xmx3g -XX:+HeapDumpOnOutOfMemoryError" generateAntoraResources
       local: true
     scan:
       dir: ./build/generated-antora-resources

build.gradle

@@ -39,14 +39,18 @@ nohttp {
 
 
 antora {
-    playbook = 'cached-antora-playbook.yml'
-    playbookProvider {
-        repository = 'spring-projects/spring-ldap'
-        branch = 'docs-build'
-        path = 'lib/antora/templates/per-branch-antora-playbook.yml'
-        checkLocalBranch = true
-    }
     options = [clean: true, fetch: !project.gradle.startParameter.offline, stacktrace: true]
+    environment = [
+            'BUILD_REFNAME': 'HEAD',
+            'BUILD_VERSION': project.version,
+    ]
+}
+
+tasks.register("syncAntoraAttachments", Sync) {
+    group = 'Documentation'
+    description = 'Syncs the Antora attachments'
+    from project.provider( { project.tasks.api.outputs } )
+    into project.layout.buildDirectory.dir('generated-antora-resources/modules/ROOT/assets/attachments/api/java')
 }
 
 tasks.named("generateAntoraYml") {
@@ -58,6 +62,10 @@ tasks.named("generateAntoraYml") {
     } )
 }
 
+tasks.register("generateAntoraResources") {
+    dependsOn 'generateAntoraYml', 'syncAntoraAttachments'
+}
+
 springRelease {
     repositoryOwner = "spring-projects"
     repositoryName = "spring-ldap"

package.json

@@ -0,0 +1,10 @@
+{
+  "dependencies": {
+    "antora": "3.2.0-alpha.10",
+    "@antora/atlas-extension": "1.0.0-alpha.5",
+    "@antora/collector-extension": "1.0.2",
+    "@asciidoctor/tabs": "1.0.0-beta.6",
+    "@springio/antora-extensions": "1.14.7",
+    "@springio/asciidoctor-extensions": "1.0.0-alpha.17"
+  }
+}