Saber o básico de R e RStudio;
Vontade de querer aprender sobre Quarto 😍
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.
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 é 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.
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
Se liga!
Quarto é baseado no Pandoc e usa markdown como sua sintaxe de documento principal.
Fonte: Quarto.org
|
Título 1 |
|
Título 2 |
|
Título 3 |
|
Título 4 |
|
Título 5 |
|
Título 6 |
**negrito**
ou __negrito__
. *itálico*
ou _itálico_
. ~~riscar texto~~
código
na linha? `código aqui`
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-8.png){width="180"}
e teremos:
Outras sintaxes podem ser consultadas aqui.
Mas é muita coisa pra lembrar!
Calma… O RStudio te ajuda!
Sintaxe:
Saiba mais em: Quarto.org.
Sintaxe:
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!
Sintaxe:
Resultado:
\[ Y=\beta _{0} +\beta _{1}x_1+\epsilon \]
No texto (inline):
Sintaxe:
Resultado:
O resultado será dado por: \(x = a^2 + b^2\)
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. |
::: 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>
:::
Para inserir vídeos, basta inserir o link do Youtube na sintaxe a seguir:
O resultado será:
Para alterar o tamanho do vídeo, basta inserir width="xx"
(largura) height="xx"
(altura), como no exemplo:
Para mais detalhes, clique aqui.
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.
``` 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 é 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.
Passo 1) Criar uma conta gratuita no Quarto Pub;
Passo 2) Execute o comando no Terminal:
Passo 3) Aguarde e siga as instruções para autenticação;
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.
Para mais detalhes, acesse Quarto.org.
pdf
Pré-requisitos
Instalar uma distribuição recente do TeX: TinyTeX no
terminal
com o comando:
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 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 😉.
https://www.linkedin.com/in/arianehayana/
Material do minicurso:
[Disponível após o curso]
Apresentação elaborada com Quarto no RStudio
e
background customizado com Canva
Apresentação disponível em:
https://ariane.quarto.pub/rladies_goiania