Move docs to quarto for v1 #26

	name: Quarto documentation
	on:
	push:
	branches: [master]
	pull_request:

	concurrency:
	group: ${{ github.workflow }}-${{ github.ref }}
	cancel-in-progress: true

	# needed to allow julia-actions/cache to delete old caches that it has created
	permissions:
	actions: write
	contents: read

	jobs:
	publish:
	name: Build and publish docs
	runs-on: ubuntu-latest
	permissions:
	contents: write
	steps:
	- uses: actions/checkout@v4
	- uses: julia-actions/cache@v2
	with:
	cache-compiled: "true"
	cache-registries: "true"
	- uses: prefix-dev/[email protected]
	with:
	pixi-version: "latest"
	- name: Prepare pixi
	run: pixi run install-ci

	- name: Install Quarto
	uses: quarto-dev/quarto-actions/setup@v2

	- name: Check Quarto installation and all engines
	run: pixi run quarto-check

	- name: Render Quarto Project
	run: pixi run quarto-render

	- name: Publish Quarto Project as preview
	if: github.event_name == 'pull_request'
	uses: peaceiris/actions-gh-pages@v4
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./docs/_site
	destination_dir: previews/PR${{ github.event.number }}
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

	- name: Publish Quarto Project as dev
	if: github.event_name == 'push' && github.ref == 'refs/heads/master'
	uses: peaceiris/actions-gh-pages@v4
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./docs/_site
	destination_dir: dev
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Provide feedback