Quarto#
Quarto is an open-source scientific and technical publishing system built on Pandoc.
Content authored using Quarto can be published to Posit Connect. Quarto must be installed on your system and configured in Posit Connect prior to its use. Contact your Posit Connect administrator if Quarto support is not available. Information about setting up Quarto in Posit Connect is available in the Quarto chapter of the Admin Guide
For information about authoring Quarto content, see the Quarto Guide.
Publishing Quarto Content#
There are multiple ways to publish Quarto content to Posit Connect. See the linked documentation for each method for more on how to use it to publish Quarto content.
| Tool | Method | Supported Runtimes |
|---|---|---|
| RStudio IDE | Push-button publishing | knitr, jupyter |
The quarto CLI |
quarto publish connect |
knitr, jupyter |
The quarto R package |
quarto_publish_[site|app|doc]() |
knitr, jupyter |
The rsconnect R package |
deployApp(quarto = QUARTO_PATH),writeManifest(quarto = QUARTO_PATH) |
knitr, jupyter |
The rsconnect-python CLI |
rsconnect deploy quarto,rsconnect write-manifest quarto |
jupyter |
The rsconnect-python CLI |
rsconnect deploy manifest |
knitr, jupyter |
Note
If your Quarto content contains R code, you cannot use the
rsconnect-python CLI's rsconnect deploy quarto function. You can still
use rsconnect deploy manifest to deploy content for which a
manifest has already been
generated.
Quarto Feature Support#
Quarto content supports executable code in multiple languages, and supports interactivity through a number of technologies.
Posit Connect supports most of Quarto's capabilities, including:
- Rendering R, Python, and Observable JS code.
- Running interactives written with
Shiny,
ObservableJS, and
R
htmlwidgets. - Rendering Quarto projects, documents, websites, and books.
Posit Connect doesn't support the following Quarto capabilities:
- Rendering Julia code chunks.
- Running interactives written with Jupyter Widgets.
Quarto Project Profiles#
Quarto project profiles let your content adapt to different scenarios. For example:
- Your development data sources may be different from the ones available in your deployed environment.
- You may want to produce different versions from the same source code (e.g. including additional diagnostic information during development).
Note
Quarto v1.2 adds support for project profiles. Older versions of Quarto
will not automatically receive a value for QUARTO_PROFILE.
Posit Connect configures the QUARTO_PROFILE environment variable when
running Quarto content, which informs Quarto which profile is in use. By
default, the value "connect" is used; your Connect installation may override
this default.
Add QUARTO_PROFILE as a custom environment
variable for your content if you need to
use a different profile from the server default.
Note
Some installations may not allow overriding QUARTO_PROFILE; attempts to
set a value for QUARTO_PROFILE will fail when this is the case.