Publicando um e-book com o bookdown
2022-11-09
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
).