Capítulo 4 Publicación

La “publicación” del libro web puede ser tan simple como subirlo a GitHub (estableciendo antes las opciones que se describen a continuación), aunque también bastaría con subir el contenido de la carpeta de salida _book a cualquier servidor web.

4.1 GitHub Pages

Para poder emplear GitHub Pages habría que cambiar el directorio de salida en el archivo _bookdown.yml:

output_dir: "docs"

Después de generar el libro, crear un fichero .nojekyll (vacio) en el nuevo directorio docs (GitHub procesa los sitios web con Jekyll; e.g. enlace ), para lo que bastaría con ejecutar en la consola file.create('docs/.nojekyll'). Finalmente crear el correspondiente repositorio en GitHub, estableciendo en la configuración de “GitHub Pages” la opción de “Source” como “master branch /docs folder” (p.e. siguiendo estos pasos).

Para ir añadiendo contenido a un sitio en GitHub, se puede emplear por ejemplo RStudio (e.g. R packages by Hadley Wickham) o instalar GitHub Desktop (lo que recomendaría en Windows…).

Más información y alternativas en el libro de bookdown.

4.2 Licencia

Es recomendable incluir una licencia, por ejemplo, este libro está bajo una licencia de Creative Commons Reconocimiento-CompartirIgual 4.0 Internacional. Sin embargo en el libro de Prácticas de Simulación se consideró una licencia Creative Commons Reconocimiento-NoComercial-SinObraDerivada 4.0 Internacional, de forma preliminar.

Se puede incluir la licencia en formato texto en un archivo LICENSE en la raíz del proyecto.