Capítulo 1 O pacote bookdown

O pacote bookdown, de autoria de Yihui Xie, combina a simplicidade da linguagem R Markdown com as funcionalidades do (Pandoc)[https://pandoc.org/].

Segundo o autor, sua utilização é adequada para escrever livros, artigos longos ou informes, sendo as principais funcionalidades:

  • numeração automáticas de equações, teoremas, figuras, tabelas, etc e referências cruzadas destas.
  • gerar múltiplos formatos de saída, como HTML, PDF, EPUB.

E tudo isso com um visual, no mínimo, agradável. O principal estilo é o GitBook.

1.1 Preparativos iniciais

O pacote bookdown pode ser instalado do CRAN ou Github:

Code
install.packages("bookdown")
# or the development version
# devtools::install_github("rstudio/bookdown")

A documentação completa pode ser encontrada em bookdown: Authoring Books and Technical Documents with R Markdown (em inglês)

Além disso, você vai precisar do R RStudio (versão > 1.0.0)

Para compilar em PDF, você precisa do XeLaTeX, que pode ser encontrado junto com o pacote TinyTeX (https://yihui.org/tinytex/).

Um exemplo pode ser encontrado em https://github.com/rstudio/bookdown-demo/ ou para um exemplo mínimo, https://github.com/yihui/bookdown-minimal/.

1.2 Escrevendo um e-book

Um e-book típico contém vários capítulos. Cada arquivo Rmd deve conter um e apenas um capítulo, definido por um título de primeiro nível #.

  • index.Rmd
# Prefácio {-}
  • 01.intro.Rmd
# Introdução {#intro}

Aqui está uma breve apresentação deste e-book.
  • 02.revisao.Rmd
# Revisão de literatura {#revisao}

Aqui está uma revisão do assunto.

## Assunto 1 {#a2}

## Assunto 2 {#a2}

Os arquivos de configuração são escritos na linguagem YAML (https://pt.wikipedia.org/wiki/YAML). São eles: _bookdown.yml (Seção: O arquivo _bookdown.yml), _output.yml (Seção: O arquivo _output.yml). Além disso, mais configurações são adicionadas ao cabeçalho do primeiro arquivo Rmd (index.Rmd) (Seção: O arquivo index.Rmd).