name: Build and deploy docs

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: docs-runner        # must match the label of your registered act_runner
    steps:
      - name: Debug
        run: |
          echo "REPOSITORY=$GITHUB_REPOSITORY"
          echo "SERVER_URL=$GITHUB_SERVER_URL"
          echo "GITEA_URL=$GITEA_URL"
          env | sort | egrep -i 'GITHUB|GITEA|SERVER|URL|REPOSITORY' || true

      - name: Checkout
        uses: actions/checkout@v4
        with:
          repository: bitcoinafterlife/bal-docs
          server-url: https://bitcoin-after.life/gitea
          fetch-depth: 1
      - name: Install dependencies
        run: pip install --break-system-packages mkdocs-material mkdocs-macros-plugin pyyaml

      - name: Generate placeholders for missing screenshots
        run: python3 tools/make_placeholders.py

      - name: Build site (strict — fails on broken links)
        run: mkdocs build --strict

      - name: Publish
        run: rsync -a --delete site/ /var/www/bal-docs/