fix: github pages assets 404

.github/workflows/deploy-docs.yml → .github/workflows/deploy-ghpage.yml

@@ -4,8 +4,10 @@ name: Deploy Docs
 on:
   push:
     branches:
-      # make sure this is the branch you are using
       - main
+  pull_request:
+    paths:
+      - '.github/workflows/deploy-ghpage.yml'
 
 jobs:
   deploy-gh-pages:
@@ -15,16 +17,13 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          # if your docs needs submodules, uncomment the following line
           # submodules: true
 
-
       - name: Install pnpm
-        uses: pnpm/action-setup@v2
+        uses: pnpm/action-setup@v4
         with:
-          version: 7
-          run_install: true
-
+          version: 9.15.9
+          run_install: false
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -38,11 +37,13 @@ jobs:
       - name: Build Docs
         env:
           NODE_OPTIONS: --max_old_space_size=8192
+          DEPLOY_PLATFORM: github
         run: |-
           pnpm run docs:build
           > docs/.vuepress/dist/.nojekyll
 
       - name: Deploy
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

docs/.vuepress/config.ts

@@ -5,9 +5,17 @@ import theme from "./theme.js";
 
 const __dirname = getDirname(import.meta.url);
 
+const getBasePath = () => {
+  const platform = process.env.DEPLOY_PLATFORM;
+  if (platform === 'github') {
+    return '/docs/';
+  }
+  return '/';
+};
+
 export default defineUserConfig({
   theme,
-  base: "/", // For Github Pages
+  base: getBasePath(),
   head: [
     [
       "link",

package.json

@@ -12,6 +12,7 @@
     "ecosystem": "npx tsx scripts/ecosystem.ts",
     "dev-build": "vuepress build docs",
     "docs:build": "pnpm ecosystem && vuepress build docs",
+    "docs:build:github": "DEPLOY_PLATFORM=github pnpm ecosystem && vuepress build docs",
     "docs:clean-dev": "vuepress dev docs --clean-cache",
     "docs:dev": "vuepress dev docs",
     "dev": "pnpm docs:dev"