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: 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/gitea_runner/venv/bin:$PATH" >> $GITHUB_ENV

      - name: Install dependencies
        run: pip install --break-system-packages mkdocs-material mkdocs-macros-plugin pyyaml pillow mkdocs-glightbox

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