gitbook - ULL-ESIT-SYTW-1617/practica-despliegues-en-iaas-y-heroku-noejaco2017 GitHub Wiki
Se trata de una herramienta para crear documentación de proyectos y libros técnicos usando Markdown y Git/Github. Entre las numerosas características que nos ofrece podemos destacar:
- Publicar y mantener fácilmente libros online utilizando gitbook.com.
- Ofrece la posibilidad de trabajar desde una aplicación propia.
- Permite incluir ejemplos y ejercicios interactivos.
- Mediante la utilización de Markdown podemos "maquetar" nuestros documentos y crearlos con diferentes formatos: PDF, ebook o web.
Gitbook está implementado usando node.js, podemos instalarlo usando NPM:
npm install gitbook -g
Una vez instalado podemos comenzar a trabajar sobre nuestros archivos en formato Markdown y posteriormente servir dichos archivos cara un repositorio, por ejemplo:
gitbook serve txt ./repositorio
En este ejemplo, txt es el directorio en el que tenemos nuestros archivos Markdown y ./repositorio es donde nos dejará los html.
Una opción muy interesante es servir nuestro libro bajo gh-pages de forma que contenemos nuestro libro exportado en un sitio web fácilmente accesible.