Ariane Hayana

Sou de Manaus (Amazonas);

Graduada em Economia e Estatística (UFAM);

Criadora do IG @_estatistica;

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

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

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.

Para detalhes, clique aqui.

Antes de tudo…

Pré-requisitos:

Instale os seguintes pacotes:

pacotes <- c("tidyverse", "quarto", "rmarkdown", "plotly", "DT", "pairsD3", "summarytools", "dados", "reactable")
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!

Texto: 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

Texto: 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

Funcionamento

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!
:::

Saiba mais em: Quarto.org.

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 |>
  reactable::reactable(groupBy = "Species", # Agrupando pela coluna 'Species'
  searchable = TRUE, # Inserindo uma busca na tabela
  outlined = TRUE) # Linhas na tabela

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.

Fonte: Foto de Jamie Street na Unsplash.

Fonte: Foto de Chi Nguyen Phung na Unsplash.

::: panel-tabset
## Cachorro

<center>

![Fonte: Foto de [Jamie Street](https://unsplash.com/@jamie452?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText "Foto de Jamie Street na Unsplash") na [Unsplash.](https://unsplash.com/pt-br/fotografias/VETPuVqsqnQ?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText)](img/dog.jpg)

</center>

## Gato

<center>

![Fonte: Foto de [Chi Nguyen Phung](https://unsplash.com/@chinguyenphung?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText "Foto de Chi Nguyen Phung na Unsplash") na [Unsplash.](https://unsplash.com/pt-br/fotografias/lmXKxLkki4k?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText)](img/cat.jpg)

</center>

:::

Vídeos

Para inserir vídeos, basta inserir o link do Youtube na sintaxe a seguir:

{{< video https://youtu.be/tE88RxsUOuc >}}

O resultado será:

Vídeos

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

{{< video https://youtu.be/tE88RxsUOuc width="400" height="300" >}}

Para mais detalhes, clique aqui.

Code Annotation (pré-lançamento)

Necessário instalar Quarto v1.3

O Code Annotation é um recurso do Quarto v1.3. Se você quiser usar esse recurso, faça o download e instale o Quarto v1.3 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.

Na versão de pré lançamento é possível incluir anotações baseadas em linha. As anotações baseadas em linhas fornecem uma maneira de anexar explicações às linhas de código de maneira semelhante às notas de rodapé. Veja o exemplo aqui.

Configurações

Exemplo do cabeçalho:

---
title: "Meu título"
format: html
code-annotations: hover # Não esquecer!
editor: visual
---

Code Annotation (pré-lançamento)

``` r
#| warning: false
#| message: false

library(dados)
library(reactable)
library(dplyr)

dados_gapminder |>                                  # <1> 
  select(continente, pais, ano, pib_per_capita) |>  # <2> 
  reactable(
    groupBy = "continente",                         # <3>
    searchable = TRUE,                              # <4>
    outlined = TRUE,                                # <5>
    columns = list(ano = colDef(sortable = TRUE)))   # <6>
```

1.  Base do pacote {dados}
2.  Selecionando algumas colunas
3.  Agrupando pela coluna 'continente'
4.  Inserindo uma busca na tabela
5.  Linhas na tabela
6.  Ordem crescente na coluna 'ano'

Saiba mais em: Quarto.org.

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 no Terminal:

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 curioso(a)? No Blog da R-Ladies São Paulo tem um tutorial
sobre Quarto bem legal! 😍 Clique aqui;
Ficou com dúvidas? Pode entrar em contato comigo 😉.

E lembre-se…

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

Material do minicurso:

[Disponível após o curso]

Ariane Hayana

Sou de Manaus (Amazonas);

Graduada em Economia e Estatística (UFAM);

Criadora do IG @_estatistica;

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

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

Antes de tudo…

Pré-requisitos:

Antes de tudo…

Pré-requisitos:

Antes de tudo…

Pré-requisitos:

Criando um projeto no Posit Cloud

O início…

Estrutura

YAML (Yet Another Markup Language)

Texto: sintaxe básica

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

Título 1

Título 2

Título 3

Título 4

Título 5

Título 6

Texto: sintaxe básica

Visual editor

Temas

Blocos de chamada

Equações

Estrutura

Códigos

Chunks

Exemplos

Tabela

Chunks

Tabsets

Vídeos

Vídeos

Code Annotation (pré-lançamento)

Configurações

Exemplo do cabeçalho:

Code Annotation (pré-lançamento)

Quarto Pub

Como publicar no Quarto Pub

Quarto Pub

Relatórios: pdf

E lembre-se…

Relatórios: `pdf`