(tapestry-5-site-builder) branch main updated: build(antora): add playbook for local previews

[benw]

This is an automated email from the ASF dual-hosted git repository.

benweidig pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tapestry-5-site-builder.git


The following commit(s) were added to refs/heads/main by this push:
     new ae5519d  build(antora): add playbook for local previews
ae5519d is described below

commit ae5519df1b2b5f324ad76783f89b224d27674ff3
Author: Ben Weidig <b...@netzgut.net>
AuthorDate: Sat Aug 29 11:42:32 2026 +0200

    build(antora): add playbook for local previews
    
    antora-playbook.yml fetches the content from gitbox, so it cannot show
    unpushed work. antora-playbook-local.yml reads a sibling tapestry-5-site
    checkout instead:
    
        ./gradlew antora -PlocalPlaybook
    
    Without the flag the antora task is unchanged.
---
 antora-playbook-local.yml | 41 +++++++++++++++++++++++++++++++++++++++++
 build.gradle              |  6 ++++++
 2 files changed, 47 insertions(+)

diff --git a/antora-playbook-local.yml b/antora-playbook-local.yml
new file mode 100644
index 0000000..9f80254
--- /dev/null
+++ b/antora-playbook-local.yml
@@ -0,0 +1,41 @@
+# Local preview playbook.
+#
+# Same as antora-playbook.yml, but reads the site content from a sibling
+# checkout of tapestry-5-site instead of fetching it from gitbox. Use it to
+# preview branches before pushing them:
+#
+#   ./gradlew antora -PlocalPlaybook
+#
+# Antora reads the *committed* branches of that checkout, not the working
+# tree, so commit your changes before building.
+#
+# The lunr search extension is left out on purpose: it is slow and adds
+# nothing to a local preview.
+
+site:
+  title: Apache Tapestry
+  start_page: main::about.adoc
+
+content:
+  sources:
+  - url: ../tapestry-5-site
+    branches: [main, 5.*]
+
+output:
+  dir: ./build/site
+  clean: true
+
+urls:
+  latest_version_segment: current
+
+asciidoc:
+  extensions:
+  - asciidoctor-kroki
+  - ./lib/issue-processor
+  - ./lib/javadoc-processor
+
+ui:
+  bundle:
+    url: 
https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
+    snapshot: true
+  supplemental_files: ./supplemental-ui
diff --git a/build.gradle b/build.gradle
index 7548e0f..8139878 100644
--- a/build.gradle
+++ b/build.gradle
@@ -23,4 +23,10 @@ tasks.register('copyStaticRootFiles', Copy) {
 
 tasks.named('antora') {
     finalizedBy('copyStaticRootFiles')
+
+    // ./gradlew antora -PlocalPlaybook  builds from a sibling tapestry-5-site
+    // checkout instead of fetching the content from gitbox.
+    if (project.hasProperty('localPlaybook')) {
+        playbook = 'antora-playbook-local.yml'
+    }
 }