build_docs.yaml

name: Publish Docs

on:
  push:
    branches: [ master ]
  release:
    types: [ created ]

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

jobs:
  docs:
    name: Publish Docs
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
        with:
          persist-credentials: false

      - name: Setup Conda
        uses: s-weigand/setup-conda@v1
        with:
          python-version: 3.9
          conda-channels: conda-forge

      - name: Install and Build
        shell: bash
        run: |
          conda config --prepend channels conda-forge
          conda config --set channel_priority strict
          conda create -n docs python=3.9 rasterio xarray scipy pyproj pandoc
          source activate docs
          python -m pip install -e .[doc]
          sphinx-build -b html docs/ docs/_build/

      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@v4
        if: ${{ github.event_name == 'release' }}
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          branch: gh-pages
          folder: docs/_build/
          clean: false
          target-folder: ${{ github.ref }}

      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@v4
        if: ${{ github.event_name == 'push' }}
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          branch: gh-pages
          folder: docs/_build/
          clean: false
          target-folder: latest