name: docs-ci

on:
  workflow_dispatch:
  push:
    branches:
      - main
    paths:
      - docs/**
      - docs-standalone/**
      - .github/workflows/docs-release.yml
      - mkdocs.yml
      - docs-standalone/mkdocs.yml
      - HMI/README.md

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/configure-pages@v5
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v6
        with:
          python-version: 3.x
      - run: pip install zensical
      - run: cp HMI/README.md docs/hmi-serial-protocol.md
      - run: zensical build --config-file mkdocs.yml
      - run: mv site _site_main
      - run: zensical build --config-file docs-standalone/mkdocs.yml
      - run: mkdir -p _site/standalone _site/stable
      - run: cp -a _site_main/. _site/
      - run: cp -a _site_main/. _site/stable/
      - run: |
          if [ -d site-standalone ]; then
            cp -a site-standalone/. _site/standalone/
          elif [ -d site ]; then
            cp -a site/. _site/standalone/
          else
            echo "Standalone docs output not found (expected 'site-standalone' or 'site')."
            exit 1
          fi
      - uses: actions/upload-pages-artifact@v4
        with:
          path: _site

  deploy:
    needs: build
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v4