Repository navigation

[FEAT] Add the OVIDE MOC-intensity reader, plus a y-axis label-wrap helper #227

	name: Test documentation build

	on:
	pull_request:
	paths:
	- '**.py'
	- '**.ipynb'
	- '**.rst'
	- '**.md'

	jobs:
	build-docs:
	runs-on: ubuntu-latest
	permissions:
	contents: read

	steps:
	- name: Checkout
	uses: actions/checkout@v7
	with:
	fetch-depth: 0

	- name: Setup Micromamba
	uses: mamba-org/setup-micromamba@v3
	with:
	environment-file: environment.yml
	init-shell: bash
	condarc: \|
	channels:
	- conda-forge
	channel_priority: strict
	cache-environment: true

	- name: Install package (editable)
	shell: bash -l {0}
	run: \|
	micromamba run -n amocatlas python -m pip install --upgrade pip
	micromamba run -n amocatlas python -m pip install -e . --no-deps --force-reinstall

	- name: Build documentation
	shell: bash -l {0}
	run: \|
	set -e
	# Copy notebooks without executing. They read live data from remote array
	# servers, which is unavailable/flaky in CI. Execute locally and commit the
	# outputs to render them (nbsphinx_execute is "never"; see docs/source/conf.py).
	cp notebooks/demo.ipynb docs/source/demo-output.ipynb
	cp notebooks/amoc_paperfigs.ipynb docs/source/amoc_paperfigs-output.ipynb
	pushd docs
	micromamba run -n amocatlas make clean html
	popd