name: 构建和部署文档
# Build and Deploy Documentation

on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]

jobs:
  build-docs:
    runs-on: ubuntu-latest
    
    steps:
    - name: 检出代码
      uses: actions/checkout@v4
      
    - name: 设置Python环境
      uses: actions/setup-python@v4
      with:
        python-version: '3.11'
        
    - name: 安装依赖
      run: |
        python -m pip install --upgrade pip
        pip install -r documentation/sphinx-docs/requirements.txt
        
    - name: 构建Sphinx文档
      run: |
        cd documentation/sphinx-docs
        make html
        
    - name: 部署到GitHub Pages
      if: github.ref == 'refs/heads/main'
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./documentation/sphinx-docs/_build/html
        
    - name: 上传构建产物
      uses: actions/upload-artifact@v3
      with:
        name: documentation
        path: documentation/sphinx-docs/_build/html/