diff --git a/docs/faq/index.qmd b/docs/faq/index.qmd index bd1df44552..24af58a7e2 100644 --- a/docs/faq/index.qmd +++ b/docs/faq/index.qmd @@ -1,9 +1,12 @@ --- title: "Frequently Asked Questions" +editor: source --- If you are an R Markdown user wondering about the relationship between Quarto and R Markdown, see also our [FAQ for R Markdown Users](rmarkdown.qmd). +## General + ### What can I use Quarto for? Quarto® is an open-source scientific and technical publishing system built on Pandoc. You can weave together narrative text and code to produce elegantly formatted output as documents, web pages, blog posts, books and more. @@ -12,13 +15,9 @@ Quarto® is an open-source scientific and technical publishing system built on P Visit the [Quarto.org - Get Started page](/docs/get-started/index.qmd), which provides installation instructions for Windows, Mac OS, and Linux. -### Is Quarto free to use? - -Yes! Quarto is [open source](/license.md). Quarto version 1.3 (and earlier) is licensed under the [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html). Quarto version 1.4 is licensed under the [MIT License](https://opensource.org/license/mit/). - ### What output formats can Quarto create? -There are many output formats available in Quarto. This includes all of the built in Pandoc formats (e.g. HTML, PDF, MS Word, Revealjs, ePub, etc.) as well as various ways to publish multiple documents (websites, blogs, and books). Learn more at [Quarto Formats](/docs/output-formats/all-formats.qmd).  +There are many output formats available in Quarto. This includes all of the built in Pandoc formats (e.g. HTML, PDF, MS Word, Revealjs, ePub, etc.) as well as various ways to publish multiple documents (websites, blogs, and books). Learn more at [Quarto Formats](/docs/output-formats/all-formats.qmd). ### What editing tools can I use with Quarto? @@ -38,6 +37,45 @@ Each Quarto document can be optionally processed by a computational engine (the You can write your Quarto documentation in your human language of choice. The [lang](https://pandoc.org/MANUAL.html#language-variables) [document option](/docs/authoring/language.qmd#lang-option) is used to identify the main language of the document using IETF language tags (following the [BCP 47 standard](https://tools.ietf.org/html/bcp47)), such as en or en-GB.  +### Where can I report bugs or request features? + +Thanks for finding something and sharing with us! You can file an issue in the Quarto repository . + +### Where can I ask questions and discuss using Quarto with others? + +The best place to ask questions and see what questions other people have is in Quarto discussions ().  + +## Development and Maintenance + +### How can I upgrade dependencies? + +Generally, you cannot. +Quarto produces output tailored to its downstream dependencies (Pandoc, `typst`, etc), and uses features that depend on specific upstream dependencies (Deno). +Our installers bundle all required dependencies to eliminate version mismatch risks, and we *strongly recommend* that third-party packagers +follow the same policy. + +### How often are dependencies updated? + +Ideally, we update dependencies exactly once every stable release (1.2, 1.3, etc). +We reserve to right to change the cadence as necessary for our development. + +### What are Quarto's dependencies? + +Quarto's dependencies include: + +- [Pandoc](https://pandoc.org) +- [Typst](https://typst.app) +- [Deno](https://deno.com) +- [Mermaid](https://mermaid.js.org) +- [esbuild](https://esbuild.github.io/) +- [Dart Sass](https://sass-lang.com/dart-sass/) + +## Licensing + +### Is Quarto free to use? + +Yes! Quarto is [open source](/license.md). Quarto version 1.3 (and earlier) is licensed under the [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html). Quarto version 1.4 is licensed under the [MIT License](https://opensource.org/license/mit/). + ### Can I use Quarto to develop proprietary content? Yes! The copyright on Quarto does not cover the original content that you generate using Quarto. Using Quarto to create original content does not place any restrictions, legally, on the license that you choose for the original content that you create, nor does it “reach through” to affect software that you might be writing documentation for with Quarto. @@ -62,20 +100,26 @@ There are a wide variety of ways to publish Quarto websites. Website content is The [publishing documentation](/docs/publishing/other.qmd) describes several convenient options for Quarto website deployment including Posit Connect, Netlify, GitHub Pages, Firebase, Site44, and Amazon S3. We'll mostly defer to the documentation provided by those various services, but will note any Quarto website specific configuration required. +## Quarto + Posit + ### Does Posit Connect support Quarto? Yes! You can publish Quarto content to Posit Connect v2021.08.0 or later. Quarto has to be enabled as documented in the Posit Connect [admin guide](https://docs.rstudio.com/connect/admin/appendix/configuration/#Quarto). Connect's user [documentation](https://docs.rstudio.com/connect/user/quarto/) refers to [Quarto.org docs](/docs/publishing/index.qmd#rstudio-connect) on how to publish from the RStudio IDE. To publish Python-based Quarto content, you can use the [rsconnect-python CLI](https://docs.rstudio.com/rsconnect-python/) from various locations, including VSCode, JupyterLab or the terminal. +## Meta + ### Who are the developers of Quarto? Development of Quarto is sponsored by [Posit, PBC](https://www.posit.co/). The same core team works on both Quarto and R Markdown: - Carlos Scheidegger ([\@cscheid](https://github.com/cscheid)) -- Charles Teague ([\@dragonstyle](https://github.com/dragonstyle)) +- Gordon Woodhull ([\@gordonwoodhull](https://github.com/gordonwoodhull)) - Christophe Dervieux ([\@cderv](https://github.com/cderv)) +- Charles Teague ([\@dragonstyle](https://github.com/dragonstyle)) + - J.J. Allaire ([\@jjallaire](https://github.com/jjallaire/)) - Yihui Xie ([\@yihui](https://github.com/yihui)) @@ -85,11 +129,3 @@ Here is the [full contributors list](https://github.com/quarto-dev/quarto-cli/gr ### Why the name Quarto? We wanted to use a name that had meaning in the history of publishing and landed on Quarto, which is the format of a book or pamphlet produced from full sheets printed with eight pages of text, four to a side, then folded twice to produce four leaves. The earliest known European printed book is a Quarto, the [Sibyllenbuch](https://en.wikipedia.org/wiki/Sibyllenbuch_fragment), believed to have been printed by [Johannes Gutenberg](https://en.wikipedia.org/wiki/Johannes_Gutenberg) in 1452--53. - -### Where can I report bugs or request features? - -Thanks for finding something and sharing with us! You can file an issue in the Quarto repository . - -### Where can I ask questions and discuss using Quarto with others? - -The best place to ask questions and see what questions other people have is in Quarto discussions ().