docs.yml

name: Trigger Read the Docs Build

on:
  push:
    branches: [main]
    paths:
      - "docs/**"
      - ".readthedocs.yaml"
      - "pyproject.toml"
  release:
    types: [published]
  workflow_dispatch:

jobs:
  trigger-rtd:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger Read the Docs webhook
        env:
          WEBHOOK_URL: ${{ secrets.READTHEDOCS_WEBHOOK_URL }}
          WEBHOOK_TOKEN: ${{ secrets.READTHEDOCS_WEBHOOK_TOKEN }}
        run: |
          PAYLOAD='{"ref": "refs/heads/main"}'
          SIGNATURE=$(echo -n "${PAYLOAD}" | openssl dgst -sha256 -hmac "${WEBHOOK_TOKEN}" | awk '{print $2}')
          curl -X POST \
            -H "Content-Type: application/json" \
            -H "X-Hub-Signature-256: sha256=${SIGNATURE}" \
            -d "${PAYLOAD}" \
            "${WEBHOOK_URL}"