name: Deploy MkDocs to GitHub on: push: branches: - main paths: - 'docs/**' - 'mkdocs.yml' - '.github/workflows/mkdocs-deploy.yml' workflow_dispatch: permissions: contents: read pages: write id-token: write concurrency: group: "pages" cancel-in-progress: false jobs: build-and-deploy: runs-on: ubuntu-latest environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} steps: - name: Checkout 源码 uses: actions/checkout@v4 with: fetch-depth: 0 - name: 设置 Python 环境 uses: actions/setup-python@v5 with: python-version: '3.13' cache: 'pip' - name: 安装 MkDocs 及依赖 run: | python -m pip install --upgrade pip pip install -r requirements.txt - name: 构建 MkDocs 站点 run: mkdocs build - name: Setup Pages uses: actions/configure-pages@v5 - name: Upload artifact uses: actions/upload-pages-artifact@v3 with: path: ./site - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v5