Merge pull request #292 from stan-dev/reformat-packagedown-workflow #24

	# Workflow derived from https://github.com/r-lib/actions/tree/v2/examples
	# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help
	on:
	# build dev site on merged pushes
	push:
	branches: [main, master]
	# build full site on releases
	release:
	types: [published]
	workflow_dispatch:

	name: pkgdown.yaml

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

	jobs:
	pkgdown:
	runs-on: ubuntu-latest
	env:
	GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
	permissions:
	contents: write
	steps:
	- uses: actions/checkout@v4

	- uses: r-lib/actions/setup-pandoc@v2

	- uses: r-lib/actions/setup-r@v2
	with:
	use-public-rspm: true

	- uses: r-lib/actions/setup-r-dependencies@v2
	with:
	extra-packages: any::pkgdown, local::., any::withr, stan-dev/pkgdown-config

	# - uses: actions/cache@v4
	# with:
	# path: vignettes/**/_cache
	# key: knitr-${{ runner.os }}-${{ hashFiles('vignettes/*/.Rmd') }}

	- name: Build site
	run: \|
	withr::with_envvar(
	c("NOT_CRAN" = "true"), # this should already be set by setup-r@v2? keeping because vignettes don't build otherwise
	pkgdown::build_site_github_pages(
	lazy = FALSE, # change to TRUE if runner times out.
	run_dont_run = TRUE,
	new_process = TRUE
	)
	)
	shell: Rscript {0}

	- name: Deploy to GitHub pages 🚀
	uses: JamesIves/[email protected]
	with:
	clean: false
	branch: gh-pages
	folder: docs

Provide feedback