ci: add workflow to build and publish gh page

Author: gclaussn

.github/workflows/build.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+set -e
+
+if [ "$#" -ne 1 ]; then
+  echo "arg #1 must be a release tag name" && exit 1
+fi
+
+RELEASE_TAG_NAME="$1"
+
+# download openapi.yaml
+curl -L \
+-o openapi.yaml \
+https://github.com/gclaussn/go-bpmn/releases/download/${RELEASE_TAG_NAME}/go-bpmn-openapi.yaml
+
+# build OpenAPI docs
+npx @redocly/cli build-docs \
+--title "go-bpmn HTTP API (${RELEASE_TAG_NAME})" \
+--output openapi.html \
+openapi.yaml
+
+# build Github page
+npm run build
+
+# include OpenAPI docs
+mv openapi.html ./dist/

.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish
+on:
+  push:
+    branches:
+      - "gh-page"
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Set up node
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: package.json
+          cache: npm
+          cache-dependency-path: package-lock.json
+      - name: Clean install
+        run: npm ci
+      - name: Build
+        run: bash ./.github/workflows/build.sh v0.1.0 # need to be manually increased
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist/
+  deploy:
+    runs-on: ubuntu-22.04
+    needs: build
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy pages
+        uses: actions/deploy-pages@v4
+        id: deployment

.gitignore

@@ -19,3 +19,6 @@ pnpm-debug.log*
 
 # macOS-specific files
 .DS_Store
+
+openapi.html
+openapi.yaml