ci(docs): deploy VuePress to GitHub Pages

Author: cuihairu

.github/workflows/docs.yml

@@ -0,0 +1,42 @@
+name: Docs (GitHub Pages)
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch: {}
+
+permissions:
+  contents: write
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+          cache: npm
+          cache-dependency-path: docs/package-lock.json
+
+      - name: Install
+        working-directory: docs
+        run: npm ci
+
+      - name: Build
+        working-directory: docs
+        run: npm run build
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_branch: gh-pages
+          publish_dir: docs/.vuepress/dist
+          enable_jekyll: false

docs/.vuepress/config.js

@@ -2,6 +2,8 @@ module.exports = {
   lang: 'zh-CN',
   title: 'Clasp',
   description: 'C++17 的 Cobra-like 命令行框架（兼容行为优先）',
+  // GitHub Pages project site base (https://<user>.github.io/<repo>/)
+  base: '/clasp/',
 
   themeConfig: {
     repo: 'cuihairu/clasp',
@@ -30,4 +32,3 @@ module.exports = {
     },
   },
 }
-