Personalizando seus relatórios R Markdown em HTML com o {prettydoc}

O prettydoc é um pacote que oferece alguns templates bem bonitos para serem utilizados em relatórios HTML construídos com R Markdown. Nesse tutorial, vamos mostrar como usar esses templates em seus relatórios!

Então, vamos lá:

  1. Instale o pacote {prettydoc}:
install.packages("prettydoc")
  1. Crie um arquivo R Markdown.

  1. Selecione a opção HTML como formato de saída, e então, clique em From Template.

  1. Selecione a opção Lightweight and Pretty Document (HTML) e então, clique em OK.

  1. Um documento R Markdown como esse será criado:

O importante aqui é o cabeçalho YAML (parte destacada na imagem), ele que vai garantir a personalização do seu relatório.

Podemos ver na imagem que existe um campo chamado theme, e é nele que vamos especificar qual template queremos usar no nosso relatório!

O prettydoc possui 5 templates, são eles: cayman, tactile, architect, leonids, hpstr. Para alterar o template, basta modificar o nome no campo “theme:”. Podemos ver que o template default é o architect.

  1. Para visualizar cada template, basta colocar o respectivo nome no campo “theme:”, e apertar o botão Knit.

Vamos dar uma olhada em cada template:

cayman:

tactile:

architect:

leonids:

hpstr:

Você pode ver mais sobre os templates nessa página

  1. Se você já tem algum relatório em R Markdown e quer personalizá-lo, basta substituir o cabeçalho do seu relatório pelo cabeçalho que foi gerado no passo 4 (pelo prettydoc)

Por exemplo, temos aqui esse relatório com a saída HTML:

Que gera o seguinte HTML ao Knitar:

Ao substituir o cabeçalho (e alterar os campos de Título, Autor e Data), o nosso documento ficou assim:

Aqui estamos usando o template cayman, mas você pode escolher o que preferir!

E voilà, ao Knitar esse documento, o seguinte HTML é gerado:

comments powered by Disqus