about.qmd

title	subtitle
About Quarto	A scientific and technical publishing system built on Pandoc

## Goals The overarching goal of Quarto is to make the process of creating and collaborating on scientific and technical documents dramatically better. We hope to do this in several dimensions: - Create a writing and publishing environment with great integrated tools for technical content. We want to make authoring with embedded code, equations, figures, complex diagrams, interactive widgets, citations, cross references, and the myriad other special requirements of scientific discourse straightforward and productive for everyone. - Help authors take full advantage of the web as a connected, interactive platform for communications, while still providing the ability to create excellent printed output from the same document source. Researchers shouldn't need to choose between LaTeX, MS Word, and HTML but rather be able to author documents that target all of them at the same time. - Make reproducible research and publications the norm rather than the exception. Reproducibility requires that the code and data required to create a manuscript are an integrated part of it. However, this isn't often straightforward in practice---Quarto aims to make it easier to adopt a reproducible workflow than not. Quarto is open source software licensed under the [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html). We believe that it's better for everyone if the tools used for research and science are free and open. Reproducibility, widespread sharing of knowledge and techniques, and the leveling of the playing field by eliminating cost barriers are but a few of the shared benefits of free software in science. ## Project At the core of Quarto is [Pandoc](https://pandoc.org), a powerful and flexible document processing tool. Quarto adds a number of facilities to Pandoc aimed at scientific and technical publishing, including: 1. Embedding code and output from Python, R, and JavaScript via integration with [Jupyter](https://jupyter.org/), [Knitr](https://yihui.org/knitr/), and [Observable](https://github.com/observablehq/). 2. A variety of extensions to Pandoc markdown useful for technical writing including cross-references, sub-figures, layout panels, hoverable citations and footnotes, callouts, and more. 3. A project system for rendering groups of documents at once, sharing options across documents, and producing aggregate output like [websites](docs/websites/website-basics.qmd) and [books](docs/books/book-basics.qmd). Development of Quarto is sponsored by [RStudio](https://www.rstudio.com), where we previously created a similar system ([R Markdown](https://rmarkdown.rstudio.com/)) that shared the same goals, but was targeted principally at users of the R language. With Quarto, we are hoping to bring these tools to a much wider audience. ## Contribute You can contribute to Quarto in many ways: - By opening issues to provide feedback and share ideas. - By submitting Pull Request (PR) to fix opened issues - By submitting Pull Request (PR) to suggest new features (it is considered good practice to open an issue for discussion before working on a pull request for a new feature). Please be mindful of our [code of conduct](https://github.com/quarto-dev/quarto-cli/blob/main/.github/CODE_OF_CONDUCT.md) as you interact with other community members. ### Pull Requests {.unlisted} Pull requests are very welcome! Here's how to contribute via PR: 1. [Fork](https://github.com/quarto-dev/quarto-cli/fork) the repository, clone it locally, and make your changes in a new branch specific to the PR. For example: ``` bash # clone your fork $ git clone https://github.com/<username>/quarto-cli # configure for your platform (./configure-macos.sh, ./configure-linux.sh, or ./configure-windows.cmd) $ cd quarto-cli $ ./configure-macos.sh # checkout a new branch $ git checkout -b feature/newthing ``` 2. For significant changes (e.g more than small bug fixes), ensure that you have signed the [individual](https://rstudioblog.files.wordpress.com/2017/05/rstudio_individual_contributor_agreement.pdf) or [corporate](https://rstudioblog.files.wordpress.com/2017/05/rstudio_corporate_contributor_agreement.pdf) contributor agreement as appropriate. You can send the signed copy to [jj\@rstudio.com](mailto:[email protected]){.email}. 3. Submit the [pull request](https://help.github.com/articles/using-pull-requests). It is ok to submit as draft in your are still working on it but would like some feedback from us. It always good to share in the open that you are working on it. We'll try to be as responsive as possible in reviewing and accepting pull requests. ## Legal Quarto is open source software licensed under the [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html). Quarto also makes use of several other open-source projects, the distribution of which is subject to their respective licenses. Major components and their licenses include: | Project | License | |---------------------------------------------------------------|--------------------------------------------------------------------| | [Pandoc](https://pandoc.org/) | [GNU GPL v2](https://github.com/jgm/pandoc/blob/master/COPYING.md) | | [Bootstrap 5.0](https://getbootstrap.com/docs/5.0/) | [MIT](https://github.com/twbs/bootstrap/blob/v5.0.2/LICENSE) | | [Bootswatch 5.0](https://bootswatch.com/) | [MIT](https://github.com/thomaspark/bootswatch/blob/v5/LICENSE) | | [Deno](https://deno.land/) | [MIT](https://github.com/denoland/deno/blob/main/LICENSE.md) | | [esbuild](https://esbuild.github.io/) | [MIT](https://github.com/evanw/esbuild/blob/master/LICENSE.md) | | [Dart Saas](https://sass-lang.com/dart-sass) | [MIT](https://github.com/sass/dart-sass/blob/main/LICENSE) | | [Observable Runtime](https://github.com/observablehq/runtime) | [ISC](https://github.com/observablehq/runtime/blob/main/LICENSE) | Quarto is a registered trademark of RStudio, PBC.