1. Definições e conceitos sobre Quarto;
   
   

2. Criando o seu primeiro Quarto book do zero;
   
   

3. Personalizando o Quarto book;
   
   

4. Publicando no Quarto Pub.

• Quarto é uma versão multilíngue da próxima geração do R Markdown e com ele é possível criar uma variedade de documentos, apresentações, livros, blogs, entre outros recursos;
  
  

• Um sistema de publicação científica e técnica de código aberto.
  
  

• Podemos analisar, compartilhar e reproduzir. Enfim, diversas possibilidades para contar histórias com dados.

Saiba mais em: Quarto.org

O Quarto é um software independente de R e pode ser utilizado em diversas ferramentas (RStudio, VS Code, Jupyter Lab, por exemplo). Nesta apresentação 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;
  

Para detalhes, clique aqui.

• Baixar e instalar a versão mais recente do RStudio.
  
  

• Instalar os seguintes pacotes:

pacotes <- c("tidyverse", "quarto", "rmarkdown", "dados", "reactable")
install.packages(pacotes)

Configuração (_quarto.yml)

Um arquivo de projeto Quarto (_quarto.yml) está contido no diretório do projeto. Este arquivo contém a configuração inicial do seu livro e é onde são inseridas configurações sobre o documento (formatação, data, título, autor, entre outros).

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!

Markdown

Sintaxe básica

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

Markdown

• Texto em negrito: **negrito** ou __negrito__.
  
  
• Texto em itálico: *itálico* ou _itálico_.
  
  
• Texto tachado: ~~riscar texto~~
  
  
• Inserir código na linha:
  Entre crases: `código aqui`
  
  
• Texto^sobrescrito:
  Basta colocar texto^sobrescrito^

• Subscrito um texto_subscrito:
  Insira: texto~subscrito~
  
  

• Inserir hiperlink?
  Insira [nome do link](site do link)
  
  

• Colocar imagem: ![](img/fig-8.png){width="180"}. Como resultado teremos:
  
  Outras sintaxes podem ser consultadas aqui.

Nomenclaturas e referências

Prefixo	Descrição
#def-	Definição
#exm-	Exemplo
#exr-	Exercício
#fig-	Figura
#tbl-	Tabela
#eq-	Equações

Códigos

```{r}
#| fig-width: 8
#| fig-height: 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
```

Códigos

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

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.

VII SER - Seminário Internacional de Estatística com R

Apresentação criada no RStudio com Quarto

---

Ariane Hayana

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

Materiais em: https://github.com/a-hayana/ser2023