The Download

class: title-slide, left, middle

.pull-left[

# The Download

## Recent developments with R Markdown

### Alison Presmanes Hill, Ph.D.

### 2020-10-26
]

---
name: clouds
class: center, middle
background-image: url(images/clouds.jpg)
background-size: cover

---
template: clouds

## .big-text[Hello.]

???

So hello- I'm so happy to be invited to join you all today.

---
name: clouds
background-image: url(images/clouds.jpg)
background-size: cover

---
name: hello
template: clouds
class: middle, center

### Alison Hill

[ @apreshill](https://github.com/apreshill) 
[ @apreshill](https://twitter.com/apreshill) 
[ alison.rbind.io](https://alison.rbind.io)

???

My name is Alison Hill, and I'm a data scientist and professional educator at RStudio.

---
background-image: url(images/pkgs.png)
background-position: left
background-size: contain
class: middle, center

.pull-right[
# *(Some members of)*
# *the R Markdown family*
]

---
class: middle, center

# ~20 packages

rstudio/rmarkdown  
rstudio/distill  
rstudio/flexdashboard  
rstudio/learnr  
rstudio/tufte  
rstudio/bookdown  
rstudio/blogdown  
rstudio/markdown  
rstudio/rticles  
rstudio/pagedown  
rstudio/revealjs  
yihui/knitr  
yihui/xaringan  
yihui/xfun  
yihui/servr  
yihui/tinytex  
yihui/highr  
yihui/Rd2roxygen

---
class: inverse, middle, center

# Distill

```r
install.packages("distill")
```

---
class: middle, center

# Distill

✔️ Optimized for scientific + technical communication

✔️ Nice CSS

✔️ No (extra) dependencies

<https://rstudio.github.io/distill/>

---
class: middle, center

### Problem: I just want to change [fonts / colors / size]

### Solution: try the themer!

---
class: inverse, middle
background-image: url(images/paint-cat.jpg)
background-size: contain
background-position: right
background-color: #191A1C

# Distill themer demo

---
class: middle, center, inverse

## Learn more:

<https://blog.rstudio.com/2020/12/07/distill/>

<https://rstudio.github.io/distill/>

<https://pkgs.rstudio.com/distill/>

---
class: inverse, middle, center

# Blogdown

```r
devtools::install_github("rstudio/blogdown")
```

---
class: middle, center

# Blogdown

✔️ Power of Hugo + markdown

✔️ Themes

✔️ Subdirectories

<https://malco.io/>

---
class: middle, center

### Problem: my blogdown/Hugo site is broken!

### Solution: make your blogdown unbreakable

---
class: middle
background-image: url(images/trouble-kittens.jpg)
background-position: left
background-size: contain
background-color: #f4f4f3

.pull-right[
# So many things can go wrong

+ Hugo versions

+ R package versions

]

---
class: middle

# Hugo versions

```r
library(blogdown)
hugo_version() # check it
```

--
### Set it and forget it

```r
config_Rprofile() # open it
```

`options(blogdown.hugo.version = "0.78.2")`

---
class: middle

# Hugo versions

--
### Tell Netlify and forget it!

```r
config_netlify() # open it
```

```toml
[build.environment]
HUGO_VERSION = "0.78.2"
```

---
class: middle

# Hugo versions

--
### Manage it

```r
find_hugo('all') 
remove_hugo()
```

---
class: middle

# R package versions

🧶 it yourself

### Make the knit button great again!

<https://github.com/rstudio/blogdown/commit/d32c2945623581377e256d3f7f6e3566c05e3d6f>

---
class: middle

# R package versions

### Tell blogdown not to 🧶

```r
config_Rprofile() # open it
```

Add:

`options(blogdown.knit.on_save = FALSE)`  
`options(blogdown.files_filter = blogdown:::md5sum_filter)`

---
class: middle

# Healthy `.Rprofile` for happy blogdown users

```r
options(blogdown.hugo.version = 0.78.2,
        blogdown.knit.on_save = FALSE,
        blogdown.files_filter = blogdown:::md5sum_filter,
        # other nice to haves!
        blogdown.title_case = TRUE,
        blogdown.initial_files = FALSE,
        # nice defaults!
        blogdown.new_bundle = TRUE,
        blogdown.warn.future = TRUE,
        blogdown.draft.output = FALSE
        )
```

---
class: middle, center, inverse

# 💣

```r
blogdown::build_site(build_rmd = TRUE)
```

*"`blogdown::build_site()` no longer recompiles R Markdown files by default, because it may be expensive and often undesirable to compile Rmd files that have been compiled before. If you do want to recompile Rmd files, use this."*

---
class: middle, center, inverse

# 😱

What happened to `public/`?

```r
blogdown::build_site()
```

---
class: middle, center, inverse

# That was a lot!

![](https://media.giphy.com/media/sRIXt1e9dQRjEjxnMk/giphy.gif)

---

# 🛩 Pre-flight checks

```r
# kitchen sink
check_site()

# one at a time
check_config()

check_gitignore()

check_hugo()

check_netlify()

check_content()
```

---
class: inverse, middle, center

# Blogdown `.Rprofile` + pre-flight checks demo

---
class: middle, inverse
background-image: url(images/blogdown-book.png)
background-position: right
background-size: 50%

## Learn more 😬

---
class: middle, center

# 🕙 check

bookdown?

```r
?bs4_book
```

<https://crumplab.github.io/rstatsforpsych/>

xaringan?

Self-contained slides: <https://github.com/yihui/xaringan/issues/3>