Merge remote-tracking branch 'origin/main' into maurice_paper_2_main #96

	name: Test Sphinx Docs (Non-Main Branches)

	on:
	push:
	branches-ignore: # Run on all branches except 'main'
	- main
	workflow_dispatch:

	env:
	DEFAULT_BRANCH: "main"

	jobs:
	build-docs:
	name: Build Sphinx Documentation
	runs-on: ubuntu-latest
	steps:
	# Check out the repository
	- uses: actions/checkout@v4
	with:
	fetch-depth: 0
	lfs: true

	# Set up Python
	- name: "Set up Python"
	uses: actions/setup-python@v5
	with:
	python-version-file: "pyproject.toml"

	# Install Pandoc and xelatex engine
	- name: Install Pandoc and xelatex
	run: \|
	sudo apt-get update
	sudo apt-get install -y pandoc texlive-xetex texlive-fonts-recommended texlive-fonts-extra texlive-latex-extra librsvg2-bin

	- name: Set up uv
	# Install latest uv version using the installer
	run: curl -LsSf https://astral.sh/uv/install.sh \| sh

	# Install project dependencies (including Sphinx and docs dependencies)
	- name: Install the project
	run: \|
	uv sync --extra docs

	# Debugging information
	- name: Debugging information
	run: \|
	echo "github.ref: ${{ github.ref }}"
	echo "github.event_name: ${{ github.event_name }}"
	echo "github.head_ref: ${{ github.head_ref }}"
	echo "github.base_ref: ${{ github.base_ref }}"
	set -x
	git rev-parse --abbrev-ref HEAD
	git branch
	git branch -a
	git remote -v
	python -V
	pip list

	# Build Sphinx documentation
	- name: Build Sphinx docs
	run: \|
	cd docs
	mkdir -p _build
	uv run make html

	# Upload the build logs as an artifact if the build fails
	- uses: actions/upload-artifact@v4
	if: failure()
	with:
	name: build_logs
	path: /tmp/sphinx-err-*.log

Provide feedback