docs-publish.yml

on:
  push:
    branches:
      - main
    paths:
      - "docs/**/*"
      - .github/workflows/docs-publish.yml
  workflow_dispatch:

name: Docs - Publish

env:
  UV_VERSION: "0.4.x"
  PYTHON_VERSION: 3.13
  QUARTO_VERSION: 1.6.35

jobs:
  docs-publish:
    runs-on: ubuntu-latest

    steps:
    - name: Check out repository
      uses: actions/checkout@v4
      with:
        fetch-depth: 0 # full history needed for correct versioning of py pkg

    - name: 🔵 Set up Quarto
      uses: quarto-dev/quarto-actions/setup@v2
      with:
        version: ${{ env.QUARTO_VERSION }}

    - name: 🚀 Install uv
      uses: astral-sh/setup-uv@v3
      with:
        version: ${{ env.UV_VERSION }}

    - name: 🐍 Set up Python ${{ env.PYTHON_VERSION }}
      run: uv python install ${{ env.PYTHON_VERSION }}

    - name: 📦 Install brand_yml and dependencies
      run: uv sync --python ${{ env.PYTHON_VERSION }} --no-dev --extra docs

    # From https://github.com/r-lib/actions/tree/v2-branch/setup-r
    # - name: Setup R
    #   uses: r-lib/actions/setup-r@v2

    - name: 🔌 Activate venv
      run: |
        source .venv/bin/activate
        echo "$VIRTUAL_ENV/bin" >> $GITHUB_PATH
        echo "VIRTUAL_ENV=$VIRTUAL_ENV" >> $GITHUB_ENV

    - name: 🏭 Update Python docs
      run: make py-docs

    - name: 🚢 Publish to GitHub Pages (and render)
      uses: quarto-dev/quarto-actions/publish@v2
      with:
        target: gh-pages
        path: docs