Docs

tweaks #3

	name: Docs
	on: [push, release]

	jobs:
	deploy-rtd:
	name: "Build docs and deploy to RTD"
	runs-on: ubuntu-latest
	if: ${{ !github.event.pull_request.draft }}
	strategy:
	fail-fast: false
	steps:
	- uses: actions/checkout@v3
	- name: Set up Python
	uses: actions/setup-python@v4
	with:
	python-version: 3.12
	- name: Install llvmpipe and lavapipe for offscreen canvas, and git lfs
	run: \|
	sudo apt-get update -y -qq
	sudo apt-get install --no-install-recommends -y libegl1-mesa libgl1-mesa-dri libxcb-xfixes0-dev mesa-vulkan-drivers git-lfs
	- name: Install dev dependencies
	run: \|
	python -m pip install --upgrade pip setuptools
	# remove pygfx from install_requires, we install using pygfx@main
	sed -i "/pygfx/d" ./setup.py
	pip install git+https://github.com/pygfx/pygfx.git@main
	pip install -e ".[notebook,docs,tests]"
	- name: Generate gallery
	run: \|
	RTD_BUILD=1 GITHUB_ARTIFACT_RTD=0 sphinx-build -b dummy docs/source/ /tmp

	- uses: actions/upload-artifact@v4
	with:
	name: gallery-${{ github.sha }}
	path: docs/source/_gallery

	- name: Trigger RTDs build
	uses: dfm/rtds-action@v1
	with:
	webhook_url: ${{ secrets.RTDS_WEBHOOK_URL }}
	webhook_token: ${{ secrets.RTDS_WEBHOOK_TOKEN }}
	commit_ref: ${{ github.ref }}

Provide feedback