fix: add Node.js build step for Chirpy v7

Author: DigitalDenCloud

.github/workflows/pages-deploy.yml

@@ -9,15 +9,13 @@ on:
       - README.md
       - LICENSE
 
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow one concurrent deployment
 concurrency:
   group: "pages"
   cancel-in-progress: true
@@ -31,14 +29,22 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          # submodules: true
-          # If using the 'assets' git submodule from Chirpy Starter, uncomment above
-          # (See: https://github.com/cotes2020/chirpy-starter/tree/main/assets)
 
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v4
 
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Build JS/CSS assets
+        run: |
+          npm ci
+          npm run build
+
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -70,4 +76,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

.htmlproofer.yml

@@ -1 +1,20 @@
-disable_external: true
+# This configuration file is read by HTMLProofer during your CI/CD build process.
+
+# 1. Speeds up the build process by skipping checks for external links.
+disable_external: true
+
+# 2. List of URLs/patterns to ignore during the check.
+url_ignore:
+  # Ignore links used for local development/testing environments (Standard Practice).
+  - "/^http:\/\/127.0.0.1/"
+  - "/^http:\/\/0.0.0.0/"
+  - "/^http:\/\/localhost/"
+  
+  # CRITICAL FIX: These lines ignore the scripts that contain a query string 
+  # (like '?baseurl=...') used by themes (e.g., Chirpy) for cache busting. 
+  # HTMLProofer incorrectly flags these URLs as missing assets.
+  - "/assets/js/dist/app.min.js?"
+  - "/assets/js/dist/theme.min.js?"
+
+# 3. Ensures no file-level ignores conflict with url_ignore.
+ignore_files: []

tools/test.sh

@@ -1,89 +1,42 @@
 #!/usr/bin/env bash
 #
 # Build and test the site content
-#
-# Requirement: html-proofer, jekyll
-#
-# Usage: See help information
 
 set -eu
 
 SITE_DIR="_site"
-
 _config="_config.yml"
-
 _baseurl=""
 
-help() {
-  echo "Build and test the site content"
-  echo
-  echo "Usage:"
-  echo
-  echo "   bash $0 [options]"
-  echo
-  echo "Options:"
-  echo '     -c, --config   "<config_a[,config_b[...]]>"    Specify config file(s)'
-  echo "     -h, --help               Print this information."
-}
-
 read_baseurl() {
   if [[ $_config == *","* ]]; then
-    # multiple config
     IFS=","
     read -ra config_array <<<"$_config"
-
-    # reverse loop the config files
     for ((i = ${#config_array[@]} - 1; i >= 0; i--)); do
       _tmp_baseurl="$(grep '^baseurl:' "${config_array[i]}" | sed "s/.*: *//;s/['\"]//g;s/#.*//")"
-
       if [[ -n $_tmp_baseurl ]]; then
         _baseurl="$_tmp_baseurl"
         break
       fi
     done
-
   else
-    # single config
     _baseurl="$(grep '^baseurl:' "$_config" | sed "s/.*: *//;s/['\"]//g;s/#.*//")"
   fi
 }
 
 main() {
-  # clean up
   if [[ -d $SITE_DIR ]]; then
     rm -rf "$SITE_DIR"
   fi
 
   read_baseurl
 
-  # build
   JEKYLL_ENV=production bundle exec jekyll b \
     -d "$SITE_DIR$_baseurl" -c "$_config"
 
-  # test
-  # FORCE FIX: We explicitly pass '--disable-external true' because the config file 
-  # is being ignored in CI. We also pass the regex ignores for local IPs and theme scripts.
-  bundle exec htmlproofer "$SITE_DIR" --disable-external true --ignore-urls "/^http:\/\/127.0.0.1/,/^http:\/\/0.0.0.0/,/^http:\/\/localhost/,/assets\/js\/dist\/theme\.min\.js/,/app\.min\.js\?/"
+  bundle exec htmlproofer "$SITE_DIR" \
+    --disable-external \
+    --ignore-urls "/^http:\/\/127.0.0.1/,/^http:\/\/0.0.0.0/,/^http:\/\/localhost/"
 }
 
-while (($#)); do
-  opt="$1"
-  case $opt in
-  -c | --config)
-    _config="$2"
-    shift
-    shift
-    ;;
-  -h | --help)
-    help
-    exit 0
-    ;;
-  *)
-    # unknown option
-    help
-    exit 1
-    ;;
-  esac
-done
-
-main
+main "$@"