How to change verbosity in pkgdown GitHub actions

[wiedenhoeft]

For my repository (https://github.com/HUGLeipzig/kitesquare), I have followed https://r-pkgs.org/website.html to set up pkgdown with GitHub Actions in order to build a website at https://hugleipzig.github.io/kitesquare/. Everything appears to be in order. Yet for some reason, pkgdown fails the building step (https://github.com/HUGLeipzig/kitesquare/actions/runs/12929841229/job/36060042956):

I can build the vignette locally with Quarto without problems. I am trying to figure out what is going wrong, and came across the suggestion in the log to

Rerun with quiet = FALSE to see the full error message.

Is it possible to pass quiet=FALSE from pkgdown::build_site_github_pages down to pkgdown:::build_quarto_articles somehow, or to change the verbosity level globally somehow?

[jayhesselberth]

Yeah, we don't pass quiet down from build_site() ... maybe we should.

Can you try simplifying your quarto header down to the minimum? wondering if something in your more complex header is causing the problem.

something like:

title: quarto vignettes
vignette: >
  %\VignetteIndexEntry{quarto vignettes}
  %\VignetteEngine{quarto::html}
  %\VignetteEncoding{UTF-8}

[wiedenhoeft]

Thanks for the quick reply. I've tried with

---
title: Kite-Square Plots for Contingency Tables
echo: false
include: false
warning: false
error: false
message: false
vignette: >
  %\VignetteIndexEntry{quarto vignettes}
  %\VignetteEngine{quarto::html}
  %\VignetteEncoding{UTF-8}
---

but I get the same problem.

[wiedenhoeft]

I also tried adding

quarto.quiet: false

to _pkgdown.yaml in order to emulate Quarto's

options(quarto.quiet = FALSE)

but to no effect.

[hadley]

It doesn't look like you install quarto in https://github.com/HUGLeipzig/kitesquare/blob/main/.github/workflows/pkgdown.yaml ?

[jayhesselberth]

Quarto (the CLI) is indeed installed by the setup-r-dependencies rule in the GHA log above.

I was able to get a test quarto vignette to build in another package only after including quarto (the R library) in the website config portion of DESCRIPTION:

Config/Needs/website: quarto

@hadley We probably need to document that this step needs to be done in order for quarto vignettes to build? pkgdown itself is not affected because quarto is in Suggests. Alternatively, we could add quarto to pkgdown Imports so that it is always available. Thoughts?

[hadley]

Now that I think about it, quarto is supposed to auto-install if you use any .qmd files. But it's always the first thing I check 😄

[jayhesselberth]

Actaully, quarto in Suggests can't be the solution because it's in the kitesqaure package. But the Config strategy worked for me. Filed a PR at HUGLeipzig/kitesquare#1

[wiedenhoeft]

Thanks! Unfortunately, the error persists :-(

[jayhesselberth]

I would try running quarto build directly in GHA with the followin, which should print the error.

pkgdown:::build_quarto_articles(quiet=FALSE)