将文档构建工具迁移至 Starlight

Author: neveler

.drone.yml

@@ -6,32 +6,25 @@ clone:
   depth: 1
 
 steps:
-- name: build
-  image: ruby:3.4
-  environment:
-    JEKYLL_ENV: production
-    BUNDLE_PATH: vendor/bundle
-  commands:
-    - bundle config mirror.https://rubygems.org https://mirrors.cloud.tencent.com/rubygems
-    - bundle install --verbose
-    - bundle exec jekyll build --trace --verbose --config _config.yml,_config.drone.yml
-  volumes:
-  - name: dist
-    path: /drone/src/_site
-  - name: vendor
-    path: /drone/src/vendor
-  - name: jekyll-cache
-    path: /drone/src/.jekyll-cache
-  when:
-    branch: [main]
+  - name: build
+    image: node:24-alpine
+    environment:
+      PUBLIC_SITE_URL: "https://docs.hmcl.net"
+    commands:
+      - npm install
+      - npm run build
+    volumes:
+      - name: dist
+        path: /drone/src/dist
+      - name: node_modules
+        path: /drone/src/node_modules
+    when:
+      branch: [main]
 
 volumes:
-- name: dist
-  host:
-    path: /home/ubuntu/docs.hmcl.net/www
-- name: vendor
-  host:
-    path: /home/ubuntu/docs.hmcl.net/cache/vendor
-- name: jekyll-cache
-  host:
-    path: /home/ubuntu/docs.hmcl.net/cache/jekyll-cache
+  - name: dist
+    host:
+      path: /home/ubuntu/docs.hmcl.net/www
+  - name: node_modules
+    host:
+      path: /home/ubuntu/docs.hmcl.net/cache/node_modules

.github/workflows/gitee.yml

@@ -1,7 +1,6 @@
 name: Sync to Gitee
 
-on:
-  push
+on: push
 
 jobs:
   run:
@@ -13,7 +12,7 @@ jobs:
         with:
           src: github/HMCL-dev
           dst: gitee/huanghongxun
-          static_list: 'HMCL-docs'
+          static_list: "HMCL-docs"
           force_update: true
           debug: true
           dst_key: ${{ secrets.GITEE_SYNC_BOT_PRIVATE_KEY }}

.github/workflows/pr-preview.yml

@@ -11,7 +11,6 @@ concurrency:
   cancel-in-progress: false
 env:
   GITHUB_PR_NUMBER: ${{ github.event_name == 'issue_comment' && github.event.issue.number || github.event.pull_request.number }}
-  JEKYLL_ENV: production
 jobs:
   cache-refresh:
     if: ${{ !github.event.repository.fork && github.event_name == 'schedule' && github.event.schedule == '0 0 */6 * *' }}
@@ -201,15 +200,6 @@ jobs:
   preview-create-build:
     needs: preview-create-init
     runs-on: ubuntu-latest
-    env:
-      PREVIEW_WATCH:
-        ${{
-          contains(github.event.pull_request.labels.*.name, 'preview/watch') ||
-          contains(github.event.issue.labels.*.name, 'preview/watch') || (
-            github.event_name == 'issue_comment' &&
-            github.event.comment.body == '/preview watch'
-          )
-        }}
     outputs:
       artifact-id: ${{ steps.upload-site.outputs.artifact-id }}
     steps:
@@ -224,22 +214,16 @@ jobs:
           git fetch https://github.com/${{ needs.preview-create-init.outputs.repository }} ${{ needs.preview-create-init.outputs.sha }}
           git merge --squash ${{ needs.preview-create-init.outputs.sha }} --no-edit
           git commit -m "Merge #${{ env.GITHUB_PR_NUMBER }} for preview build"
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
+      - name: Setup Node
+        uses: actions/setup-node@v6
         with:
-          ruby-version: "3.4"
-          bundler-cache: ${{ env.PREVIEW_WATCH }}
-          cache-version: PR-${{ env.GITHUB_PR_NUMBER }}
-      - name: Jekyll Build
+          node-version: 24
+      - name: Build
         run: |
-          echo "url: https://${{ needs.preview-create-init.outputs.domain }}" > _action.yml
-          echo "baseurl: ${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}" >> _action.yml
-          echo "source: ${{ github.workspace }}" >> _action.yml
-          echo "destination: /home/runner/site" >> _action.yml
-          echo "preview:" >> _action.yml
-          echo "  pr-number: ${{ env.GITHUB_PR_NUMBER }}" >> _action.yml
-          ${{ env.PREVIEW_WATCH }} || bundle install --jobs 4
-          bundle exec jekyll build --trace --config _config.yml,_action.yml
+          npm install
+          npm run build -- --outDir /home/runner/site
+        env:
+          PUBLIC_SITE_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
       - id: upload-site
         name: Upload Site
         uses: actions/upload-artifact@v4

.gitignore

@@ -1,8 +1,27 @@
-_site
-.sass-cache
-.jekyll-cache
-.jekyll-metadata
-vendor
-Gemfile.lock
-.bundle
-/.idea/
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# lock
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+bun.lock
+bun.lockb
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

.prettierignore

@@ -0,0 +1 @@
+.github/workflows/pr-preview.yml

.prettierrc

@@ -0,0 +1,15 @@
+{
+  "printWidth": 100,
+  "semi": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "plugins": ["prettier-plugin-astro"],
+  "overrides": [
+    {
+      "files": "*.astro",
+      "options": {
+        "parser": "astro"
+      }
+    }
+  ]
+}

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode", "esbenp.prettier-vscode", "unifiedjs.vscode-mdx"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "editor.tabSize": 2
+}