ci: add PyPI trusted-publisher workflow #7

	name: Build and Deploy Documentation

	concurrency:
	group: "pages"
	cancel-in-progress: true

	on:
	push:
	branches: [main]
	tags: ["*"]
	pull_request:

	permissions:
	contents: read
	pages: write
	id-token: write

	jobs:
	build_docs:
	name: Build documentation
	runs-on: ubuntu-latest
	steps:
	- name: Checkout repository
	uses: actions/checkout@v4
	with:
	fetch-depth: 0

	- uses: prefix-dev/setup-pixi@v0.8.10
	with:
	cache: true
	cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}
	environments: >-
	docs

	- name: Install Python dependencies
	run: pixi run sync

	- name: Build docs
	run: pixi run -e docs docbld

	- name: Upload artifact
	uses: actions/upload-artifact@v4
	with:
	name: documentation
	path: docs/build/html

	- name: Upload pages artifact
	if: github.event_name == 'push'
	uses: actions/upload-pages-artifact@v3
	with:
	path: docs/build/html

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

Navigation Menu