44 lines
		
	
	
		
			1.1 KiB
		
	
	
	
		
			YAML
		
	
	
	
			
		
		
	
	
			44 lines
		
	
	
		
			1.1 KiB
		
	
	
	
		
			YAML
		
	
	
	
| 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/ |