Adapt GitHub workflows to produce versioned platform documentation (#274)

* Adapt GitHub workflows to produce versioned platform documentation
* Align antora-playbook.yml with local-antora-playbook.yml

Author: siegfriedweber

.github/workflows/build.yml

@@ -11,6 +11,7 @@ jobs:
       - uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b # tag=v3.0.2
         with:
           submodules: true
+          fetch-depth: 0
       - uses: actions/setup-node@1f8c6b94b26d0feae1e387ca63ccbdc44d27b561 # tag=v2
         with:
           node-version: '16'

.github/workflows/deploy.yml

@@ -20,7 +20,7 @@ jobs:
           node-version: '16'
           cache: 'npm'
       - run: npm ci
-      - run: make ANTORAFLAGS=--fetch
+      - run: make ANTORAFLAGS=--fetch PLAYBOOK=antora-playbook.yml
       - name: Publish to GitHub Pages
         uses: peaceiris/actions-gh-pages@068dc23d9710f1ba62e86896f84735d869951305 # tag=v3
         with:

antora-playbook.yml

@@ -2,6 +2,7 @@
 site:
   title: Stackable Documentation
   url: https://docs.stackable.tech
+  start_page: home::index.adoc
   robots: allow
 
 urls:
@@ -81,7 +82,7 @@ content:
 ui:
   bundle:
     url: ./ui/build/ui-bundle.zip
-  supplemental_files: ./node_modules/@antora/lunr-extension/supplemental_ui
+  supplemental_files: ./supplemental-ui
 
 antora:
   extensions:
@@ -92,6 +93,7 @@ asciidoc:
   attributes:
     base-repo: https://github.com/stackabletech
     plantuml-server-url: http://www.plantuml.com/plantuml
+    kroki-fetch-diagram: true
   extensions:
     - asciidoctor-kroki