name: '📚 Docs'

# Triggering and path filtering are owned by ci.yaml (the orchestrator), which
# calls this as a reusable workflow. workflow_dispatch is kept for manual runs.
on:
  workflow_call:
  workflow_dispatch:

jobs:
  deploy:
    runs-on: linux/amd64
    container:
      image: gitea.tourolle.paris/dtourolle/kpnpp-builder:latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0   # full history needed for mkdocs gh-deploy

      - name: Configure git identity
        run: |
          git config user.name  "Gitea Actions"
          git config user.email "actions@gitea.tourolle.paris"

      - name: Build and deploy to gitea-pages branch
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          mkdocs gh-deploy \
            --force \
            --remote-branch gitea-pages \
            --remote-name origin \
            --message "docs: deploy from ${{ github.sha }}"