docs-build-and-deploy.yml

name: Docs build and deploy
on:
  push:
    branches:
      - main
jobs:
  build-and-deploy:
    concurrency: ci-${{ github.ref }} # Recommended if you intend to make multiple deployments in quick succession.
    runs-on: ubuntu-latest
    steps:
      - name: Checkout 🛎️
        uses: actions/checkout@v3

      - name: Install Pandoc
        uses: r-lib/actions/setup-pandoc@v2

      - name: Install miniconda and activate environment
        uses: conda-incubator/setup-miniconda@v2
        with:
          activate-environment: gctree
          environment-file: environment.yml
          python-version: 3.9
          auto-activate-base: false
          auto-update-conda: true

      - name: Build 🔧
        # NOTE: must specify the shell so that conda init updates bashrc see:
        #      https://github.com/conda-incubator/setup-miniconda#IMPORTANT
        shell: bash -l {0}
        run: |
          make docs
        env:
          QT_QPA_PLATFORM: offscreen
          XDG_RUNTIME_DIR: /tmp/runtime-runner
          MPLBACKEND: agg

      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@v4.2.2
        with:
          branch: docs # The branch the action should deploy to.
          folder: docs/_build/html # The folder the action should deploy.