部署指南

部署指南

静态站点可以部署到各种平台。

本地预览

构建完成后，直接在浏览器中打开 dist/index.html 即可预览。

或者使用任意静态文件服务器：

# 使用 Bun
bun --serve dist

# 使用 Python
python -m http.server -d dist 8000

# 使用 Node.js
npx serve dist

部署到 GitHub Pages

1. 将 dist/ 目录推送到 gh-pages 分支
2. 在仓库设置中启用 GitHub Pages
3. 选择 gh-pages 分支作为源

部署到飞书妙搭

使用飞书妙搭的集成能力，将生成的 HTML 文件直接部署，获取可分享的访问链接。

CI/CD 自动构建

可以配合 GitHub Actions 实现提交文档后自动构建和部署：

name: Deploy Docs
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: oven-sh/setup-bun@v1
      - run: bun install
      - run: bun run main.ts
      - uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./dist