docsite-build-deploy.yml

name: Build and Deploy Docsite
on:
  push:
    tags:
permissions:
  contents: write
jobs:
  build-and-deploy:
    concurrency: ci-${{ github.ref }}
    runs-on: single-cell-8c64g-runner
    steps:
      - name: Checkout 🛎️
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: actions/setup-python@v4
        with:
          python-version: "3.10"

      - 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 -r ./docs/requirements.txt
          pip install -e './api/python/cellxgene_census/[experimental]'
          mkdir -p docsite
          touch docsite/.nojekyll

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

      - name: Build Sphinx website
        run: |
          cd docs/
          make clean && make html
          cp -r _build/html/* ../docsite/.

          # Copy R pkgdown docs (static HTML checked into git)
          cd ../
          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