Lo que he aprendido: wikis, git y Gollum

Cuando el otro día GitLab murió, a Mr Frog y a mí casi nos da un patatús. Tenemos un proyecto conjunto ultrasecreto ahí y durante algunas horas de horror pensamos que habíamos perdido todo. Evidentemente, los archivos del proyecto en sí los teníamos en local pero las Issues y la wiki estaban en peligro. Lo de las Issues era grave porque funcionamos en una especie de test driven development (aunque no sea un tema de programación) pero lo de la wiki era catastrófico, ya que es lo que usamos para documentar el proyecto. Y ya sabéis, la documentación es la vida. En fin, que cuando se solucionó el desastre decidimos hacer copias de todo para evitar el apocalipsis nuclear. 

Aquí es donde entra en juego Gollum. No ese Gollum del tesssoro, sino un cacharro para crear wikis basadas en mi amado git. Resulta que las wikis de Gitlab no son más que un repo como otro cualquiera que se puede clonar y tal. La diferencia es que si queremos jugar con ellas en nuestro ordenador tenemos que usar el mencionado Gollum. Digamos que Gollum es a las wikis lo que Jekyll es a los blogs. 

Veamos como se usa. Lo primero es ver cuáles son los requisitos que debemos cumplir para poder instalarlo. De su docu sabemos que es una gema de Ruby que necesita lo siguiente:

SYSTEM REQUIREMENTS

- Python 2.5+ (2.7.3 recommended)
- Ruby 1.8.7+ (1.9.3 recommended)
- Unix like operating system (OS X, Ubuntu, Debian, and more)
- Will not work on Windows (because of grit)

Como lo tenía todo, lo instalé con:

sudo gem install gollum

Me dio un error al intentar instalarlo porque no tenía ni zlib ni libicu-dev, que solucioné fácilmente con:

sudo apt-get install zlib1g-dev libicu-dev

y volviendo a repetir la orden gem install.

Ahora que ya tenemos Gollum perfectamente instalado, clonamos la wiki como cualquier otro repo:

git clone .../proyecto.wiki.git

Ahora si queremos que nos cree la wiki localmente hacemos simplemente en la carpeta que hemos clonado:

gollum

Nos dirá que podemos ver la wiki y editarla en localhost:4567. También podemos modificar los archivos y commitear desde la terminal.

Me parece una herramienta muy interesante, le daré mucho uso. Espero que a vosotros os guste también 🙂

Referencias

Gollum

GitLab Gollum-lib

Gollum the git-enabled wiki

Gollum por Darcy Moore vía Attribution Engine. Licencia CC BY-NC-SA.
Anuncios

3 pensamientos en “Lo que he aprendido: wikis, git y Gollum

  1. Pingback: En qué ando: primera quincena de febrero | Onda Hostil

¡Opina sin miedo! (Puedes usar Markdown)

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s