A blogging framework for hackers (Continuación)

Luego de desahogarme en un post anterior, continué investigando y probando opciones de blogs basados en jekyll y GitHub.

La idea es interesante: preparamos los fuentes jekyll del sitio y los post, luego GitHub se encarga de generar el sitio HTML. Los fuentes de posts son archivos HTML con Liquid o Markdown y tenemos total libertad en cuanto a la estructura del sitio y el contenido. Además, no tenemos que lidiar con esos editores de texto online pseudo WYSIWYG ya que trabajamos con archivos de texto y la publicación la realizamos con nuestro sistema de control de versiones preferido: Git.

Intento 1 - Preparar un sitio desde cero

En principio intenté preparar un sitio desde cero, o copiando otros como el de Eric Jones. Dado mi escaso conocimiento de Ruby, Jekyll y Liquid, creo que no fue una buena elección ya que la estructura no resultó la mejor y algunos literales como la URL base del sitio quedaron repartidos por todo el código. De cualquier manera, rescaté la experiencia y unos snippets de código que utilicé luego.

Intento 2 - Octopress

Octopress está muy bien, es muy completo y tiene buena terminación.

Pero, el sitio no es generado por GitHub sino que cuenta con unos scripts para generarlo localmente. Para un blog personal no me parece una mala opción, pero si son muchos los editores, creo que se vuelve un poco más incomodo. Además, perdemos la posibilidad de postear directamente desde GitHub con la feature de crear archivos.

Como en el caso anterior, Octopress será una buena cantera para extraer ejemplos, snippets e ideas para utilizar.

Intento 3 - Jekyll-Bootstrap

Jekyll-Bootstrap resultó ser la opción elegida. Tiene un diseño modular, con templates y helpers. No está tan pulido como Octopress, pero es un buen punto de partida para comenzar a personalizar el sitio.

Mi prueba de concepto

El objetivo era que las mejoras en estilos, templates y layout no se mezclen con la instancia del sitio, de manera de que se puedan utilizar en otros blogs.

Preparé un repositorio Jekyll-Bootstrap-MS, basado en Jekyll-Bootstrap, con algunas modificaciones y adaptaciones. Es aquí donde se deberían realizar las mejoras y personalizaciones de estilos, templates y layout que puedan reutilizarse.

Por otro lado, creé otro repositorio para mi blog personal basado en el anterior. Aquí publicaré mis posts, realizaré cambios puntuales en el layout e ire mergeando las mejoras realizadas en Jekyll-Bootstrap-MS.

Para probar Jekyll-Bootstrap-MS desde GitHub

El branch gh-pages de Jekyll-Bootstrap-MS está publicado en http://makingsense.github.com/jekyll-bootstrap-ms. Es posible realizar un Fork de este repositorio y probarlo con la propia cuenta de GitHub, sin necesidad de descargar nada, utilizando las herramientas provistas por GitHub.

Para probar Jekyll-Bootstrap-MS localmente en Windows

Requistos

Cliente Git

Yo utilizó Git Extensions que ya incluye MINGW y Git Bash.

Instalar de Ruby

Desde Ruby Installer descargar e instalar la última versión de Ruby.
Verificar que Ruby esté en el Path o agregarlo.
También desde Ruby Installer descargar el Development Kit, descomprimirlo.
Desde Git bash ejecutar:

$ cd C:/RubyDevKit
$ ruby dk.rb init
$ ruby dk.rb install

Instalar Python (requerido si hay páginas con resaltado de sintaxis)

Descargar Python 2.7 e instalar
Verificar que Python esté en el Path o agregarlo.

Instalar Jekyll

Desde Git bash instalar Jekyll:

$ gem install jekyll

Descargar Jekyll-Bootstrap-MS

Desde Git bash:

$ git clone https://github.com/MakingSense/jekyll-bootstrap-ms.git

Ejecutar Jekyll

$ cd jekyll-bootstrap-ms
$ jekyll --server

Abrir http://localhost:4000 en el navegador

Pendiente

Algunas posibles mejoras (ver board en trello):

Estaría bien agregar los números de línea en los snippets de código
Definir mejor la estructura por defecto del sitio. Por ejemplo, en lugar de un listado de posts en la página de indice, se podrían mostrar los últimos posts completos y la posibilidad de ver los anteriores.
Link a la página de GitHub de la cuenta asociada al blog.
Link al source en GitHub del post o página actual.
Mejorar la utilización de Twitter Bootstrap, por ejemplo utilizando fluid rows
Personalizar Twitter Bootstrap y los estilos.

Invitación

Creo que este es el motor ideal para un blog de desarrolladores de software. Espero su feedback, críticas, refutaciones, consultas o pull requests en Jekyll-Bootstrap-MS.