publish.yml

name: Build and publish Sphinx site

on:
  push:
    branches: [ master ]
    paths: [ 'docs/**' ]

jobs:
  build_and_publish:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout repository
      uses: actions/checkout@v4

    - name: Set up python
      uses: actions/setup-python@v4
      with:
        python-version: "3.11"

    - name: Install doc env
      run: |
        python -m pip install -r docs/requirements.txt

    - uses: taminomara/sphinx-problem-matcher@v1.0.0
    - name: Build docs
      run: |
        cd docs
        make html

    - name: Commit documentation changes
      run: |
        git clone https://github.com/pangeo-data/pangeo.git --branch gh-pages --single-branch gh-pages
        cp -r docs/_build/html/* gh-pages/
        cd gh-pages
        git config --local user.email "action@github.com"
        git config --local user.name "GitHub Action"
        git add .
        git commit -m "Update documentation" -a || true
        
    - name: Push documentation changes to gh-pages
      uses: ad-m/github-push-action@master
      with:
        branch: gh-pages
        directory: gh-pages
        github_token: ${{ secrets.GITHUB_TOKEN }}