update github actions

Author: dimitri-yatsenko

.github/workflows/main.yml

@@ -1,46 +1,61 @@
-name: DataJoint Book GitHub Pages Deploy
+name: Build and Deploy DataJoint Book
+
+# Run on pushes to the main branch and on pull requests 
 on:
   push:
     # Runs on pushes targeting the default branch
     branches: [main]
-env:
-  # `BASE_URL` determines the website is served from, including CSS & JS assets
-  # You may need to change this to `BASE_URL: ''`
-  BASE_URL: /${{ github.event.repository.name }}
+  pull_request:
+    branches: [main]
 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
+
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
-  group: 'pages'
+  group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: false
+
 jobs:
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+  build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - name: Setup Pages
-        uses: actions/configure-pages@v3
-      - uses: actions/setup-node@v4
+      - name: Checkout your repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js and cache dependencies
+        uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version: '20' # Using a more current LTS version
+          cache: 'npm'      # ⚡️ Cache npm packages for faster subsequent runs
+
       - name: Install MyST Markdown
         run: npm install -g mystmd
-      - name: Build HTML Assets
-        run: | 
-          cd book
-          myst build --html
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v4
+
+      - name: Build HTML assets
+        run: myst build book/myst.yml --html # It's good practice to specify the config file
+
+      - name: Upload artifact for deployment
+        uses: actions/upload-pages-artifact@v3 
         with:
           path: './book/_build/html'
+
+  deploy:
+    # Requires the build job to succeed
+    needs: build
+
+    # Deploy only when pushing to the main branch, not on pull requests
+    if: github.ref == 'refs/heads/main'
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v2
+        uses: actions/deploy-pages@v4