Begin migration to "new arviz" #1169

	name: Build and publish documentation

	on:
	push:
	branches:
	- main
	pull_request:
	types:
	- opened
	- reopened
	- synchronize

	jobs:
	build-docs:
	if: github.repository == 'bambinos/bambi'
	runs-on: ubuntu-latest
	strategy:
	fail-fast: false
	steps:
	- name: Checkout source
	uses: actions/checkout@v5
	with:
	fetch-depth: 0

	- name: Set up Quarto
	uses: quarto-dev/quarto-actions/setup@v2
	with:
	version: 1.7.32 # since this is my local version, we could change it

	- uses: prefix-dev/[email protected]
	with:
	pixi-version: v0.48.0
	environments: "dev"

	- name: Build documentation
	shell: bash
	# I have to 'cd' because interlinks does not allow to pass a different path
	run: \|
	cd docs
	pixi run -e dev python -m quartodoc build
	pixi run -e dev python -m quartodoc interlinks
	quarto render
	touch _site/.nojekyll

	- name: Publish documentation to GitHub
	if: github.ref == 'refs/heads/main' \|\| startsWith(github.ref, 'refs/tags')
	uses: quarto-dev/quarto-actions/publish@v2
	with:
	target: gh-pages
	render: false
	path: docs/_site
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}


	# NOTES
	# 1. The job runs only in the bambinos/bambi repository. It does not make sense to do it elsewhere.
	# 2. The rendered webpage is published ONLY when the job was triggered by:
	# - A commit to main
	# - A tagged release

Provide feedback