Skip to contents

Create a quarto project

Source: R/create.R
quarto_create_project.Rd

This function calls quarto create project <type> <name>. It creates a new directory with the project name, inside the requested parent directory, and adds some starter files that are appropriate to the project type.

Usage

quarto_create_project(
  name,
  type = "default",
  dir = ".",
  no_prompt = FALSE,
  quiet = FALSE,
  quarto_args = NULL
)

Arguments

name

The name of the project and the directory that will be created.

type

The type of project to create. As of Quarto 1.4, it can be one of default, website, blog, book, manuscript, confluence.

dir

The directory in which to create the new Quarto project, i.e. the parent directory.

no_prompt

Do not prompt to approve the creation of the new project folder.

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.

Quarto version required

This function requires Quarto 1.4 or higher. Use quarto_version() to see your current Quarto version.

See also

Quarto documentation on Quarto projects

Examples

if (FALSE) { # \dontrun{
quarto_create_project("my-first-quarto-project", dir = "~/tmp")
} # }