Build documentation #19

	name: Build documentation

	on:
	push:
	tags:
	- "v[0-9]+.[0-9]+.[0-9]+"
	- "v[0-9]+.[0-9]+.[0-9]+a[0-9]+"
	- "v[0-9]+.[0-9]+.[0-9]+b[0-9]+"
	- "v[0-9]+.[0-9]+.[0-9]+rc[0-9]+"
	workflow_dispatch:
	inputs:
	target:
	description: "Site to build and deploy"
	type: choice
	options:
	- dev
	- main
	- dryrun
	required: true
	default: dryrun
	schedule:
	- cron: "0 17 * * SUN"


	# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
	permissions:
	contents: read
	pages: write
	id-token: write

	# Allow one concurrent deployment
	concurrency:
	group: "pages"
	cancel-in-progress: true

	# Default to bash
	defaults:
	run:
	shell: bash

	jobs:
	build:
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v4
	with:
	fetch-depth: 0
	- name: Set up Pixi
	uses: prefix-dev/setup-pixi@ba3bb36eb2066252b2363392b7739741bb777659 # v0.8.1
	with:
	environments: docs
	- name: Build documentation
	run: pixi run -e docs docs-build
	- uses: actions/upload-artifact@v4
	if: always()
	with:
	name: docs
	if-no-files-found: error
	path: builtdocs
	- name: Upload artifact
	uses: actions/upload-pages-artifact@v3
	with:
	path: ./builtdocs

	deploy:
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	runs-on: ubuntu-latest
	needs: build
	steps:
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v4

Provide feedback