OrbbecSDK_ROS2/.github/workflows/build.yaml

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 '<!DOCTYPE html><html><head><meta http-equiv="refresh" content="0; url=en/index.html"></head><body>Redirecting...</body></html>' > 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