docsite-build-deploy.yml

name: Build and Deploy Docsite
on:
  push:
    tags:
      - '*'
  workflow_dispatch: # Used to make post-release docfixes
permissions:
  contents: write

env:
  CELLXGENE_CENSUS_USERAGENT: "CZI-test"

jobs:
  build-and-deploy:
    concurrency: ci-${{ github.ref }}
    runs-on: sc-dev-64g-runner
    steps:
      - name: Checkout 🛎️
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - name: Install Python deps 🔧 
        run: |
          python -m pip install -U pip setuptools wheel
          pip install -r ./api/python/cellxgene_census/scripts/requirements-dev.txt
          pip install -e './api/python/cellxgene_census/[experimental,doc]'
          mkdir -p docsite
          touch docsite/.nojekyll

      - name: Install system deps
        run: |
          sudo apt-get update
          sudo apt-get install -y libcairo2-dev rsync

      - name: Install Pandoc
        run: |
          sudo apt-get install -y pandoc

      - name: Build Sphinx website
        run: |
          cd docs/
          make clean && make html

      - name: Copy everything to docsite directory
        run: |
          # Python docs
          cp -r docs/_build/html/* docsite/.

          # R docs
          mkdir -p docsite/r
          cp -r api/r/cellxgene.census/docs/* docsite/r/.

      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          folder: docsite # The folder the action should deploy.
          branch: gh-pages