R Markdown

class: center, middle, hide-logo

<script src="https://kit.fontawesome.com/1f72d6921a.js" crossorigin="anonymous"></script>

<script async defer src="https://buttons.github.io/buttons.js"></script>

<div>
<style type="text/css">.xaringan-extra-logo {
width: 110px;
height: 128px;
z-index: 0;
background-image: url(https://beatrizmilz.github.io/slidesR/introR/img/rainbow-inclusive.png);
background-size: contain;
background-repeat: no-repeat;
position: absolute;
top:1em;right:1em;
}
</style>
<script>(function () {
  let tries = 0
  function addLogo () {
    if (typeof slideshow === 'undefined') {
      tries += 1
      if (tries < 10) {
        setTimeout(addLogo, 100)
      }
    } else {
      document.querySelectorAll('.remark-slide-content:not(.title-slide):not(.inverse):not(.hide_logo)')
        .forEach(function (slide) {
          const logo = document.createElement('a')
          logo.classList = 'xaringan-extra-logo'
          logo.href = 'https://github.com/R-Ladies-Sao-Paulo/RLadies-Brasil'
          slide.appendChild(logo)
        })
    }
  }
  document.addEventListener('DOMContentLoaded', addLogo)
})()</script>
</div>

.pull-left[
# R Markdown

.center[**Usando R para gerar diferentes tipos de relatórios**]

**[Beatriz Milz](https://beatrizmilz.com)** <a href='mailto:beatriz.milz@usp.br'><i class="far fa-envelope"></i></a>  <a href='https://twitter.com/BeaMilz'><i class="fab fa-twitter"></i>   <a href='https://github.com/beatrizmilz'><i class="fab fa-github"></i></a> <a href='https://discourse.curso-r.com/u/beatrizmilz/summary' target="_blank"><i class="fab fa-discourse"></i></a>

[R-Ladies São Paulo](https://beatrizmilz.github.io/slidesR/rladies.html)

]

.pull-right[
<img src="img/rmarkdown_wizards.png" width="5303" style="display: block; margin: auto;" />

Ilustração por [@Allison Horst](https://github.com/allisonhorst/stats-illustrations).

]

__.can-edit[We R Live - Canal [GeoCast Brasil](https://www.youtube.com/c/geocastbrasil/about)]__

.minirodape[Atualizado em 19 de October de 2021.]

---
class:  middle
<img src="https://raw.githubusercontent.com/allisonhorst/stats-illustrations/master/rstats-artwork/rmarkdown_rockstar.png" width="70%" style="display: block; margin: auto;" />

---
class: middle

## R Markdown

.pull-left[
<img src="https://camo.githubusercontent.com/de0519dd8e4ebc982eb0ddfaa9c6cd0924149e6c/68747470733a2f2f626f6f6b646f776e2e6f72672f79696875692f726d61726b646f776e2f696d616765732f6865782d726d61726b646f776e2e706e67" width="60%" style="display: block; margin: auto;" />

]

.pull-right[

- [Mantido pela RStudio](https://rmarkdown.rstudio.com/)

- [Galeria](https://rmarkdown.rstudio.com/gallery.html)

- [Relatórios com parâmetros](https://rmarkdown.rstudio.com/developer_parameterized_reports.html)

]

???

- Exemplos:
  - Novo arquivo RMarkdown
  - RMarkdown usando parâmetros
---
class: center, middle, inverse

## Pacotes

- Pacotes também oferecem templates (`File > New File > R Markdown > From template`)

.pull-left[
📦 xaringan

📦 pagedown

📦 blogdown

]

.pull-right[
📦 distill

📦 bookdown

📦 learnr
]

---

## 📦 xaringan

- Criar apresentações com R

Exemplos de apresentações: 
  - [Garrick Aden-Buie](https://www.garrickadenbuie.com/talk/build-your-own-universe/)
  - [Alison Hill e Desirée De Leon](https://rstudio-education.github.io/sharing-short-notice/#1)
---

## 📦 xaringan

Outros pacotes para usar com xaringan:

- [pagedown](https://github.com/rstudio/pagedown) - ✔️ CRAN, ✔️ GitHub

- [xaringanthemer](https://pkg.garrickadenbuie.com/xaringanthemer/) - ✔️ CRAN, ✔️ GitHub

- [xaringanExtra](https://pkg.garrickadenbuie.com/xaringanExtra/) - ❌ CRAN, ✔️ GitHub

- [giphyr](https://github.com/haozhu233/giphyr) - ✔️ CRAN, ✔️ GitHub

- [countdown](https://pkg.garrickadenbuie.com/countdown/#1) - ❌ CRAN, ✔️ GitHub
 
- [emo](https://github.com/hadley/emo) + [ermoji](https://www.garrickadenbuie.com/project/ermoji/)  - ❌ CRAN, ✔️ GitHub

---
## 📦 pagedown

- [Mantido pela RStudio](https://github.com/rstudio/pagedown)

- [Galeria](https://github.com/rstudio/pagedown)

- Vários templates. Quais uso mais? Resume e Thesis.

- Exemplo: [Meu currículo](https://beatrizmilz.github.io/resume/index.html) (📦 [pagedown](https://github.com/rstudio/pagedown) + 📦 [datadrivencv](http://nickstrayer.me/datadrivencv/))

---

## 📦 blogdown

- [Mantido pela RStudio](https://github.com/rstudio/blogdown)

- Exemplos:
  - [Meu blog](https://beatrizmilz.com)
  - [Alison Hill](https://alison.rbind.io/)
  - [Florencia D'Andrea](https://florencia.netlify.app/)

---

## 📦 distill

- [Mantido pela RStudio](https://rstudio.github.io/distill/)

- Exemplos:
  - [Minha página com apresentações](https://beatrizmilz.github.io/slidesR/)
  - [Minha página com os materiais da certificação da RStudio](https://beatrizmilz.github.io/RStudio_Certification/)
  - [RStudio AI Blog](https://blogs.rstudio.com/ai/)
  
  
- Coisas legais:
  - Referências: [Citações no distill](https://rstudio.github.io/distill/citations.html); Compare [distill](https://beatrizmilz.github.io/slidesR/ferramentas.html) e [blogdown](https://beatrizmilz.com/post/2020-07-27-coleta-e-tratamento-de-esgoto/)
  -  [metadados do distill](https://rstudio.github.io/distill/metadata.html)

- Tags meta:

- 📦 [metathis](https://pkg.garrickadenbuie.com/metathis/)

- [Metatags com blogdown - leitura futura (para mim)](https://xvrdm.github.io/2017/10/23/socialize-your-blogdown/)
  
  - [Twitter card validator](https://cards-dev.twitter.com/validator)
  
---

## 📦 bookdown

- [Mantido pela RStudio](https://github.com/rstudio/bookdown)

- Exemplos:
  - [Tidy models with R](https://www.tmwr.org/)
  - [Ciência de Dados em R](https://livro.curso-r.com/) - da [Curso-R](https://curso-r.com/)
  
  
---

## 📦 learnr

- [Mantido pela RStudio](https://github.com/rstudio/learnr)

- [Galeria de exemplos](https://rstudio.github.io/learnr/examples.html)

- Exemplos:
  -  [Exploring missing values in naniar](https://allisonhorst.shinyapps.io/missingexplorer/)
  - [Minha página com os materiais da certificação da RStudio](https://beatrizmilz.github.io/RStudio_Certification/)

Materiais interessantes:
- [Teach R with learnr: a powerful tool for remote teaching](https://education.rstudio.com/blog/2020/05/learnr-for-remote/)

- [How to deliver learnr tutorials in a package](https://education.rstudio.com/blog/2020/09/delivering-learnr-tutorials-in-a-package/)

---
## LatinR

- [Conferência Latino-Americana sobre o Uso de R em P&D](https://latin-r.com/programacao/)

- 7 a 9 de outubro de 2020

- Virtual e __gratuito__

### Workshops:
  - [Escrevendo manuscritos acadêmicos usando RMarkdown](https://www.meetup.com/es/rladies-natal/events/273508552/)
  
  - [Comunicando seus resultados com R: aprenda a criar apresentações reprodutíveis](https://www.meetup.com/pt-BR/rladies-goiania/events/273531145/)
  
  - [Generando tutoriales interactivos con el paquete learnr](https://www.meetup.com/es-ES/rladies-santa-rosa/events/273513242/) - Em Espanhol 
  
---
class: middle

## Como fazer blogs com RMarkdown?

- Usando blogdown e distill.

---
<img src="https://raw.githubusercontent.com/allisonhorst/stats-illustrations/master/rstats-artwork/presenting_monster.png" style="display: block; margin: auto;" />

---
class: center, middle

# Obrigada!

Slides criados com o pacote [**xaringan**](https://github.com/yihui/xaringan).

Tema criado com o pacote [**xaringanthemer**](https://pkg.garrickadenbuie.com/xaringanthemer/) e funções extras com [**xaringanExtra**](https://pkg.garrickadenbuie.com/xaringanExtra/).

Várias ilustrações usadas na apresentação foram feitas por  <a href='https://twitter.com/allison_horst/'> Allison Horst</a>. Clique [aqui](https://github.com/allisonhorst/stats-illustrations) para ver várias outras artes feitas por ela!

O maravilhoso logo da R-Ladies usado nesta apresentação é uma obra de [Bea @Chucheria](https://twitter.com/chucheria)! Obrigada!