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.