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.