R in 3 Months Week 12 Advanced RMarkdown

---

# Agenda

1. Housekeeping

1. What else can RMarkdown do?

1. Quarto

1. Final assignment: show us what you can do!

1. Final week: let's see what you did!

---

# What else can RMarkdown do?

---

## RMarkdown can do a lot...

We've seen that you can make the following:

- HTML reports

- PDF reports

- Word reports

... but there's a lot more.
]

- Beautiful books with `bookdown`

- Beautiful reports with `pagedown`

- Beautiful slides with `xaringan`

- Programmatically generated reports

- Dashboards (... and even shiny apps!)

- Websites all in RMarkdown!

]

---

# Books

---

## Beautiful books with `bookdown`

.pull-left[
The `bookdown` package was used for writing R for Data Science and many other extremely useful R books.
]

.pull-right[
<img src='https://d33wubrfki0l68.cloudfront.net/b88ef926a004b0fce72b2526b0b5c4413666a4cb/24a30/cover.png' height='300px'/>
<img src='https://www.tidytextmining.com/images/cover.png' style='align:right' height='300px'/>
]

???

https://rfortherestofus.com/2022/04/bookdown/
https://book.rwithoutstatistics.com/

---

# PDF Reports

---

## Beautiful reports with `pagedown`

Instead of learning `LaTeX` you can use HTML and CSS!

[Blog post on customizing `pagedown`](https://rfortherestofus.com/2022/11/no-designer-needed/)

]

.pull-right[
<center><img src='https://raw.githubusercontent.com/rstudio/hex-stickers/master/SVG/pagedown.svg' height='300px'/></center>
]

---

## `pagedreport`

.pull-left[
R for the Rest of Us has created a package called [`pagedreport`](https://pagedreport.rfortherestofus.com/) that adds several templates to `pagedown`.

]

.pull-right[
<center><img src='https://camo.githubusercontent.com/f0956be0c95edd980629ffe24ae98167d9727caf38f58299de86f4f1eabe3a1d/68747470733a2f2f6d6b3072666f72746865726573746f306f3038712e6b696e73746163646e2e636f6d2f77702d636f6e74656e742f75706c6f6164732f323032312f30312f677269642e676966' height='300px'/></center>
]

---

# Websites

---

[![](images/westchester-covid-site.png)](https://westchester-covid.mattherman.info/)

---

## `distill` for websites (and blogs)

Using `distill` is the easiest way to create a fully functioning website with RMarkdown.

---

# Parameterized reports

---

## Parameterized reports

Use [parametrized RMarkdown reporting](https://bookdown.org/yihui/rmarkdown/parameterized-reports.html) to make a separate report for each group

???

https://rfortherestofus.com/2020/10/parameterized-reporting-with-rmarkdown/

---

# Quarto...

---

### Quarto is the next generation of RMarkdown

Quarto is a new technology that will be the future of RMarkdown.

It's not **quite** stable enough for us to switch our teaching materials from RMarkdown to Quarto.

> And RMarkdown is **not** going away. RMarkdown will continue to be supported and developed into the future.

]

]

---

### Why does Quarto exist?

RMarkdown is quite limited in that it's only useful for folks in the R community.

Quarto is designed from the ground up to work for R, Python and Julia users.

It's very exciting - but we feel it's worthwhile having some caution about learning it right now.
]

]

---

## ... oh, and about RStudio

RStudio have also rebranded themselves to Posit.

This is because they want to add other people to our community who don't use R.

- The RStudio application is not changing name

- Posit are dedicated to the R community!!

]

]

---

### Where to find out more about Quarto

[Tom Mock](https://twitter.com/thomas_mock) from Posit gave a [great 2h workshop on Quarto](https://www.youtube.com/watch?v=yvi5uXQMvu4) we'd recommend.

Actually using Quarto is not much different from RMarkdown

````default
---
title: "Untitled"
format: html
---

Everything's the same except:

- We use `format` instead of `output` in the YAML header

- Code chunk options are written differently

```{r}
#| echo: false
rep("lots of cats", 5)
```
````

]

]

---

# Final Week

Charlie will host her office hours as usual at 12pm Tuesday.

In the final live session we'll cover:

- What resources to use next.

- How to ask reproducible questions with {reprex}

- Highlighted assignment submissions from **you folks**!

---

# Final assignment

---

### Final assignment

We'd love to understand how R in 3 Months is going to help you with your work/datasets.

We'd like you to record a 5 minute video showing something you can now do with your real data/project.

> [Loom.com](https://www.loom.com/pricing) has a free tier that will allow you to record and share 5 minute videos.

There's a form to fill on [Week 13's assignment submission page](https://rfortherestofus.com/courses/r-in-3-months-fall-2022/lessons/rin3-fall-2022-final-project/).

---

# Feedback

We love doing this type of training and want to continually improve it.

Please fill out this [post-survey that shows your skill now](https://docs.google.com/forms/d/e/1FAIpQLSf_J9lmld48qKxYlj2RVeyuw8FfdMuJhqD_3R7ePX5tGH0_0g/viewform?usp=sf_link) (we'll compare this to what you told us in the pre-survey) and allows you to provide anonymous feedback.

---

# Next Week

- No course assignments

- Record a <5-minute video showing what you've learned

- Please complete [post-survey](https://docs.google.com/forms/d/e/1FAIpQLSf_J9lmld48qKxYlj2RVeyuw8FfdMuJhqD_3R7ePX5tGH0_0g/viewform?usp=sf_link)

- Charlie's office hours are still on

- The live session will give you pointers of where to go next