gh-pages.yml

name: Docs

on:
  push:
    branches:
      - master
  pull_request:
    branches:
      - master

permissions:
  contents: write

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    name: Build and deploy
    defaults:
      run:
        shell: bash -l {0}
    steps:
      - name: Checkout 🛎️
        uses: actions/checkout@v3
        with:
          persist-credentials: false
      - name: Setup Conda (Micromamba)
        uses: mamba-org/setup-micromamba@v1
        with:
          cache-downloads: true
          environment-file: environment-docs.yml
      - name: Install xdatasets (docs)
        run: |
          python -m ipykernel install --user --name=xdatasets
          pip install --editable ".[docs]"
      - name: Check versions
        run: |
          pip check || true
      - name: Build docs
        shell: bash -l {0}
        run: |
          make docs
      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@v4.2.2
        with:
          branch: gh-pages # The branch the action should deploy to.
          folder: docs/_build/html # The folder the action should deploy.