Jonathan Samines Web Developer

Del como este blog fue creado - Parte 1

Habiendo hecho varios intentos, despues de haber pasado por varias plataformas por fin he encontrado una plataforma que me permite tener tener el nivel de simplicidad que siempre había querido en una plataforma de blogging. Estoy hablando en este caso de Jekyll, que con la ayuda de Github:Pages nos permitirá obtener una plataforma de blogging bastante robusta, personalizable y sobre todo pensada especialmente para nosotros los desarrolladores.

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

Pues bien como su sitio lo menciona consiste en un generador de sitios estáticos, lo cual quiere decir que no necesita de una plataforma de gestión de contenido para mantenerse, lo único que necesitamos son nuestros contenido en un formato reconcible, como lo puede ser Markdown, Textile o HTML para generar un sitio totalmente funcional.

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

La instalación de Jekyll es bastante sencilla, sobretodo para linux y mac. Sin embargo Windows tiene algunos problemas con su instalación.

Una vez tengamos instalado jekyll en nuestro equipo dispondremos de una herramienta de línea de comandos que nos permitirá crear sitios estáticos. Podemos empezar creando un nuevo sitio utilizando el comando:

jekyll new nombre_sitio
cd nombre_sitio
jekyll build -- compila los archivos generando el sitio final en la carpeta _site
jekyll serve -- inicia un servidor temporal para poder visualizar el sitio (tambien realiza la compilación)

Un sitio generado con esta utilidad, genera la siguiente estructura de directorios.

Directorios

_includes : utilizado para guardar fragmentos repetibles de código.
_layouts : plantillas utilizadas para las páginas generadas.
_posts : utilizado para guardar el contenido de los posts.
_site : sitio generado por la utilidad jekyll build.

Archivos
_config.yml : archivo de configuracion y variables del sitio.

Con un sitio funcionando podemos entrar en detalles con la sintaxis de markdown.

Markdown - Escribir en la web nunca fue tan sencillo

Si bien jekyll nos permite el uso de HTML para poder redactar nuestro contenido, resulta ser un formato bastante inconveniente y complicado para esta tarea. Markdown es un formato de redacción de texto que facilita la tarea de escritura de contenido, permitiendo utilizar bastante de la sintaxis habitual de escritura para la redacción. Veamos algunos de los componentes principales para redactar un documento utilizando markdown:

Encabezados

Los encabezados van predecidos del símbolo # y en la cantidad de acuerdo al nivel del encabezado.

# h1
## h2
### h3
#### h4
##### h5
###### h6

Resulta en :

h1

h2

h3

h4

h5
h6
Párrafos de texto y enlaces

Los parrafos de texto se procesan de la misma forma como fueron escritos. Los enlaces utilizan una sintaxis como la siguiente :

Este es un párrafo de texto común. Acá hay un [link](/path/a/recurso "titulo opcional").

Resulta en :

Este es un párrafo de texto común. Acá hay un link.

Listas ordenadas y desordenadas

Las listas desordenadas se consiguen utilizando los siguientes simbolos \, +, -*, las listas ordenadas utilizando números en lugar de los símbolos con la única limitante de que el primer elemento debe empezar en 1.

Además el orden de los números utilizados no tiene importancia; al final siempre obtendremos el mismo resultado.

+ elemento desordenado 1
+ elemento desordenado 2

1. elemento ordenado 1
2. elemento ordenado 2
8. elemento ordenado 3
3. elemento ordenado 4

Resulta en :

  • elemento desordenado 1
  • elemento desordenado 2
  1. elemento ordenado 1
  2. elemento ordenado 2
  3. elemento ordenado 3
  4. elemento ordenado 4

De esta forma se consigue una sintaxis mucho más sencilla para redactar contenido. Para ver todas las opciones de formato y sintaxis ver el siguiente enlace : Sintaxis de markdown.