Fix preview server to handle Docusaurus baseUrl setting

- Update preview scripts to account for Docusaurus baseUrl '/flywave.gl/'
- Add cache disabling flag (-c-1) to ensure latest files are loaded
- Update documentation with correct URL path and important notes
- The site will now be accessible at http://localhost:3002/flywave.gl/

Author: w12594822

docs/PREVIEW_GUIDE.md

@@ -10,7 +10,7 @@ npm run preview-build       # 启动服务但不自动打开浏览器
 npm run preview-build-open # 启动服务并自动打开浏览器
 ```
 
-服务器将在 http://localhost:3002 上运行。
+服务器将在 http://localhost:3002/flywave.gl/ 上运行。
 
 ## 方法二：使用脚本文件
 
@@ -33,17 +33,19 @@ npm install -g http-server
 
 # 在 docs/build 目录启动服务器
 cd docs
-http-server build -p 3002 -o
+http-server build -p 3002 -o -c-1
 ```
 
 或者使用 npx：
 ```bash
 cd docs
-npx http-server build -p 3002 -o
+npx http-server build -p 3002 -o -c-1
 ```
 
-## 注意事项
+## 重要注意事项
 
 - 确保先运行 `npm run build` 或 `npm run docusaurus-build` 来构建站点
+- 由于 Docusaurus 配置中的 baseUrl 为 "/flywave.gl/"，网站将在 http://localhost:3002/flywave.gl/ 上提供服务
+- 使用 `-c-1` 参数禁用缓存以确保最新的文件被加载
 - 服务器默认运行在端口 3002 上，以避免与开发服务器冲突
 - 按 Ctrl+C 可以停止服务器

docs/package.json

@@ -16,8 +16,8 @@
         "docusaurus-build": "docusaurus build",
         "docusaurus-build-zh": "docusaurus build --locale zh",
         "docusaurus-build-en": "docusaurus build --locale en",
-        "preview-build": "http-server build -p 3002",
-        "preview-build-open": "http-server build -p 3002 -o",
+        "preview-build": "http-server build -p 3002 -c-1",
+        "preview-build-open": "http-server build -p 3002 -o -c-1",
         "swizzle": "docusaurus swizzle",
         "deploy": "docusaurus deploy",
         "clear": "docusaurus clear",

docs/preview-build.js

@@ -1,13 +1,12 @@
 #!/usr/bin/env node
 
 const { spawn } = require('child_process');
-const path = require('path');
 
 // 启动预览构建后网站的脚本
 console.log('Starting preview of built documentation site...');
 
-// 使用 http-server 预览 build 目录
-const server = spawn('npx', ['http-server', 'build', '-p', '3002', '-o'], {
+// 使用 http-server 预览 build 目录，设置基础路径为 /flywave.gl/
+const server = spawn('npx', ['http-server', 'build', '-p', '3002', '-o', '-c-1'], {
   cwd: __dirname,  // 设置当前工作目录为脚本所在目录 (docs)
   stdio: 'inherit' // 继承父进程的stdio
 });
@@ -20,5 +19,5 @@ server.on('close', (code) => {
   console.log(`Server process exited with code ${code}`);
 });
 
-console.log('Documentation site preview is running at http://localhost:3002');
+console.log('Documentation site preview is running at http://localhost:3002/flywave.gl/');
 console.log('Press Ctrl+C to stop the server.');

docs/preview-build.sh

@@ -6,8 +6,8 @@ echo "Starting preview of built documentation site..."
 # 获取脚本所在目录
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-# 在 docs 目录下启动 http-server 来预览 build 目录
-cd "$SCRIPT_DIR" && npx http-server build -p 3002 -o
+# 在 docs 目录下启动 http-server 来预览 build 目录，设置基础路径
+cd "$SCRIPT_DIR" && npx http-server build -p 3002 -o -c-1
 
-echo "Documentation site preview is running at http://localhost:3002"
+echo "Documentation site preview is running at http://localhost:3002/flywave.gl/"
 echo "Press Ctrl+C to stop the server."