Today we begin a new series: “A Quarto tip a day keeps the docs away” -- a playful attempt to share Quarto tips daily for the next month. Follow along:
🐦
#quartotip
🔗
And, of course, don't keep the docs away, they're incredibly helpful and thorough!
The new Shinylive extension enables you to embed interactive Shiny for Python applets in Quarto documents (with no server required!). Shiny for R version is also in the works. Check out the details here:
Quarto offers a myriad of features, some of which are especially useful for academics! In this 20-minute video,
@minebocek
walks you through some of these features that she uses almost daily for writing papers and teaching
#rstats
.
Next Tuesday, Aug 9th @ 12 ET
@thomas_mock
is leading a virtual 2-hour Welcome to Quarto Workshop. All are welcome & no need to register for anything.
🔗 YouTube Live:
🗓 add to your calendar or share with a friend here:
Want to get started with or get the most out of Quarto? Join us
@rstudio
::conf(2022) July 25-29 in Washington, DC.
🔗 Register at
📖 Read about all things Quarto at conf at + 🧵 below
1/9
Quarto 1.3 is coming! We'll be blogging about some of the new features we are most excited about. First up: Code Annotation!
You don't have to wait for the official release to try it out. You can download the pre-release at
Been hearing about
#QuartoPub
but didn't give it a try yet? Perused the get started pages but would like another intro? Or want to pick up a few Quarto tips? Here is a Get Started with Quarto with
#rstats
and RStudio video for you!
#quartotip
5: Use the output-location chunk option to control where code output is shown:
- fragment: delayed
- slide: in the next slide
- column: in the next column
- column-fragment: delayed + in the next column
Read more:
Easily embed output from a Jupyter Notebook directly in a Quarto document with Jupyter Cell Embedding:
Our third blog post on new features coming in Quarto 1.3.
#quartotip
7: Use the chalkboard: true option for revealjs slides to annotate your slides by drawing on them or opening up an empty chalkboard within your presentation.
Read more:
#quartotip
20: YAML intelligence, including completion and diagnostics, make writing project files, YAML front matter, and executable cell options easy for experts and new learners. Available in
@rstudio
and
@code
!
Read more:
#quartotip
19: Want to see examples of what others are creating with Quarto? And how they're creating them? Browse the newly refreshed Quarto Gallery!
Read more:
---
Alt-text for GIF: Scrolling through the Quarto Gallery at .
#quartotip
9: If you want to create an entirely self-contained HTML document (with images, CSS, etc. embedded into the HTML file), set self-contained: true in the YAML of your document.
Read more:
@tracykteal
Talk: Literate Programming w/ Jupyter Notebooks + Quarto by
@HamelHusain
This talk will describe integration btw Nbdev+Quarto, enabling developers to author documentation alongside code, and automatically produce a Quarto site for their package.
🔗
7/9
#quartotip
2: Use the echo: fenced chunk option to display the fences around your code chunks in your output. Super useful for teaching Quarto!
Read more:
#quartotip
3: Use the freeze: true or freeze: auto execution option for finer control over when documents in Quarto projects are re-rendered. Especially helpful for not accidentally re-running code in old blog posts!
Read more:
#quartotip
4: Use the include shortcode to include content from a file in another file. Helpful for including repeated content in multiple documents.
Read more:
#quartotip
22: You can create interactive Quarto documents using Shiny. To do so:
- add server: shiny to the YAML of your document
- define Shiny UI elements in plain code chunks
- place Shiny server code in chunks with option context: server
Read more:
@strnr
This is intended to address this and related questions: . Note that to reinforce what
@xieyihui
says in his post, switching is definitely not imperative! If you see something you like in Quarto then give it a try, otherwise no problem at all staying w/ Rmd
Talk: Quarto for R Markdown users by
@thomas_mock
This talk will introduce Quarto as next-gen RMarkdown, compare the similarities and discuss new features for publishing documents, presentations, blog posts, lab notebooks and more!
🔗
5/9
#quartotip
14: Yet another way to highlight a portion of a slide: slide zoom with Alt+Click!
Read more:
--
Alt-text for GIF below: Find the bunny among the cats slide from the post, being zoomed in and out three times.
#quartotip
24: Add citations with
@rstudio
's Visual Editor directly from a DOI. Paste DOI and let it find the reference and place in a bib file for you!
Read more:
---
Alt-text for GIF: Inserting citation from DOI with Visual Editor. Steps in blog post.
@rstudio
#quartotip
29: Use a11y as an accessible syntax highlighting style and have it automatically adapt to light/dark setting of your webpage.
Read more:
#quartotip
23: If you have revealjs slides with no titles and you want them to have informative URLs and placeholder titles on the presentation outline, define a slide ID and data-menu-title.
Read more:
@grrrck
We've updated our Lua development docs with some additional pointers here: . Also note that our VS Code extension now includes integrated support for Lua completion, type-checking, and diagnostics.
#quartotip
17: Quarto websites support light and dark themes and automatically add a light/dark toggle if you supply both themes.
Read more:
---
Alt-text for GIF: Switching between light and dark mode using the toggle on the blog homepage navbar.
#quartotip
11: You can apply styles to inline text by creating spans using [] to surround the text you want to style and {} to define the style you want to apply.
Read more:
@rstudio
#quartotip
26: Add alt-text to images that will be displayed in places like blog post thumbnails, social cards, etc. with image-alt.
Read more:
#quartotip
6: Customize which documents are included in a listing by using the contents option, which allows you to provide a set of input files (or globs of input files) that should be included in the listing.
Read more:
@rstudio
Keynote: Reimagine + Collaborate + Share with Quarto by
@juliesquid
+
@minebocek
.
In this talk, in 4 acts, we will discuss how Quarto unifies + extends the RMarkdown ecosystem and share experiences authoring + teaching + collaborating w/ Quarto.
🔗
2/9
#quartotip
10: To publish a file not explicitly linked from pages in your Quarto site (or if the auto-detection of a linked file fails), add a resources entry to the _quarto.yml file of your project or an individual page's metadata.
Read more:
@AdriMichelson
If you use Netlify there is a feature to put a password on your site on their Pro plan: . If you use GH Pages you can publish privately but only if using GH Pages Enterprise Cloud:
@rstudio
@juliesquid
@minebocek
Workshop 1: Getting Started with Quarto by
@thomas_mock
.
This workshop is designed for those who have no or little prior experience with R Markdown and who want to learn Quarto.
🔗
3/9
@ellamkaye
@chrisderv
We are going to invest our future efforts in the Quarto website/blogging features (but will still fix bugs and make smaller improvements to Distill).
Talk: Websites & Books & Blogs, oh my! Creating Rich Content w/ Quarto by
@DevinPastoor
This talk will showcase how Quarto handles creating and publishing websites+books+blogs and how it enables you to focus on content and takes care of the rest.
🔗
8/9
@DevinPastoor
Looking forward to seeing you in DC!
And if you can't make it to the conference in person, but don't want to miss this content, you can follow along with the talks remotely via the live stream and we will share materials from the workshops in a post-conf roundup post.
9/9
@rstudio
#quartotip
27: Add audio indicator to your slides that plays as you progress from one slide to next or from incremental build to next.
Read more:
#quartotip
13: If you’re a Homebrew person, chances are you’d like to install and update Quarto with Homebrew. Read on for a couple options for doing so!
Read more:
Workshop 2: From R Markdown to Quarto by Andrew Bray.
This workshop is designed for those who want to take their R Markdown skills and expertise and apply them in Quarto, the next generation of R Markdown.
🔗
4/9
Talk: These are a few of my favorite things (about Quarto presentations) by
@tracykteal
This talk will feature highlights of making Quarto: visual editor, multiple columns, speaker notes, transitions, incorporating code, theming, sharing, etc.
🔗
6/9
@Lincoln81
@observablehq
Could you please file this as an issue at (if you haven't already). We are nearing v1.0 announcement so if there is a regression here it would be great to know and fix it before.
@peterejkemp
@thomas_mock
@ibddoctor
@dgkeyes
No principled reason to not support a learnr-type format, just a matter of short/intermediate term priorities (there is probably a couple years of work on other fronts that need to happen before considering this)
@adamjnafa
@bmwiernik
Note that the pre-release version of Quarto has Pandoc 2.19. You can download it here: . Also, `quarto check` isn't failing but rather just reporting that there is no Python config (you don't need to install anything to run quarto check)
@__mharrison__
@thomas_mock
@cbrnr_
@jeremyphoward
@Vernboy
It's not currently in the docs, but you can add an index for LaTeX output using the standard \makeindex command. Here's what you need to add to a vanilla Quarto book to make this work: . We'll update the docs with this info soon!
@PollsAndVotes
Here's the revised error (the inscrutable bit about "mapping entries" is still there -- that's from the yaml parser). Nevertheless we've now got the file and line number right and a better hint about where the problem lies.