publish.yml

# Publish the site to GitHub Pages on `main`, delegated to Morrison-Lab/gha's
# reusable Quarto publish workflow. The deploy preserves the pr-preview/
# subtree on gh-pages, so open PRs' previews survive a publish.
name: Quarto Publish

on:
  push:
    branches: [main]
  workflow_dispatch:

# Serialize deploys so two pushes don't race on the gh-pages branch.
concurrency:
  group: gh-pages
  cancel-in-progress: false

jobs:
  publish:
    permissions:
      # Push the rendered site to gh-pages.
      contents: write
    uses: Morrison-Lab/gha/.github/workflows/quarto-publish.yml@v2
    with:
      # macros-table.qmd and demo-include-in-header.qmd execute R chunks, and
      # this repo is neither an renv project nor an R package, so the packages
      # are named directly rather than resolved from a lockfile or DESCRIPTION.
      setup-r: true
      r-packages: |
        any::knitr
        any::rmarkdown
        any::DT
      # Required, despite _quarto.yml declaring only `format: html`:
      # demo-shortcode.qmd and demo-include-in-header.qmd each override that
      # with their own `pdf:` front matter, and the whole point of those pages
      # is to show the macros reaching the LaTeX preamble. Without TinyTeX the
      # render fails on them.
      tinytex: true

  report-failure:
    needs: publish
    if: always() && needs.publish.result == 'failure'
    permissions:
      issues: write
    uses: Morrison-Lab/gha/.github/workflows/report-failure.yml@v2
    with:
      title: Quarto Publish workflow is failing
      body: The macros site did not deploy, so the published macro reference may be stale.