Skip to content

Build and Deploy Docsite #85

Build and Deploy Docsite

Build and Deploy Docsite #85

name: Build and Deploy Docsite
on:
push:
tags:
- '*'
workflow_dispatch: # Used to make post-release docfixes
permissions:
contents: write
jobs:
build-and-deploy:
concurrency: ci-${{ github.ref }}
runs-on: ubuntu-latest
steps:
- name: Checkout 🛎️
uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: actions/setup-python@v5
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