build: 🔨 add doc preview action to build (#261)

# Description

Same change as in the other repos a while ago.

Needs a quick review.

## Checklist

- [x] Ran `just run-all`

Co-authored-by: Luke W. Johnston <lwjohnst86@users.noreply.github.com>

Author: joelostblom

justfile

@@ -60,16 +60,23 @@ format-python:
   uv run ruff check --fix .
   uv run ruff format .
 
-# Build the documentation website using Quarto
-build-website:
+# Build the Python docstrings as a section in the website using quartodoc
+build-quartodoc:
   # To let Quarto know where python is.
   export QUARTO_PYTHON=.venv/bin/python3
   # Delete any previously built files from quartodoc.
   # -f is to not give an error if the files don't exist yet.
   rm -rf docs/reference
   uv run quartodoc build
+
+# Build the documentation website using Quarto
+build-website:  build-quartodoc
   uv run quarto render --execute
 
+# Preview the documentation website with automatic reload on changes
+preview-website: build-quartodoc
+  uv run quarto preview --execute
+
 # Check the commit messages on the current branch that are not on the main branch
 check-commits:
   #!/usr/bin/env bash