Files
GuideBook/scripts/export-static.sh
T
2026-11-13 17:57:50 +08:00

95 lines
3.4 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
# export-static.sh —— 导出可离线浏览的 VitePress 静态包
#
# 用法:
# bash scripts/export-static.sh # 仅构建并修复路径
# bash scripts/export-static.sh --pack # 额外打包成 dist.zip
#
# 产物路径:docs/.vitepress/dist/ (附 start-server.command / start-server.bat)
#
# 原理:
# 1) 以 base=./ 构建,让 JS/CSS 等资源引用指向相对路径。
# 2) VitePress 对 Markdown 里的 /media/xxx 不会按 HTML 所在层级自动调相对
# 路径,所以这里手工把 guide/*.html 里的 /media/ 改成 ../media/,根目录
# 的 *.html 里的 /media/ 改成 ./media/。
# 3) 放入 start-server.command / start-server.bat,用 Python/Node 起本地
# HTTP 服务(解决浏览器对 file:// 下 ES Module 的 CORS 限制)。
#
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
DIST="$ROOT/docs/.vitepress/dist"
cd "$ROOT"
echo "==> 1) 构建 VitePress(base=./)"
VITEPRESS_BASE=./ pnpm docs:build
echo "==> 2) 修复 Markdown 绝对图片路径"
# guide/*.html 需要 ../media/,根目录 *.html 需要 ./media/
if [ -d "$DIST/guide" ]; then
for f in "$DIST"/guide/*.html; do
[ -e "$f" ] || continue
sed -i '' 's|src="/media/|src="../media/|g; s|href="/media/|href="../media/|g' "$f"
done
fi
for f in "$DIST"/*.html; do
[ -e "$f" ] || continue
sed -i '' 's|src="/media/|src="./media/|g; s|href="/media/|href="./media/|g' "$f"
done
# 校验是否还有残留
if grep -RIn 'src="/media\|href="/media' "$DIST" >/dev/null 2>&1; then
echo "⚠️ 仍有绝对 /media/ 路径残留,建议检查"
grep -RIn 'src="/media\|href="/media' "$DIST" | head
else
echo "✅ /media 路径全部转为相对"
fi
echo "==> 3) 写入本地 HTTP 启动脚本"
cat > "$DIST/start-server.command" <<'EOF'
#!/bin/bash
# Digi Agent Builder 3.0 指导书 - 本地静态服务启动器(macOS / Linux)
cd "$(dirname "$0")"
PORT=8000
if command -v python3 &>/dev/null; then
open "http://localhost:${PORT}/" 2>/dev/null || true
python3 -m http.server "${PORT}"
elif command -v python &>/dev/null; then
open "http://localhost:${PORT}/" 2>/dev/null || true
python -m SimpleHTTPServer "${PORT}"
elif command -v node &>/dev/null; then
open "http://localhost:${PORT}/" 2>/dev/null || true
npx --yes serve -l "${PORT}" .
else
echo "未检测到 Python 或 Node,请先安装 Python 3。"
read -n 1 -s -r -p "按任意键退出..."
fi
EOF
chmod +x "$DIST/start-server.command"
cat > "$DIST/start-server.bat" <<'EOF'
@echo off
REM Digi Agent Builder 3.0 指导书 - 本地静态服务启动器(Windows)
cd /d "%~dp0"
set PORT=8000
where python3 >nul 2>&1 && (start "" "http://localhost:%PORT%/" & python3 -m http.server %PORT% & goto :eof)
where python >nul 2>&1 && (start "" "http://localhost:%PORT%/" & python -m SimpleHTTPServer %PORT% & goto :eof)
where node >nul 2>&1 && (start "" "http://localhost:%PORT%/" & npx --yes serve -l %PORT% . & goto :eof)
echo 未检测到 Python 或 Node,请先安装 Python 3。
pause
EOF
echo ""
echo "✅ 静态导出完成:$DIST"
echo " macOS / Linux:双击 start-server.command"
echo " Windows:双击 start-server.bat"
if [[ "${1:-}" == "--pack" ]]; then
ZIP="$ROOT/dist-export.zip"
echo ""
echo "==> 4) 打包 dist-export.zip"
rm -f "$ZIP"
(cd "$DIST" && zip -rq "$ZIP" . -x '*.DS_Store')
echo "✅ 打包完成:$ZIP ($(du -sh "$ZIP" | awk '{print $1}'))"
fi