quarto_update_extension: Update a Quarto extensions

View source: R/update.R

quarto_update_extensionR Documentation

Update a Quarto extensions

Description

Update an extension to this folder or project by running ⁠quarto update⁠

Usage

quarto_update_extension(
  extension = NULL,
  no_prompt = FALSE,
  quiet = FALSE,
  quarto_args = NULL
)

Arguments

extension

The extension to update, either by its name (i.e ⁠ quarto update extension <gh-org>/<gh-repo>⁠), an archive (⁠ quarto update extension <path-to-zip>⁠) or a url (⁠quarto update extension <url>⁠).

no_prompt

Do not prompt to confirm approval to download external extension. Setting no_prompt = FALSE means Extension Trust is accepted.

quiet

Suppress warning and other messages, from R and also Quarto CLI (i.e --quiet is passed as command line).

quarto.quiet R option or R_QUARTO_QUIET environment variable can be used to globally override a function call (This can be useful to debug tool that calls ⁠quarto_*⁠ functions directly).

On Github Actions, it will always be quiet = FALSE.

quarto_args

Character vector of other quarto CLI arguments to append to the Quarto command executed by this function. This is mainly intended for advanced usage and useful for CLI arguments which are not yet mirrored in a dedicated parameter of this R function. See ⁠quarto render --help⁠ for options.

Value

Returns invisibly TRUE if the extension was updated, FALSE otherwise.

Extension Trust

Quarto extensions may execute code when documents are rendered. Therefore, if you do not trust the author of an extension, we recommend that you do not install or use the extension. By default no_prompt = FALSE which means that the function will ask for explicit approval when used interactively, or disallow installation.

See Also

quarto_add_extension(), quarto_remove_extension(), and Quarto website.

Examples

## Not run: 
# Update a template and set up a draft document from a GitHub repository
quarto_update_extension("quarto-ext/fontawesome")

# Update a template and set up a draft document from a ZIP archive
quarto_update_extension("https://github.com/quarto-ext/fontawesome/archive/refs/heads/main.zip")

## End(Not run)

quarto-dev/quarto-r documentation built on June 14, 2025, 3:45 a.m.