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 repository
        run: |
          git clone --depth 1 https://oauth2:${GITHUB_TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY} .
          
      - name: Set up virtualenv
        run: |
        echo "PATH=/home/git/venv/bin:$PATH" >> $GITHUB_ENV

      - 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/
