Introdução ao Quarto#
Neste capítulo, vamos apresentar-te ao Quarto, um sistema de autoria que ajuda a criar documentos reprodutíveis. Daremos uma visão geral do Quarto, a sua estrutura básica e explicaremos como podes incluir blocos de código que podem ser executados para gerar tabelas, gráficos e outros resultados diretamente dentro do documento.
O que podem publicar com Quarto?#
Quarto é um sistema de publicação de código aberto que é construído para criar documentos reprodutíveis integrando código, dados e texto narrativo. Os documentos do Quarto podem ser renderizados em vários formatos, como HTML, PDF, Word, powerpoints e até sites e blogs, tornando-o altamente versátil para diferentes necessidades de saída. Alguns usos comuns do Quarto incluem:
Trabalhos científicos com elementos dinâmicos;
Relatórios de análise de dados;
Apresentações;
Materiais de ensino;
Estrutura Básica de um Documento Quarto;
Documento Quarto#
Metadados YAML#
Esta é a seção de cabeçalho do documento delimitada por linhas —. Contém metadados como o título, autor e opções para renderizar o documento.
Exemplo de Metadados YAML
Secção de Conteúdo: Aqui escreves o conteúdo principal do documento usando a sintaxe markdown. Isto pode incluir texto, cabeçalhos, listas, imagens, blocos de código e mais.
---
title: "O Meu Documento"
author: "Luís Silva"
---
Blocos de Código em Documentos Quarto#
Uma das características poderosas do Quarto é a sua capacidade de incluir blocos de código dentro do documento. Estes blocos de código podem ser escritos em linguagens como Python ou R, e podem ser executados para gerar resultados como tabelas, gráficos e estatísticas que são incorporados diretamente no documento.
Aqui está um exemplo de um bloco de código:
Os blocos de código são incluídos usando três acentos graves seguidos pelo nome da linguagem entre chaves (por exemplo, {python} ou {r}). Podes escrever o código dentro destes acentos graves, e quando o documento é renderizado, o código será executado e o resultado será incluído no documento.
Como dito anteriormente o atalho de teclado é Ctrl+Shift+i, seleccionando depois a linguagem desejada.
Aqui está um exemplo de um bloco de código que cria um gráfico:
Podem ver também o que acontece quando corremos a célula. No lado direito aparece uma secção nova que é uma janela interactiva onde aparecem os outputs do código.
Quarto torna incrivelmente fácil combinar texto narrativo, código e saída num único documento coeso.
No próximo capítulo, iremos mergulhar na criação e renderização do nosso primeiro documento Quarto.