docs: add site preview via Netlify

.github/workflows/ci.yaml

@@ -105,17 +105,3 @@ jobs:
           cache: 'pip'
       - run: make deps
       - run: make build
-
-  docs:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: 3.x
-          check-latest: true
-          cache: 'pip'
-      - uses: quarto-dev/quarto-actions/setup@v2
-      - run: make deps
-      - run: make dev
-      - run: make docs

.github/workflows/site.yaml

@@ -0,0 +1,30 @@
+name: Site
+on:
+  - pull_request
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+          check-latest: true
+          cache: 'pip'
+      - uses: quarto-dev/quarto-actions/setup@v2
+      - run: make deps
+      - run: make dev
+      - run: make docs
+      - uses: actions/setup-node@v4
+      - id: netlify
+        env:
+            NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+        run: |
+          preview_url=$(make --silent -C ./docs netlify | tail -n 1 | tr -d '"')
+          echo "# 🚀 Site Preview" >> $GITHUB_STEP_SUMMARY
+          echo "$preview_url" >> $GITHUB_STEP_SUMMARY

docs/Makefile

@@ -1,33 +1,48 @@
 .DEFAULT_GOAL := all
 
 # Command aliases
-QUARTO=quarto
-QUARTODOC=quartodoc
+PIP ?= pip3
+QUARTO ?= quarto
+QUARTODOC ?= quartodoc
 
 # Environment variables
-CURRENT_YEAR := $(shell date +%Y)
-VERSION := $(shell make -C ../ version)
-export CURRENT_YEAR VERSION
+NETLIFY_SITE_ID ?= 5cea1f56-7935-4387-975a-18a7905d15ee
+CURRENT_YEAR ?= $(shell date +%Y)
+VERSION ?= $(shell make --silent -C ../ version | tail -n 1)
 
-.PHONY: clean build deps preview
+.PHONY: all \
+		api \
+		build \
+		clean \
+		deps \
+		preview
 
 all: deps api build
 
-api: deps
+api:
 	$(QUARTODOC) build
 	$(QUARTODOC) interlinks
 	cp -r _extensions/ reference/_extensions	# Required to render footer
 
-build: api
+build:
+	CURRENT_YEAR=$(CURRENT_YEAR) \
+	VERSION=$(VERSION) \
 	$(QUARTO) render
 
 clean:
 	rm -rf _extensions _inv _site .quarto reference objects.json
 	find . -type d -empty -delete
 
 deps:
+	$(PIP) install --upgrade pip -r requirements-site.txt
 	$(QUARTO) add --no-prompt posit-dev/[email protected]
 	$(QUARTO) add --no-prompt machow/quartodoc
 
-preview: api
+preview:
+	CURRENT_YEAR=$(CURRENT_YEAR) \
+	VERSION=$(VERSION) \
 	$(QUARTO) preview
+
+
+netlify:
+	NETLIFY_SITE_ID=$(NETLIFY_SITE_ID) npx -y netlify-cli deploy --dir _site --json | jq '.deploy_url'

docs/_quarto.yml

@@ -1,6 +1,9 @@
 project:
   type: website
 
+execute:
+  freeze: auto
+
 website:
   title: "Posit SDK <small>{{< env VERSION >}}</small>"
   bread-crumbs: true

docs/requirements-site.txt

@@ -0,0 +1 @@
+quartodoc

requirements-dev.txt

@@ -5,7 +5,6 @@ pandas
 pre-commit
 pyjson5
 pytest
-quartodoc
 rsconnect
 responses
 ruff