feat: support docs preview (#2278)

Signed-off-by: bitliu <[email protected]>

Author: Xunzhuo

.github/workflows/docs.yaml

@@ -6,19 +6,17 @@ on:
     - "release/v*"
     paths-ignore:
     - "**/*.png"
-  pull_request:
-    branches:
-    - "main"
-    - "release/v*"
-    paths-ignore:
-    - "**/*.png"
+  pull_request_target:
+    types: [opened, synchronize, reopened]
 
 jobs:
   docs-lint:
     runs-on: ubuntu-22.04
     steps:
     - name: Check out code
       uses: actions/checkout@v4
+      with:
+        ref: ${{ github.event.pull_request.head.sha }}
 
     - name: Run markdown linter
       uses: nosborn/[email protected]
@@ -36,6 +34,7 @@ jobs:
       uses: actions/checkout@v4
       with:
         submodules: true
+        ref: ${{ github.event.pull_request.head.sha }}
 
     - name: Setup Hugo
       uses: peaceiris/actions-hugo@v2
@@ -60,6 +59,44 @@ jobs:
         # Duration after which artifact will expire in days.
         # retention-days: # optional, default is 1
 
+  docs-preview:
+    if: "github.event_name == 'pull_request_target'"
+    needs: docs-build
+    runs-on: ubuntu-22.04
+    steps:
+    - name: Git checkout
+      uses: actions/checkout@v4
+      with:
+        ref: ${{ github.event.pull_request.head.sha }}
+    - name: Setup Hugo
+      uses: peaceiris/actions-hugo@v2
+      with:
+        hugo-version: 'latest'
+        extended: true
+    - name: Setup Node
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+    - name: Install Site Dependencies and Build Site
+      run: make docs
+    - name: Deploy to Netlify
+      uses: nwtgck/[email protected]
+      with:
+        publish-dir: 'site/public'
+        production-deploy: false
+        github-token: ${{ secrets.GITHUB_TOKEN }}
+        deploy-message: "Deploy from GitHub Actions"
+        alias: "${{ github.event.repository.name }}-pr-${{ github.event.pull_request.number }}-preview"
+        # these all default to 'true'
+        enable-pull-request-comment: true
+        enable-commit-comment: false
+        enable-commit-status: true
+        overwrites-pull-request-comment: true
+      env:
+        NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+        NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+      timeout-minutes: 1
+
   # This workflow contains a single job called "build"
   docs-publish:
     if: github.event_name == 'push'