build_docs.yaml

name: Build Documentation

on:
  push:
    branches:
      - main

jobs:
  build-documentation:
    runs-on: ubuntu-latest
    defaults:
      run:
        shell: bash -l {0}
    steps:
      - uses: actions/checkout@v3

      - name: Setup Mambaforge Python 3.10
        uses: conda-incubator/setup-miniconda@v2
        with:
          environment-file: environment.yml
          miniforge-variant: Mambaforge
          miniforge-version: latest
          python-version: "3.10"
          activate-environment: rdmc_env
          use-mamba: true

      - name: Install RDMC
        run: python -m pip install --no-deps -vv ./

      - name: Install sphinx
        run: mamba install -y sphinx=7.2.4 pydata-sphinx-theme
        # 09/11/2023: sphinx 7.2.5 has an issue with numpy https://github.com/sphinx-doc/sphinx/issues/11662

      - name: Mamba info
        run: |
          mamba info
          mamba list

      - name: Make documentation
        run: |
          cd docs
          make -C ./ clean html
          make html

      - name: Deploy documentation
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./docs/build/html