Jonathan Samines Web Developer

Sobre la creación de un blog - Instalación de Jekyll

Escribir un blog es algo que siempre había querido hacer, con el paso de los años intenté utilizar varias plataformas, desde las más tradicionales como blogger o wordpress.com, hasta otras más restrictivas como tumblr.

No terminé de conocer ninguna de éstas plataformas y cada uno de los blogs que construí terminaron por morir en el olvido. Las temáticas de estos eran muy diversas ( muy lejos estaba en ése tiempo de tener conocimientos de programación), sin embargo, en el camino aprendí un montón de cosas: desde los principios de html, css, un poco de javascript, xml (rss+atom), configuración de dominios, etc.

El solo hecho de intentar cambiar algo en las plantillas que por defecto disponías te conducía a aprender un poco del tema para no equivocarte y terminar arruinando la plantilla, que les aseguro me pasó más de una vez. Estos primeros intentos, fueron lo que más tarde me llevaron a introducirme al desarrollo web y a aprender todas las habilidades que hoy en día empleo.

Hoy, unos años más tarde, vuelvo a crear un blog. Esta vez en una plataforma un poco diferente, se trata de Jekyll.

Jekyll - Simple, estático y pensado en los blogs

Jekyll

Jekyll a diferencia de otras plataformas de blogging, no requiere de un gestor de contenido para poder trabajar con ella. Como su sitio lo menciona, Jekyll es un generador de sitios estáticos desarrollado en ruby, lo cual quiere decir que lo único que necesitamos para poder utilizarlo es el entorno de desarrollo de ruby y nuestro contenido en un formato reconocible como lo puede ser Markdown o simplemente HTML para generar un sitio totalmente funcional.

A pesar de su simplicidad, Jekyll es lo suficientemente flexible para proporcionarnos componentes comunes a los blogs como los pueden ser : posts, categorías, tags y permalinks.

Instalación de Jekyll

La instalación de Jekyll es bastante sencilla, sobretodo en linux y mac.

Desafortunadamente la instalación en Windows puede volverse en un verdadero problema si no instalamos las herramientas correctas en el orden correcto, para ésta tarea éxisten bastantes tutoriales en internet, sin embargo su información puede ser muy variada y casi siempre desactualizada, por ello les dejó una guía que me tomé la tarea de traducir en la cual se explica este proceso.

Podemos verificar si la instalación fue correcta ejecutando el siguiente comando:

1     $ jekyll --version
2     jekyll 1.5.1

Creación del Sitio

La instalación de jekyll es algo molesta en Windows, pero una vez tengamos instalada la herramienta el resto es bastante sencillo. Vamos a crear un sitio utilizando nuestro recién instalado jekyll:

1     $ jekyll new nombre_sitio

Esta instrucción genera una nueva carpeta con el nombre 'nombre_sitio' sobre nuestra ubicación actual. Ingresemos a nuestro nuevo sitio utilizando :

1     $ cd nombre_sitio

Estando en el directorio 'nombre_sitio', podemos proceder a analizar que fue lo que jekyll hizo por nosotros. Podemos ver una estructura de directorios que cada sitio nuevo genera, la cual debería ser similar a la siguiente :

Estructura de Directorios de Jekyll

  • La carpeta _layouts permite guardar las plantillas que serán utilizadas en todo nuestro sitio.
    • El archivo default.html es la plantilla por defecto del sitio.
    • El archivo post.html es la plantilla por defecto para una publicación.
  • La carpeta _posts se utiliza para guardar cada una de las publicaciones que realicemos.
    • El archivo año-mes-dia-welcome-to-jekyll.md es un archivo generado por jekyll automáticamente como una publicación de prueba.
  • La carpeta css se utiliza para guardar los estilos correspondientes al sitio.

Tambien encontraremos los siguientes archivos:

  • El archivo _config.yml se utiliza para guardar configuraciones que podrán ser utilizadas globalmente por el sitio.
  • El archivo .gitignore es una lista de exclusiones, la cual veremos más adelante.
  • El archivo index.html guarda la plantilla base del sitio.

Ya hemos explorado un poco que es lo que jekyll genera, por lo que podemos probar como hacer funcionar nuestro sitio utilizando la siguiente instrucción:

1     $ jekyll serve
2       Server address: http://0.0.0.0:4000
3       Server running... press ctrl-c to stop.

Tras este paso podemos utiliza nuestra direccion localhost:4000 para poder acceder al sitio. Genial no? con algo tan sencillo tenemos un sitio funcional sin necesidad de necesitar una compleja plataforma de administración!