Justificativa

• A atividade acadêmica exige produção de documentos longos: TCC, Dissertação, Tese, Livros, etc.
• A editoração de tais documentos é complexa, principalmente se envolve vários autores.
• Editoração baseada em markdown traz muitos benefícios: portabilidade, facilidade para correções, fácil leitura do código fonte.

Objetivos

• Mostrar como autorar livros usando o pacote bookdown.

Sobre

• bookdown: acesso a documentação online.
• Feito por Yihui Xie, autor do knitr, animation, colaborador no rmarkdown, etc.
• Primeira versão no CRAN foi a 0.1 em 2017-08-22.
• Versão atual no CRAN é a 0.5.
• Versão no GitHub é a 0.7.8.

Funcionamento

1. Coleção de arquivos Rmd formam os capítulos.
2. ./_bookdown.yml: Configura aspectos da aparência e compilação do bookdown. Serve para executar scripts, internacionalização de termos e configurar aparência de elementos no final.
3. _output.yml: Passa parâmetros para o pacote bookdown e para o pandoc que definem a classe de documento, detalhes de execução e aspectos sobre a aparência (css, templates, etc).
4. index.Rmd: Define metadados do documento (autor, título, url, csl, etc).
5. Para gerar o documento, chamar a função bookdown::render_book().

Tipos de documentos

• pdf_book: Livro baseado em LaTeX, portanto, em PDF.
• html_book: Livro em HTML. Tem poucos recursos.
• gitbook: Livro em HTML. Contém recursos para navegação nas seções, troca de fonte e cores para melhor leitura. É o formato usado para hospedar livro na web.
  • https://bookdown.org/yihui/bookdown/
  • https://bookdown.org/yihui/bookdown-demo/.
  • http://r4ds.had.co.nz/.
  • https://bookdown.org/yihui/blogdown/.
  • https://www.tidytextmining.com/.
  • http://cursos.leg.ufpr.br/rmcd/.

Criando o primeiro documento bookdown

1. Faça uma cópia do repositório https://github.com/rstudio/bookdown-demo.
2. Execute bookdown::render_book().
3. Modifique e repita.

• Sites com blogdown.