Merge branch 'master' into giftcarddocsOct2023

.github/workflows/docs.yml

@@ -2,15 +2,42 @@ name: Trigger documentation build
 
 on:
   push:
+    branches:
+      - 'master'
+    paths:
+      - 'docs/**'
+  pull_request:
+    branches:
+      - 'master'
     paths:
       - 'docs/**'
-      - '.github/workflows/docs.yml'
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - name: Notify AxonIQ Library
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '20'
+
+      - name: Install vale
+        run: |
+            wget https://github.com/errata-ai/vale/releases/download/v2.23.0/vale_2.23.0_Linux_64-bit.tar.gz
+            sudo tar -xvzf vale_2.23.0_Linux_64-bit.tar.gz -C /usr/local/bin vale
+
+      - name: Generate Site
+        run: |
+          cd docs/_playbook/
+          npm install
+          export GIT_CREDENTIALS='https://axoniq-devops:${{ secrets.LIBRARY_DEVBOT_TOKEN }}@github.com'
+          npx antora playbook.yaml
+
+      - name: Notify AxonIQ Library (if a push to a tracked branch)
+        if: ${{ github.event_name == 'push'}}
         uses: actions/github-script@v6
         with:
           github-token: ${{ secrets.LIBRARY_DEVBOT_TOKEN }}

.gitignore

@@ -23,3 +23,6 @@ dist/
 nbdist/
 .nb-gradle/
 *.jar
+docs/_playbook/vale
+.DS_Store
+.java-version

docs/_playbook/.gitignore

@@ -0,0 +1,4 @@
+build
+node_modules
+.vscode
+vale

docs/_playbook/.vale.ini

@@ -0,0 +1,8 @@
+StylesPath = vale
+
+MinAlertLevel = suggestion
+
+Packages = http://github.com/AxonIQ/axoniq-vale-package/releases/latest/download/axoniq-vale-package.zip
+
+[*.{adoc,html}]
+BasedOnStyles = AxonIQ