Librebits - jordila_@i-ching:~/

Bits aleatorios de Software Libre / Libre Software ...

Gh-pages : Publicar Sencillamente Muestras De Tu Proyecto

En muchas ocasiones simplemente requieres de una forma sencilla de publicar muestras de un proyecto web ágilmente. O quizás publicar información relativa al mismo (con una demo), o documentación… Conectarse al servidor en el que publicas los trabajos acabados , crear el servidor virtual Apache (Vhost), reiniciarlo….bla,bla. Tedioso.

Para ese viaje no nos hacían falta esas alforjas, Sancho… (diría Don Quijote)

Si usas repositorios de desarrollo web en Github.com, hay una alternativa muy cómoda, una vez uno se ha acostumbrado a trabajar con el flujo git (ver posts anteriores).

La esencia del funcionamiento de gh-pages está en definir una rama (branch) que alojará aquello que queramos publicar asociado al proyecto. Cuando hagamos el

1
$ git push origin gh-pages

correspondiente, Github se encargará de publicarlo, relacionándolo a nuestra cuenta personal(o de organización) en diferentes posibilidades según elijamos en cuanto al nombre de dominio (DNS). Inmediatamente podemos mostrar el resultado al mundo desde él.

No voy a entrar en el detalle operativo, en el mismo Github se ofrece un tutorial y documentación muy ilustrativo de como proceder, paso a paso, acá

Como dicen, simplemente edita, push y tus cambios ya son públicos en Internet.

Oli nos cuenta como adaptar el flujo de trabajo de ambas ramas master y gh-pages de forma síncrona.

Actualmente, por ejemplo, estoy trabajando acá :

https://github.com/jordila/CSS3-Accordion

Aunque probablemente, si transcurre mucho tiempo desde el día de hoy, ese proyecto haya mutado… Así que prueba a ver este,

http://rendro.github.io/CSS3-Accordion

Que es el original, del cual hice el fork . O este otro.

https://blueimp.github.io/Gallery/

De hecho ese mismo mecanismo es en el que se basa la publicación de este Blog que estás leyendo. Uso Octopress. Basado en la tecnología de publicación Jekyll. La misma que usa el propio Github.com para sus páginas.

Bonus : para asociar documentación a un proyecto, recomiendo el uso de la wiki que nos ofrece Github.com. De forma muy cómoda y sencilla podemos ir desarrollándola, también mediante un flujo de trabajo git en formato markdown . El repositorio wiki del proyecto convivirá en paralelo con nuestro código. Siendo ambos distinguibles así, a la hora de clonarlos en tu compu localmente :

1
2
3
4
5
6
7
8
git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.wiki.git    

# clona tu wiki localmente


git clone https://github.com/TU_USUARIO/TU_REPOSITORIO

# clona tu repositorio localmente