add workflow_dispatch for running pr previews

Signed-off-by: Aritra Dey <[email protected]>

Author: AritraDey-Dev

.github/workflows/publish-docs.yml

@@ -5,6 +5,16 @@ on:
     branches: [master]
   pull_request:
     branches: [master]
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: 'PR number to deploy preview for'
+        required: true
+        type: number
+      run_id:
+        description: 'Run ID of the build workflow (from the PR checks)'
+        required: true
+        type: string
 
 permissions:
   contents: write
@@ -13,7 +23,6 @@ permissions:
 jobs:
   build:
     runs-on: ubuntu-latest
-
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -36,43 +45,46 @@ jobs:
           path: build/
 
   deploy-pr-preview:
-    # Runs ONLY for PRs
-    if: ${{ github.event_name == 'pull_request' }}
+    if: ${{ github.event_name == 'workflow_dispatch' }}
     runs-on: ubuntu-latest
-    needs: build
-
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
       - name: Download build artifact
         uses: actions/download-artifact@v4
         with:
           name: site
           path: site
+          run-id: ${{ inputs.run_id }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Deploy PR Preview
         uses: JamesIves/github-pages-deploy-action@v4
         with:
           branch: gh-pages-pr-previews
           folder: site
-          target-folder: pr-${{ github.event.pull_request.number }}
-          workspace: /home/runner/work/${{ github.event.repository.name }}/${{ github.event.repository.name }}
+          target-folder: pr-${{ inputs.pr_number }}
 
       - name: Comment Preview URL
         uses: marocchino/sticky-pull-request-comment@v2
         with:
           recreate: true
+          number: ${{ inputs.pr_number }}
           message: |
             🚀 **Preview Ready!**
             Your docs preview for this PR is available here:
 
-            **https://pecanproject.github.io/pr-${{ github.event.pull_request.number }}/**
+            **https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/pr-${{ inputs.pr_number }}/**
 
   deploy-production:
-    # Runs ONLY on push to master
     if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' }}
     runs-on: ubuntu-latest
     needs: build
-
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
       - name: Download build artifact
         uses: actions/download-artifact@v4
         with: