Relatórios Reprodutíveis com Quarto
Insper
19 de outubro de 2022
Slides para exposição dos conceitos
Demonstrações no RStudio
Trabalho em grupo no final
O conhecimento de experts disponível para você.
Quanto mais você programa, mais eficiente você fica.
Mais fácil de organizar, entender e reaproveitar seu trabalho.
Fóruns e comunidades sempre te ajudando
O dia-a-dia de quem trabalha com ciência de dados
É um sistema de publicação científica gratuito e aberto.
Permite misturar texto e código no mesmo arquivo, chamado Quarto Markdown (.qmd
).
Organiza a forma de escrita, as linguagens de programação e os formatos de saída em uma estrutura unificada.
O documento é processado e gera HTML, PDF, Word ou outro formato que você quiser!
A rota do sucesso do Quarto
Para pessoas que já usam R: o Quarto é quase igual ao RMarkdown. A vantagem do Quarto é apenas ter algumas facilidades a mais (como autocomplete de parâmetros no RStudio) e novos templates.
Para pessoas que usam outras linguagens: No entanto, por ser um software independente de R, o Quarto exporta todas as qualidades do RMarkdown para outras linguagens, especialmente Python, Julia e JavaScript.
Para quem não usa programação: O Quarto é um excelente formato para quem quer escrever artigos, listas de exercícios e até blogs/sites.
Principais marcadores utilizados para formatar texto:
uma palavra entre asteriscos fica em itálico: *texto*
é transformado em texto
uma palavra entre dois asteríscos fica em negrito: **texto**
é transformado em texto
um ou mais hashtags viram títulos: # Título muito grande
, ## Título grande
, ### Título médio
, #### Título pequeno
, ##### Título muito pequeno
hiperlinks podem ser criados com a estrutura [texto](link)
:
[link para site](https://curso-r.com)
é transformado em link para site.
para deixar o texto com esse formato
(formato de código), apenas coloque o texto entre duas crases.
Material de consulta: Livro: Ciência de Dados em R - Seção sobre Markdown
Em um arquivo .qmd
, precisamos escrever nossos códigos dentro dos chunks. Para inserir um chunk, utilize o atalho CTRL + ALT + I
.
É possível adicionar campos de código utilizando a seguinte sintaxe:
Material de consulta: Livro Curso-R
Podemos facilmente enviar os arquivos .pdf
e .docx
via e-mail.
No HTML, para disponibilizar dessa forma, precisamos deixá-lo autocontido:
Outra forma é disponibilizar o HTML na internet, com serviços como Quarto Pub, Netlify Drop ou GitHub.
Vamos utilizar o Quarto Pub. Para outros formatos, ver os slides aqui.
O Quarto Pub é um site criado para disponibilizar projetos em Quarto. Ele é totalmente gratuito, mas suas páginas precisam ficar publicamente acessíveis.
Para disponibilizar o seu trabalho no Quarto Pub, rode na linha de comando
Se sua conta não estiver configurada, siga as instruções que ele vai mandar:
Se quiser acessar o código e a base de dados, entre aqui: link
Se quiser usar esse template de apresentações, acesse o GitHub do padsInsper
2022