Documentation overhaul (#148)

- Search integration
- Custom start page
- Antora 3

Author: lfrancke

.github/dependabot.yml

@@ -12,7 +12,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/[email protected]
-      - name: "Generate site using Antora site action"
-        uses: kameshsampath/[email protected]
+      - uses: actions/setup-node@v2
         with:
-          antora_playbook: antora-playbook.yml
+          node-version: '16'
+          cache: 'npm'
+      - run: npm install
+      - run: npx antora --fetch local-antora-playbook.yml

.github/workflows/build.yml

@@ -17,12 +17,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/[email protected]
-      - name: "Generate site using Antora site action"
-        uses: kameshsampath/[email protected]
+      - uses: actions/setup-node@v2
         with:
-          antora_playbook: antora-playbook.yml
-      - name: Deploy to GitHub Pages
-        uses: JamesIves/[email protected]
+          node-version: '16'
+          cache: 'npm'
+      - run: npm install
+      - run: npx antora --fetch local-antora-playbook.yml
+      - name: Publish to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
         with:
-          branch: 'docs'
-          folder: 'build/site'
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: build/site
+          publish_branch: docs

.github/workflows/deploy.yml

@@ -1,7 +1,7 @@
+---
 site:
   title: Stackable Documentation
   url: https://docs.stackable.tech
-  start_page: home::index.adoc
   robots: allow
 
 content:
@@ -48,13 +48,13 @@ content:
 
 ui:
   bundle:
-    url: https://repo.stackable.tech/repository/misc/ui-bundle.zip
+    url: https://repo.stackable.tech/repository/misc/antora-ui-bundle.zip
     snapshot: true
-  supplemental_files:
-   - path: ui.yml
-     contents: |
-       static_files: [ .nojekyll ]
-   - path: .nojekyll
+  supplemental_files: ./node_modules/@antora/lunr-extension/supplemental_ui
+
+antora:
+  extensions:
+    - '@antora/lunr-extension'
 
 asciidoc:
   attributes:

antora-playbook.yml

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+npx antora --fetch $1

build_maturity_level_docs.py

@@ -1,7 +1,7 @@
+---
 site:
   title: Stackable Documentation
   url: https://docs.stackable.tech
-  start_page: home::index.adoc
   robots: allow
 
 content:
@@ -48,13 +48,13 @@ content:
 
 ui:
   bundle:
-    url: https://repo.stackable.tech/repository/misc/ui-bundle.zip
+    url: https://repo.stackable.tech/repository/misc/antora-ui-bundle.zip
     snapshot: true
-  supplemental_files:
-   - path: ui.yml
-     contents: |
-       static_files: [ .nojekyll ]
-   - path: .nojekyll
+  supplemental_files: ./node_modules/@antora/lunr-extension/supplemental_ui
+
+antora:
+  extensions:
+    - '@antora/lunr-extension'
 
 asciidoc:
   attributes:

generate_site.sh

@@ -1,3 +1,4 @@
+---
 site:
   title: Stackable Documentation
   url: https://docs.stackable.tech
@@ -48,13 +49,13 @@ content:
 
 ui:
   bundle:
-    url: https://repo.stackable.tech/repository/misc/ui-bundle.zip
+    url: https://repo.stackable.tech/repository/misc/antora-ui-bundle.zip
     snapshot: true
-  supplemental_files:
-   - path: ui.yml
-     contents: |
-       static_files: [ .nojekyll ]
-   - path: .nojekyll
+  supplemental_files: ./node_modules/@antora/lunr-extension/supplemental_ui
+
+antora:
+  extensions:
+    - '@antora/lunr-extension'
 
 asciidoc:
   attributes: