docs.yaml

name: docs deployment
on:
  push:
    branches:
      - master
  pull_request:
    branches:
      - master

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

defaults:
  run:
    shell: bash -l {0}

jobs:
  docs:
    if: "github.repository == 'MDAnalysis/GridDataFormats'"
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
      with:
        fetch-depth: 0
        
    - name: setup_miniconda
      uses: conda-incubator/setup-miniconda@v2
      with:
        python-version: 3.11
        environment-file: ci/environment.yaml
        auto-update-conda: true
        channel-priority: flexible
        channels: conda-forge
        miniforge-variant: Mambaforge
        use-mamba: true
        
    - name: install package
      run: |
        pip install -v .

    - name: build docs
      run: |
        cd doc && sphinx-build -b html source build

    - name: deploy docs
      uses: peaceiris/actions-gh-pages@v3
      if: github.event_name != 'pull_request'
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./doc/build
        user_name: 'github-actions'
        user_email: 'github-action@users.noreply.github.com'