---
title: "Uso del paquete `bookdown` para tejedores"
author: "00Rteam"
date: "`r Sys.Date()`"
site: bookdown::bookdown_site
documentclass: book
bibliography: [book.bib, packages.bib]
biblio-style: apalike
link-citations: yes
description: "Introducción al uso y explotación del paquete `bookdown` de Yihui Xie en la elaboración de memorias y proyectos"
---


```{r, echo=FALSE}
library( knitr )
knitr::opts_chunk$set( echo = FALSE, comment = "" )
```

# Para empezar

Este documento está destinado a aquellas personas 
que conocen y usan rmardown con Rstudio y
se enfrentan a la elaboración de una memoria para un proyecto, una tesis, ...

Puedes encontrarlo en este enlace, [`gauss.inf.um.es/00Rteam/scidoc`][scidocWeb],
donde se irá actualizando en la medida de lo posible.

Abordaremos los distintos aspectos que preocupan a un autor novato:
cuestiones de estilo, recomendaciones,
organización de capítulos,
referencias cruzadas,
tablas, figuras, fórmulas,
bibliografía, ...


[sciDocWeb]: http://gauss.inf.um.es/00Rteam/scidoc

## Paquetes imprescindibles

Asumimos que ya has instalado en tu ordenador
R y dispones de LaTeX. Ademas,
ya has instalado todos los paquetes necesarios 
para tejer documentos con **`knitr`**, ahora
solo falta el paquete **`bookdown`**,
puedes instalarlo desde:

1. tu _mirror_ más querido de CRAN

    ```{r eval=FALSE}
    install.packages( "bookdown" )
    ```

2.  Github, si desea la versión en desarrollo 
    más reciente:

    ```{r eval=FALSE}
    devtools::install_github( "rstudio/bookdown" )
    ```

## Versión de Rstudio

La versión actual permite trabajar sin problemas
con el paquete **`bookdown`**, pero puedes
instalar una versión _testing_, 1.1.x
---no recomendada para uso general---
que te facilitará el familiarizarte con
el paquete. Descargarlo desde
[`dailies.rstudio.com`][rsdailies].

[rsdailies]: https://dailies.rstudio.com/

## ¿Cómo empiezo?

El autor del paquete, @xie2016, ha creado un manual
_bookdown: Authoring Books and Technical Documents with R Markdown_
cuya lectura recomendamos encarecidamente.

Como ya sabes al iniciar un documento `.Rmd`,
al igual que en otros casos,
Rstudio genera un ejemplo sobre el que
empezar a trabajar.
En el caso de un proyecto **`bookdown`**
son necesarios varios ficheros, por ello
en la versión estable de Rstudio necesitas copiar
un proyecto de ejemplo, si bien, en la
versión _testing_ se ha implementado la
generación completa de un proyecto base.

Puedes encontrar "A Minimal Book Example" [@xie2015]
un ejemplo base en la página [`bookdown.org`][bdweb],
donde, además, puedes publicar tu propio proyecto
y leer (descargar) varios libros creados
con **`bookdown`**.
Para descargar un fichero con el proyecto
utiliza este enlace: 
[github.com/rstudio/bookdown-demo][minimalEx],
clica sobre el botón verde `Clone or download` 
y descarga el `zip` o clona el proyecto si
eres conocedor de `git`.

[bdweb]: https://bookdown.org/
[minimalEx]: https://github.com/rstudio/bookdown-demo

Si ya tienes el proyecto de ejemplo accesible desde
rstudio: 

1. ábrelo
2. clica may+crt+B
3. ya tienes una versión "legible" del ejemplo
4. modifica, experimenta y juega
