ruff/.github/workflows/docs.yaml

name: mkdocs

on:
  push:
    paths:
      - README.md
      - mkdocs.yml
      - .github/workflows/docs.yaml
    branches: [ main ]
  pull_request:

jobs:
  mkdocs:
    runs-on: ubuntu-latest
    env:
       CF_API_TOKEN_EXISTS: ${{ secrets.CF_API_TOKEN != '' }}
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
      - name: "Install dependencies"
        run: |
          pip install "mkdocs~=1.4.2" "mkdocs-material~=9.0.6"
      - name: "Copy README File"
        run: |
          python scripts/transform_readme.py --target mkdocs
          mkdir -p docs/
          cp README.md docs/index.md
          mkdocs build
      - name: "Deploy to Cloudflare Pages"
        if: ${{ env.CF_API_TOKEN_EXISTS == 'true' }}
        uses: cloudflare/wrangler-action@2.0.0
        with:
          apiToken: ${{ secrets.CF_API_TOKEN }}
          accountId: ${{ secrets.CF_ACCOUNT_ID }}
          command: pages publish site --project-name=ruff-docs --branch ${GITHUB_HEAD_REF} --commit-hash ${GITHUB_SHA}