Compilação de arquivos Rmd

Objetivos de aprendizado

• Ser capaz de renderizar um arquivo Rmd em diferentes formatos de saída;
• Conhecer os comandos e opções disponíveis para a renderização de documentos.

O que significa compilar um arquivo Rmd?

Fluxo de trabalho que ocorre durante a compilação de um arquivo Rmd. Extraído do sítio digital do livro “Rmarkdown Cookbook”.

Compilação utilizando a estrutura do RStudio

O RStudio é otimizado para lidar com arquivos Rmd. Para compilar um arquivo neste programa, basta abrir o arquivo Rmd e clicar no botão “Knit” na barra de ferramentas (Figura 4.1). Isso compilará o arquivo Rmd, executando o código (se presente!) e incorporando os resultados no documento final.

Figura 4.1: Botão “Knit” destacado com um retângulo verde. Este botão está localizado em uma barra abaixo dos nomes de arquivos abertos dentro do RStudio. Clicando neste botão, você compila o arquivo para o formato especificado no próprio arquivo. Caso clique em uma seta ao lado do nome “Knit”, outras opções de formato final são apresentadas, como mostra esta figura.

Linha de comando

Para compilar um arquivo Rmd usando a linha de comando, você pode usar o seguinte comando no console do R:

rmarkdown::render("caminho/do/seu/arquivo.Rmd")

Por exemplo, vamos imaginar que tenhamos um arquivo chamado “arq1.Rmd” em minha pasta de trabalho e desejo compilá-lo. Devemos executar o seguinte comando:

rmarkdown::render("arq1.Rmd")

Dica

Caro leitor,

Caso você não tenha conhecimento suficiente em R ou se sinta inseguro ao utilizar a linguagem, recomendo a leitura do livro Curso básico de introdução à linguagem R, disponível gratuitamente na rede.