Add CI pipeline for Quarto PR preview (#19)

Author: ytdHuang

.github/workflows/preview.yml

@@ -0,0 +1,45 @@
+name: Quarto PR preview
+
+on:
+  pull_request:
+    branches:
+      - main
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - ready_for_review
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write  # needed to allow julia-actions/cache to delete old caches that it has created
+      contents: write # needed for Quarto render
+      pull-requests: write # for GitHub action bot to write messages
+    if: ${{ !github.event.pull_request.draft }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+      - uses: julia-actions/setup-julia@v2
+        with:
+          version: '1'
+      - uses: julia-actions/cache@v2
+      - uses: julia-actions/julia-buildpkg@v1
+        with:
+          precompile: true
+      - uses: cardinalby/export-env-action@v2
+        with:
+          envFile: '_environment'    
+          expand: 'true'
+      - name: Quarto Render
+        uses: quarto-dev/quarto-actions/render@v2
+        with:
+          to: html
+      - name: Deploy PR Preview
+        uses: rossjrw/[email protected]
+        with:
+          source-dir: ./_output/
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish.yml

@@ -1,6 +1,6 @@
 name: Quarto Build
 
-on: # either one of the following four cases  
+on: # either one of the following three cases  
   workflow_dispatch: # manually trigger
 
   schedule:
@@ -9,22 +9,12 @@ on: # either one of the following four cases
   push:
     branches: main
 
-  pull_request:
-    branches:
-      - main
-    types:
-      - opened
-      - reopened
-      - synchronize
-      - ready_for_review
-
 jobs:
   build:
     runs-on: ubuntu-latest
     permissions:
       actions: write  # needed to allow julia-actions/cache to delete old caches that it has created
       contents: write # needed for Quarto render
-    if: ${{ !github.event.pull_request.draft }}
     steps:
       - uses: actions/checkout@v4
       - name: Set up Quarto
@@ -44,11 +34,11 @@ jobs:
         uses: quarto-dev/quarto-actions/render@v2
         with:
           to: html
-      - name: Quarto Publish
-        if: ${{ github.ref == 'refs/heads/main' && github.event_name != 'pull_request' }}
-        uses: quarto-dev/quarto-actions/publish@v2
+      - name: Deploy page
+        uses: JamesIves/github-pages-deploy-action@v4
         with:
-          render: 'false'  # rendered in the previous step already
-          target: gh-pages
+          folder: _output/
+          clean-exclude: pr-preview/
+          force: false
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}