mkdocs.yml

name: MkDocs Documentation

on:
  workflow_dispatch:

# Disabled - triggers commented out below for reference
# on:
#   push:
#     branches: [main, 3.0.x, 2.28.x, 'migration/**', 'fix-AA-feedback', 'afrigis-new-screenshots']
#     paths:
#       - 'doc/**'
#       - '.github/workflows/mkdocs.yml'
#   pull_request:
#     branches: [main, 3.0.x, 2.28.x]
#     paths:
#       - 'doc/**'
#       - '.github/workflows/mkdocs.yml'

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v6
      
      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: '3.x'
          cache: 'pip'
      
      - name: Install MkDocs dependencies
        run: |
          pip install mkdocs mkdocs-material mkdocs-macros-plugin mkdocs-with-pdf pymdown-extensions
      
      - name: Build unified documentation
        run: |
          mkdocs build
      
      - name: Prepare GitHub Pages output
        run: |
          # Copy the unified build output
          mkdir -p gh-pages-output
          cp -r mkdocs_output/* gh-pages-output/
      
      - name: Deploy to GitHub Pages
        if: github.event_name == 'push' && (github.ref == 'refs/heads/3.0.x' || github.ref == 'refs/heads/2.28.x' || github.ref == 'refs/heads/fix-AA-feedback' || github.ref == 'refs/heads/afrigis-new-screenshots' || github.ref == 'refs/heads/main')
        uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./gh-pages-output
          destination_dir: ${{ github.ref_name }}
          cname: docs-test.smythe.co.za