name: Deploy Docs on: push: branches: - Document workflow_dispatch: permissions: contents: write jobs: build: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: "3.12" - name: Install dependencies run: | python -m pip install --upgrade pip pip install sphinx recommonmark sphinx-rtd-theme sphinx-markdown-tables # 可选: 使用 myst-parser 代替 recommonmark # pip install myst-parser - name: Build multilingual HTML run: | # Build English sphinx-build -b html docs/en docs/en/_build/html # Build Chinese sphinx-build -b html docs/zh docs/zh/_build/html # Merge outputs to unified publish directory mkdir -p docs/_build/html cp -r docs/en/_build/html docs/_build/html/en cp -r docs/zh/_build/html docs/_build/html/zh # Root redirect to English (可根据需要改成 zh) echo 'Redirecting...' > docs/_build/html/index.html - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_branch: gh-pages publish_dir: docs/_build/html