Create a Quarto SCSS file — write

This function creates the .scss file so that any Quarto project can easily be customized with SCSS styling variables, mixins, and rules. It also updates the Quarto YAML configuration to include the new style sheet.

Usage

write_scss(name = "custom", path = getwd())

Arguments

name: The name of the scss file without extension. Default name is "custom".
path: The path to the main project level. Defaults to the current working directory

Value

A .scss file to customize Quarto styling. If the file is not named "custom.scss", the function will also attempt to update the Quarto YAML configuration.

Details

For more information on customizing Quarto documents with SCSS, please refer to:
* https://quarto.org/docs/output-formats/html-themes.html#customizing-themes
* https://quarto.org/docs/output-formats/html-themes-more.html
* https://github.com/twbs/bootstrap/blob/main/scss/_variables.scss

Examples

if (FALSE) { # \dontrun{
# Create a new temporary directory for the example
temp_dir <- tempdir()

# Create default custom.scss
write_scss(name = "custom", path = temp_dir)

# Add another style sheet
write_scss(name = "special_theme", path = temp_dir)
} # }