Attempt to create doc previews

.github/workflows/doc-preview.yml

@@ -0,0 +1,49 @@
+name: Deploy doc previews to GitHub Pages
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - closed
+  workflow_dispatch:
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+  pull-requests: write
+concurrency:
+  group: "preview-${{ github.ref }}"
+  cancel-in-progress: false
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Setup Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16
+          cache: npm
+      - name: Restore cache
+        uses: actions/cache@v3
+        with:
+          path: |
+            docs/.next/cache
+          key: ${{ runner.os }}-nextjs-${{ hashFiles('docs/**/package-lock.json') }}-${{ hashFiles('docs/**.[jt]s', 'docs/**.[jt]sx') }}
+          restore-keys: |
+            ${{ runner.os }}-nextjs-${{ hashFiles('docs/**/package-lock.json') }}-
+      - name: Install dependencies
+        run: npm install
+      - name: Build with Next.js
+        run: npx --no-install next build
+        env:
+          NEXTJS_BASE_PATH: "/serverless-iiif/pr-preview/pr-${{ github.event.number }}"
+      - name: Deploy preview
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: ./docs/out/

.github/workflows/docs.yml

@@ -11,7 +11,7 @@ concurrency:
   group: "pages"
   cancel-in-progress: false
 jobs:
-  build:
+  deploy-pages:
     runs-on: ubuntu-latest
     defaults:
       run:
@@ -42,19 +42,10 @@ jobs:
         run: npx --no-install next build
         env:
           NEXTJS_BASE_PATH: "/serverless-iiif"
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v2
-        with:
-          path: ./docs/out
-
-  # Deployment job
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
       - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v2
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          clean-exclude: |
+            .nojekyll
+            pr-preview/
+          folder: ./docs/out