ci: add docs site preview

.github/workflows/ci.yaml

@@ -50,17 +50,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/docs.yaml

@@ -0,0 +1,29 @@
+name: Documentation
+on:
+  - pull_request
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  default:
+    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
+      - uses: actions/setup-node@v4
+      - run: npm install -g netlify
+      - run: netlify help
+      - uses: quarto-dev/quarto-actions/publish@v2
+        with:
+          target: netlify
+          path: docs
+          render: false
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}

docs/Makefile

@@ -1,33 +1,43 @@
 .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
+CURRENT_YEAR ?= $(shell date +%Y)
+VERSION ?= $(shell make -C ../ version)
 
-.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

docs/_publish.yaml

@@ -0,0 +1,4 @@
+- source: project
+  netlify:
+    - id: "5cea1f56-7935-4387-975a-18a7905d15ee"
+      url: "https://posit-sdk-py.netlify.app"

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,2 @@
+
+quartodoc

requirements-dev.txt

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