Standardise docs build: use __PKG_VERSION__, uv-based build.sh, minimal Makefile

Author: jeromekelleher

docs/Makefile

@@ -1,16 +1,5 @@
-
-# Need to set PYTHONPATH so that we pick up the local msprime
-PYPATH=${PWD}/..
-MSP_VERSION:=$(shell PYTHONPATH=${PYPATH} \
-   python3 -c 'import msprime; print(msprime.__version__.split("+")[0])')
-
-dev:
-	PYTHONPATH=${PYPATH} ./build.sh
-
-dist:
-	@echo Building distribution for msprime version ${MSP_VERSION}
-	sed -i s/__MSPRIME_VERSION__/${MSP_VERSION}/g _config.yml
-	PYTHONPATH=${PYPATH} ./build.sh
+all:
+	./build.sh
 
 clean:
 	rm -fR _build

docs/_config.yml

@@ -42,7 +42,7 @@ sphinx:
         navigation_with_keys: false
         pygments_dark_style: monokai
         logo:
-          text: "Version __MSPRIME_VERSION__"
+          text: "Version __PKG_VERSION__"
       myst_enable_extensions:
       - colon_fence
       - deflist

docs/build.sh

@@ -6,7 +6,7 @@
 
 REPORTDIR=_build/html/reports
 
-jupyter-book build -nW --keep-going .
+uv run --project=.. --only-group docs jupyter-book build . -vnW --keep-going
 RETVAL=$?
 if [ $RETVAL -ne 0 ]; then
     if [ -e $REPORTDIR ]; then