Quarto vignettes (#6241)

* use quarto vignettes

* add quarto as vignette builder/suggests

* ignore render output files

* add html format

* move knitr chunk options to yaml

* force install self on old windows

Author: teunbrand

.github/workflows/R-CMD-check.yaml

@@ -69,6 +69,7 @@ jobs:
             [email protected],
             Hmisc=?ignore-before-r=4.2.0,
             quantreg=?ignore-before-r=4.3.0
+            local::.
           needs: check
 
       - uses: r-lib/actions/setup-r-dependencies@v2

DESCRIPTION

@@ -63,9 +63,9 @@ Suggests:
     nlme,
     profvis,
     quantreg,
+    quarto,
     ragg (>= 1.2.6),
     RColorBrewer,
-    rmarkdown,
     roxygen2,
     rpart,
     sf (>= 0.7-3),
@@ -76,8 +76,8 @@ Suggests:
     xml2
 Enhances:
     sp
-VignetteBuilder:
-    knitr
+VignetteBuilder: 
+    quarto
 Config/Needs/website: ggtext, tidyr, forcats, tidyverse/tidytemplate
 Config/testthat/edition: 3
 Config/usethis/last-upkeep: 2025-04-23

vignettes/.gitignore

@@ -1,2 +1,5 @@
 *.html
 *.R
+**/figure-html/
+**/libs/
+/.quarto/

vignettes/articles/faq-annotation.Rmd renamed to vignettes/articles/faq-annotation.qmd

@@ -1,5 +1,14 @@
 ---
 title: "FAQ: Annotation"
+format: html
+knitr:
+  opts_chunk:
+    collapse: true
+    comment: "#>"
+    fig-dpi: 300
+    fig-asp: 0.618
+    fig-width: 6
+    out-width: "80%"
 ---
 
 ```{=html}
@@ -17,14 +26,6 @@ title: "FAQ: Annotation"
 #| include: false
 library(ggplot2)
 library(dplyr)
-knitr::opts_chunk$set(
-  fig.dpi = 300, 
-  collapse = TRUE, 
-  comment = "#>",
-  fig.asp = 0.618,
-  fig.width = 6,
-  out.width = "80%"
-  )
 ```
 
 

vignettes/articles/faq-axes.Rmd renamed to vignettes/articles/faq-axes.qmd

@@ -1,5 +1,14 @@
 ---
 title: "FAQ: Axes"
+format: html
+knitr:
+  opts_chunk:
+    collapse: true
+    comment: "#>"
+    fig-dpi: 300
+    fig-asp: 0.618
+    fig-width: 6
+    out-width: "80%"
 ---
 
 ```{=html}
@@ -16,13 +25,6 @@ title: "FAQ: Axes"
 ```{r}
 #| include: false
 library(ggplot2)
-knitr::opts_chunk$set(
-  fig.dpi = 300, 
-  collapse = TRUE, 
-  comment = "#>",
-  fig.asp = 0.618,
-  fig.width = 6,
-  out.width = "80%")
 ```
 
 ## Label placement

vignettes/articles/faq-bars.Rmd renamed to vignettes/articles/faq-bars.qmd

@@ -1,5 +1,14 @@
 ---
 title: "FAQ: Barplots"
+format: html
+knitr:
+  opts_chunk:
+    collapse: true
+    comment: "#>"
+    fig-dpi: 300
+    fig-asp: 0.618
+    fig-width: 6
+    out-width: "80%"
 ---
 
 ```{=html}
@@ -18,15 +27,6 @@ title: "FAQ: Barplots"
 library(ggplot2)
 library(dplyr)
 library(tidyr)
-
-knitr::opts_chunk$set(
-  fig.dpi = 300, 
-  collapse = TRUE, 
-  comment = "#>",
-  fig.asp = 0.618,
-  fig.width = 6,
-  out.width = "80%"
-  )
 ```
 
 ## Colors

vignettes/articles/faq-customising.Rmd renamed to vignettes/articles/faq-customising.qmd

@@ -1,5 +1,14 @@
 ---
 title: "FAQ: Customising"
+format: html
+knitr:
+  opts_chunk:
+    collapse: true
+    comment: "#>"
+    fig-dpi: 300
+    fig-asp: 0.618
+    fig-width: 6
+    out-width: "80%"
 ---
 
 ```{=html}
@@ -17,14 +26,6 @@ title: "FAQ: Customising"
 #| include: false
 library(ggplot2)
 library(tibble)
-knitr::opts_chunk$set(
-  fig.dpi = 300, 
-  collapse = TRUE, 
-  comment = "#>",
-  fig.asp = 0.618,
-  fig.width = 6,
-  out.width = "80%"
-  )
 ```
 
 ## Legends

vignettes/articles/faq-faceting.Rmd renamed to vignettes/articles/faq-faceting.qmd

@@ -1,5 +1,14 @@
 ---
 title: "FAQ: Faceting"
+format: html
+knitr:
+  opts_chunk:
+    collapse: true
+    comment: "#>"
+    fig-dpi: 300
+    fig-asp: 0.618
+    fig-width: 6
+    out-width: "80%"
 ---
 
 ```{=html}
@@ -16,13 +25,6 @@ title: "FAQ: Faceting"
 ```{r}
 #| include: false
 library(ggplot2)
-knitr::opts_chunk$set(
-  fig.dpi = 300, 
-  collapse = TRUE, 
-  comment = "#>",
-  fig.asp = 0.618,
-  fig.width = 6,
-  out.width = "80%")
 ```
 
 ## Panes

vignettes/articles/faq-reordering.Rmd renamed to vignettes/articles/faq-reordering.qmd

@@ -1,5 +1,14 @@
 ---
 title: "FAQ: Reordering"
+format: html
+knitr:
+  opts_chunk:
+    collapse: true
+    comment: "#>"
+    fig-dpi: 300
+    fig-asp: 0.618
+    fig-width: 6
+    out-width: "80%"
 ---
 
 ```{=html}
@@ -18,15 +27,6 @@ title: "FAQ: Reordering"
 library(ggplot2)
 library(dplyr)
 library(tibble)
-
-knitr::opts_chunk$set(
-  fig.dpi = 300, 
-  collapse = TRUE, 
-  comment = "#>",
-  fig.asp = 0.618,
-  fig.width = 6,
-  out.width = "80%"
-  )
 ```
 
 ## Bar plots

vignettes/extending-ggplot2.Rmd renamed to vignettes/extending-ggplot2.qmd

@@ -1,17 +1,22 @@
 ---
 title: "Extending ggplot2"
-output: rmarkdown::html_vignette
+knitr:
+  opts_chunk:
+    collapse: false
+    comment: "#>"
+    fig-width: 7
+    fig-height: 7
+    fig-align: "center"
 description: |
   Official extension mechanism provided in ggplot2.
 vignette: >
   %\VignetteIndexEntry{Extending ggplot2}
-  %\VignetteEngine{knitr::rmarkdown}
+  %\VignetteEngine{quarto::html}
   %\VignetteEncoding{UTF-8}
 ---
 
 ```{r}
 #| include: false
-knitr::opts_chunk$set(collapse = TRUE, comment = "#>", fig.width = 7, fig.height = 7, fig.align = "center")
 library(ggplot2)
 ```