class: center, middle, inverse, title-slide # Introduction to Quarto, the next generation of R Markdown ### <span style="color:#06c280">Dr. Priyanga D. Talagala</span> ### <span style="color:#06c280">Research Lounge Meet, University of Moratuwa</span> ### <span style="color:#06c280">18/10/2022</span> </br></br><img src="fig/quarto.jpeg" width="533" /> --- <img src="fig/quartointro.png" width="100%" style="display: block; margin: auto;" /> <!-- https://www.rstudio.com/blog/announcing-quarto-a-new-scientific-and-technical-publishing-system/ ecently released version 1.0, our first stable release After a soft launch of several months, Quarto was a major theme of this year’s RStudio Conference in late July. --> --- ## Quarto <img src="fig/quarto.jpeg" width="40%" style="display: block; margin: auto;" /> - Quarto is open source. -- - It’s not a language-specific library, but an external software application. -- - Use Quarto with R, Python, Julia, Javascript, and many other languages to create dynamic content --- ## Why bother with Quarto? - Quarto is RStudio’s attempt to bring R Markdown to everyone! -- - Unlike R Markdown, Quarto doesn’t require or depend on R. -- - The goal of Quarto is to make the process of creating and collaborating on scientific and technical documents dramatically better. -- - If you use more than one language, or you are on a multi-language team, you will likely find Quarto’s native support for multiple languages appealing. --- <!-- Quarto made it much easier for Python and R users to work together--> ## Why bother with Quarto? - Quarto combines the functionality of R Markdown, bookdown, distill, xaringan, etc. into a single consistent system with “batteries included” that reflects everything we’ve learned from R Markdown -- - You can export Quarto documents in more than 40 different file formats including Word, OpenOffice, PowerPoint, ePub, Jira Wiki, Jupyter, Observable JS, complete websites, and ebooks. R Markdown can generate some of those, but not all. -- - Quarto was designed to be multilingual, beginning with R, Python, Javascript, and Julia, with the idea that it will work even for languages that don’t yet exist. --- # Getting started with Quarto ### Step 1: Install Quarto - Because Quarto isn’t a language-specific library, you install it like any other stand-alone software. - You can find binary downloads for Windows, macOS, and Linux on Quarto’s [“Get Started” page](https://quarto.org/docs/get-started/) . - If you’re an R user and you have an up-to-date version of RStudio, Quarto should be included by default. You don’t need to install Quarto separately. --- # How to use RStudio with Quarto - If you know R Markdown, a Quarto document will look familiar. - You’ll edit code and markdown in RStudio just as you would with R Markdown, and preview the rendered document in the Viewer tab as you work. --- # Create a Quarto document file File > New File > Quarto Document <img src="fig/quartocmd1.png" width="50%" style="display: block; margin: auto;" /> --- # Create a Quarto document file .pull-left[ <img src="fig/quartocmd2.png" width="100%" style="display: block; margin: auto;" /> ].pull-right[ <img src="fig/quartocmd2b.png" width="100%" style="display: block; margin: auto;" /> ] --- One of the biggest differences between R Markdown and Quarto is how you set up options for code chunks. .pull-left[ ## R Markdown - Chunk-specific options are typically put within curly braces <img src="fig/code1.png" width="100%" style="display: block; margin: auto;" /> ].pull-right[ ## Quarto - Chunk options start off with #| (“hash pipe”) and go below the curly braces for R, Python, or Julia. <img src="fig/code2.png" width="100%" style="display: block; margin: auto;" /> ] --- # Render the document <img src="fig/quartocmd3.png" width="50%" style="display: block; margin: auto;" /> --- # For more details on using Quarto - [Welcome to Quarto](https://quarto.org/) - [Tutorial: Hello, Quarto](https://quarto.org/docs/get-started/hello/rstudio.html) - [How to create Word docs from R or Python with Quarto](https://www.infoworld.com/article/3671668/how-to-create-word-docs-from-r-or-python-with-quarto.html) - [What is Quarto? RStudio rolls out next-generation R Markdown](https://www.infoworld.com/article/3666743/what-is-quarto-rstudio-quietly-rolls-out-next-generation-r-markdown.html) --- class: inverse, middle, center <i class="fab fa-github "></i><i class="fab fa-twitter "></i> pridiltal and thiyangt # Acknowledgements: This work was supported in part by RETINA research lab funded by the OWSD, a program unit of United Nations Educational, Scientific and Cultural Organization (UNESCO). All rights reserved by Thiyanga S. Talagala and Priyanga D Talagala <!-- https://yihui.org/en/2022/04/quarto-r-markdown/ https://www.infoworld.com/article/3666743/what-is-quarto-rstudio-quietly-rolls-out-next-generation-r-markdown.html https://www.infoworld.com/article/3671668/how-to-create-word-docs-from-r-or-python-with-quarto.html -->