gitbook - ULL-ESIT-SYTW-1617/practica-despliegues-en-iaas-y-heroku-noejaco2017 GitHub Wiki

Gitbook

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.

⚠️ **GitHub.com Fallback** ⚠️