Quem sou…

- 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.

Antes de tudo…

Pré-requisitos:

✅ Saber o básico de R e RStudio;

✅ 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", "summarytools")
install.packages(pacotes)

✅ Alternativa:

Criando um projeto no Posit Cloud

O início…

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

• R Markdown: Markdown + R
  

“É uma ferramenta que permite a produção de relatórios, documentos e apresentações com R. Para isto ele utiliza a linguagem markdown para informar ao computador como ele deve interpretar e estruturar seus arquivos ou documentos.”

• 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.

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!

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 texto^sobrescrito?
  Basta colocar texto^sobrescrito^

• O texto pode ficar um texto_subscrito?
  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-8.png){width="180"} e teremos:
  
  Outras sintaxes podem ser consultadas aqui.

Mas é muita coisa pra lembrar!

Calma… O RStudio te ajuda!

Visual editor

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 = 4))

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

• Cachorro
• Gato
• Código

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://youtu.be/1FfyDyRinpY >}}

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://youtu.be/1FfyDyRinpY width="400" height="300" >}}

Para mais detalhes, clique aqui.

Fluxograma

Fluxograma com Mermaid

Mermaid é uma ferramenta de diagramação e gráficos baseada em Javascript que usa definições de texto inspiradas em Markdown e um renderizador para criar e modificar diagramas complexos.

graph LR;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

graph LR;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

Nota

Quarto tem suporte nativo para incorporar diagramas. Isso permite que você crie fluxogramas, diagramas muito mais usando uma sintaxe de texto simples inspirada em markdown. Clique aqui para mais detalhes.

Possíveis orientações do fluxograma são:

Código	Orientação
TB	De cima para baixo
BT	De baixo para cima
RL	Direita para esquerda
LR	Da esquerda para a direita

Fonte: Quarto.org

Relatórios: html

Quarto Pub

Quarto Pub é um serviço gratuito de publicação de conteúdo criado com o Quarto. Os documentos criados são visíveis publicamente e fáceis para publicar.

Como publicar no Quarto Pub

Passo 1) Criar uma conta gratuita no Quarto Pub;

Passo 2) Execute o comando:

quarto publish quarto-pub

Passo 3) Aguarde e siga as instruções para autenticação;

$ quarto publish quarto-pub
? Authorize (Y/n) › 
❯ In order to publish to Quarto Pub you need to
  authorize your account. Please be sure you are
  logged into the correct Quarto Pub account in 
  your default web browser, then press Enter or 
  'Y' to authorize.

Passo 4) Volte ao RStudio e confirme que deseja publicar;

Passo 5) Aguarde renderizar e implantar. Em seguida, uma janela do seu navegador será aberta e o seu conteúdo estará pronto para visualização.

Quarto Pub

Para mais detalhes, acesse Quarto.org.

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:

• Básico sobre documentos em pdf com Quarto: PDF Basics;
• Guia do usuário Pandoc: Pandoc User’s Guide;
• Catálogo de fontes: The LaTeX Font Catalogue.

• Pratique várias vezes o que foi aprendido;
  
  

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

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

E lembre-se…

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

_

---

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