- Sou de Manaus (Amazonas);

- Bacharela em Ciências Econômicas;

- Graduanda em Estatística (UFAM) e estagiária no STF;

- Criadora do IG @_estatistica;

- Apaixonada por visualização de dados, Quarto, Rmarkdown
e R/Shiny.


Por que
relatórios
dinâmicos?

Antes de tudo…

Pré-requisitos:


✅ Saber o básico de R e Markdown;


✅ Vontade de querer aprender sobre Quarto 😍

Antes de tudo…

Pré-requisitos:

O Quarto é um software independente de R e pode ser utilizado em diversas ferramentas (RStudio, VS Code, Jupyter Lab, por exemplo). Neste minicurso utilizaremos o RStudio para darmos os primeiros passos. Assim, os pré-requisitos são:

✅ Baixar e instalar a versão mais recente do Quarto;

✅ Baixar e instalar a versão mais recente do R. Caso já tenha, verifique se o seu R está atualizado para R 4.1 ou R 4.2;

✅ Baixar e instalar a versão mais recente do RStudio (v2022.07):

Para detalhes, clique aqui.

Antes de tudo…

Pré-requisitos:


✅ Instale os seguintes pacotes:

pacotes <- c("tidyverse", "quarto", "rmarkdown", "plotly", "DT", "pairsD3")
install.packages(pacotes)


✅ Alternativa:


Um mundo de
possibilidades…

Estrutura

YAML (Yet Another Markup Language)

Local onde são inseridas configurações sobre o documento (formatação, data, título, autor, entre outros). É sempre inserido no início do documento e delimitado por ---.

Alerta

  • Algumas opções são específicas de um determinado tipo documento, assim, podem não funcionar em outro formato (pdf, html, revealjs, por exemplo);
  • Cuidado com a indentação!

Estrutura

Texto

  • Markdown: É uma linguagem de marcação simples para escrever textos

  • R Markdown: Markdown + R

  • Quarto: Tudo isso e mais um pouco!

“Quarto é uma versão multilíngue de próxima geração do R Markdown do RStudio e inclui dezenas de novos recursos, ao mesmo tempo em que é capaz de renderizar a maioria dos arquivos Rmd existentes sem modificação.”
Fonte: Quarto.org.

Sintaxe básica

Se liga!

Quarto é baseado no Pandoc e usa markdown como sua sintaxe de documento principal.

Fonte: Quarto.org

Títulos/Subtítulos ou Seções/Subseções

# Título 1

Título 1

 
## Título 2

Título 2

 
### Título 3

Título 3

 
#### Título 4

Título 4

 
##### Título 5
Título 5
 
###### Título 6
Título 6

Sintaxe básica

  • Quer deixar o texto em negrito?
    Digita **negrito** ou __negrito__.

  • Quer itálico?
    Digita *itálico* ou _itálico_.

  • Quer riscar o texto?
    Digita ~~riscar texto~~

  • Quer apresentar um código na linha?
    Digita o trecho entre crases: `código aqui`

  • E o textosobrescrito?
    Basta colocar texto^sobrescrito^

  • O texto pode ficar um textosubscrito?
    Dá sim: texto~subscrito~

  • Como insiro um hiperlink?
    Digite [nome do link](site do link) ou apenas coloque entre <link-que-eu-quero.com.br>

  • Como colocar imagem no meu relatório? Basta inserir ![](img/fig-10.png){width="180"} e teremos:

    Outras sintaxes podem ser consultadas aqui.


Mas é muita coisa pra lembrar!


Calma… O RStudio te ajuda!

Visual

Temas

Temas disponíveis:

default; cerulean; cosmo; cyborg; darkly; flatly; journal; litera; lumen; lux; materia; minty; morph; pulse; quartz; sandstone; simplex; sketchy; slate; solar; spacelab; superhero; united; vapor; yeti; zephyr

Sintaxe:

---
title: "Título do documento"
format:
  html:
    theme: cerulean # Mudar aqui o nome do tema
---

Também é possível inserir a opção de Dark mode pro seu relatório:

---
title: "Título do documento"
format:
  html:
    theme:
      light: flatly
      dark: darkly
---

Saiba mais em: Quarto.org.

Blocos de chamada

Sintaxe:

::: callout-note
Seu texto aqui!
:::

Demonstrações com callout-important, callout-warning e callout-note:

Importante

Seu texto aqui!

Aviso

Seu texto aqui!

Nota

Seu texto aqui!

Equações

Sintaxe:

$$
Y=\beta _{0} +\beta _{1}x_1+\epsilon
$$

Resultado:

\[ Y=\beta _{0} +\beta _{1}x_1+\epsilon \]


No texto (inline):

Sintaxe:

O resultado será dado por: $x = a^2 + b^2$

Resultado:

O resultado será dado por: \(x = a^2 + b^2\)

Estrutura

Códigos

```{r}
#| fig-width: 5
#| fig-height: 2.5
#| warning: false
#| fig-align: "center"

library(ggplot2)
plot <- ggplot(iris, 
  aes(x = Species,
      y =  Sepal.Length)) + 
  geom_boxplot(aes(fill = Species)) +
  xlab("Espécies") + 
  ylab("Sepal Length") + 
  theme_grey();plot
```


```{r}
#| fig-width: 5
#| fig-height: 3
#| warning: false

plotly::ggplotly(plot)
```

Chunks

Exemplos

Tabela

iris |> 
  DT::datatable(options = list(pageLength = 5))

Chunks

#| fig-width: 5 
#| fig-height: 3 
#| fig-align: "center" 
#| fig-cap: "Minha imagem"
Configuração Descrição
#| fig-width: 5 Largura padrão para figuras geradas por gráficos em R (ou Matplotlib);
#| fig-height: 3 Altura padrão para figuras geradas por gráficos em R (ou Matplotlib);
#| fig-align: "center" Alinhamento horizontal da figura (pode ser left, right ou center);
#| message: false Se false, omite as mensagens do código;
#| warning: false Se false, omite os avisos do código;
#| echo: false Se false, omite o código e mostra somente a saída;
#| eval: false Se false, mostra somente o código do chunk (sem rodar o trecho do código);
#| out.width: "90%" Para especificar a largura das saídas;
#| fig-cap: "Minha imagem" Adicione legenda na figura.

Tabsets

Fonte: Unplash.

Fonte: Unplash.

::: panel-tabset
## Cachorro

<center>

![](img/dog.jpg)

Fonte: [Unplash.](https://unsplash.com/photos/SxLe8EHtC3U "Vitor Fontes - @fontesvitor")

</center>

## Gato

<center>

![](img/cat.jpg)

Fonte: [Unplash.](https://unsplash.com/photos/GtwiBmtJvaU "Yerlin Matu - @yerlinmatu")

</center>

:::

Vídeos (pré-lançamento)

Necessário instalar Quarto v1.2

O suporte para vídeos é um recurso do Quarto v1.2. Se você quiser usar esse recurso, faça o download e instale o Quarto v1.2 antes de continuar.

Instale a versão de pré-lançamento do Quarto aqui. Vale ressaltar que o pré-lançamento destina-se a fins de teste.

Para inserir vídeos, após feita as instalações necessárias, basta inserir o link do Youtube na sintaxe a seguir:

{{< video https://www.youtube.com/watch?v=Jg7BGfeJbIQ&t=603s >}}

O resultado será:

Vídeos (pré-lançamento)

Para alterar o tamanho do vídeo, basta inserir width="xx" (largura) height="xx" (altura), como no exemplo:

{{< video https://www.youtube.com/watch?v=Jg7BGfeJbIQ&t=603s width="400" height="300" >}}

Para mais detalhes, clique aqui.

Relatórios: html

Relatórios: pdf

Pré-requisitos

◾ Instalar uma distribuição recente do TeX: TinyTeX no terminal com o comando:

quarto install tool tinytex

◾ Fechar o RStudio e abrir novamente

◾ Renderizar o documento
 

Links úteis:







  • Pratique várias vezes o que foi aprendido;

  • Explore a documentação do Quarto.org;

  • Ficou com dúvidas? Pode entrar em contato comigo 😉.









https://www.linkedin.com/in/arianehayana/

_

Material do minicurso:
https://github.com/a-hayana/ufpr_quarto

Apresentação elaborada com Quarto no RStudio e background customizado com Canva

Apresentação disponível em: https://ariane.quarto.pub/quarto_ufpr