Copy default antora files

Closes gh-869

Author: rwinch

.github/workflows/deploy-docs.yml

@@ -0,0 +1,33 @@
+name: Deploy Docs
+on:
+  push:
+    branches-ignore: [ gh-pages ]
+    tags: '**'
+  repository_dispatch:
+    types: request-build-reference # legacy
+  #schedule:
+  #- cron: '0 10 * * *' # Once per day at 10am UTC
+  workflow_dispatch:
+permissions:
+  actions: write
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    # FIXME enable when pushed to spring-projects
+    # if: github.repository_owner == 'spring-projects'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          ref: docs-build
+          fetch-depth: 1
+      - name: Dispatch (partial build)
+        if: github.ref_type == 'branch'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh workflow run deploy-docs.yml -r $(git rev-parse --abbrev-ref HEAD) -f build-refname=${{ github.ref_name }}
+      - name: Dispatch (full build)
+        if: github.ref_type == 'tag'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh workflow run deploy-docs.yml -r $(git rev-parse --abbrev-ref HEAD)

antora.yml

@@ -0,0 +1,19 @@
+name: ldap
+version: true
+title: Spring LDAP
+nav:
+  - modules/ROOT/nav.adoc
+ext:
+  collector:
+    run:
+      command: gradlew -q -PbuildSrc.skipTests=true "-Dorg.gradle.jvmargs=-Xmx3g -XX:+HeapDumpOnOutOfMemoryError" generateAntoraYml
+      local: true
+    scan:
+      dir: ./build/generated-antora-resources
+
+asciidoc:
+  attributes:
+    attribute-missing: 'warn'
+    # FIXME: the copyright is not removed
+    # FIXME: The package is not renamed
+    chomp: 'all'

build.gradle

@@ -13,6 +13,11 @@ buildscript {
     }
 }
 
+plugins {
+    id 'io.spring.antora.generate-antora-yml' version '0.0.1'
+    id 'org.antora' version '1.0.0'
+}
+
 apply plugin: 'io.spring.convention.root'
 apply plugin: 'io.spring.convention.docs'
 apply plugin: 'io.spring.javaformat'
@@ -33,24 +38,16 @@ nohttp {
 	source.exclude "buildSrc/build/**"
 }
 
-asciidoctor {
-	outputDir = new File("$buildDir/docs")
-	attributes([
-		copycss : '',
-		icons : 'font',
-		'source-highlighter': 'prettify',
-		sectanchors : '',
-		toc2: '',
-		idprefix: '',
-		idseparator: '-',
-		doctype: 'book',
-		numbered: '',
-		'spring-ldap-version' : project.version,
-		revnumber : project.version
-	])
-	options = [
-		eruby: 'erubis'
-	]
+
+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]
 }
 
 springRelease {
@@ -63,6 +60,14 @@ springRelease {
     replaceSnapshotVersionInReferenceDocUrl = true
 }
 
+
+tasks.named("generateAntoraYml") {
+    asciidocAttributes = project.provider( {
+        return  ['project-version': project.version]
+    } )
+}
+
+
 s101 {
 	configurationDirectory = project.file("etc/s101")
 }
@@ -71,7 +76,7 @@ allprojects {
         if (!['spring-ldap-bom', 'spring-security-docs'].contains(project.name)) {
                 apply plugin: 'io.spring.javaformat'
 		apply plugin: 'checkstyle'
-		
+
 		pluginManager.withPlugin("io.spring.convention.checkstyle", { plugin ->
                         configure(plugin) {
                                 dependencies {

cached-antora-playbook.yml

@@ -0,0 +1,39 @@
+# PACKAGES [email protected] @antora/atlas-extension:1.0.0-alpha.1 @antora/[email protected] @springio/[email protected] @asciidoctor/[email protected] @springio/asciidoctor-extensions @opendevise/[email protected]
+#
+# 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'
+site:
+  title: Spring LDAP Reference
+content:
+  sources:
+  - url: .
+    branches: HEAD
+    worktrees: true
+asciidoc:
+  attributes:
+    hide-uri-scheme: '@'
+    page-pagination: ''
+    primary-site-url: https://docs.spring.io/spring-ldap/reference
+    tabs-sync-option: '@'
+  extensions:
+  - '@asciidoctor/tabs'
+  - '@springio/asciidoctor-extensions'
+  - '@springio/asciidoctor-extensions/include-code-extension'
+  sourcemap: true
+urls:
+  latest_version_segment: ''
+runtime:
+  log:
+    failure_level: warn
+ui:
+  bundle:
+    url: https://github.com/spring-io/antora-ui-spring/releases/download/latest/ui-bundle.zip
+    snapshot: true