El tener un blog es algo que nos puede aportar muchos beneficios, expresando nuestras ideas, compartiendo experiencias, aportando conocimiento y un sin fin de cosas más. Tenemos muchas formas de crear un blog, ya sea sufriendo (haciendo todo) o usando alguna herramienta que nos facilite esto como Ghost o WordPress.
Una buena forma de hacerlo es usando Jekyll el cuál nos va a ayudar a generar sitios estáticos, tomando archivos como MarkDown o Textile y convirtiéndolos en un artículo listo para publicar, lo mejor de usar Jekyll es que podemos tenerlo en los servidores de Github Pages gratis.
Requisitos:
Instalar Jekyll es muy fácil, pero antes de empezar necesitamos tener:
Instalación:
Una vez que tenemos Ruby instalado, abrimos la terminal o CMD y ejecutamos:
$ gem install jekyll
Para verificar que tenemos Jekyll instalado usamos el comando:
$ jekyll -v
Si nos regresa la versión, quiere decir que todo esta bien.
Primeros pasos:
Ya que tenemos todo listo, vamos a empezar con la parte divertida, para crear el blog usamos jekyll new y el nombre.
$ jekyll new miblog
Una vez hecho esto, vamos a tener una nueva carpeta con una serie de archivos que ya vienen por default, depende de nosotros si trabajamos con ellos o no.
.
|-- _config.yml
|-- _layouts
|-- _posts
|-- _site
|-- css
index.html
Para iniciar el servidor de Jekyll usamos el comando:
$ jekyll serve
Si queremos se actualicen los cambios automáticamente cada vez que cambiamos algo en el blog usamos:
$ jekyll serve --watch
Todo es en el puerto 4000 así que entramos en: http://localhost:4000.
Estructura:
Un blog básico con Jekyll generalmente se ve de esta forma:
.
├── _config.yml
├── _drafts
├ ├── borrador.textile
├ └── borrador.markdown
├── _includes
├ ├── footer.html
├ └── header.html
├── _layouts
├ ├── default.html
├ └── post.html
├── _posts
├ ├── 2015-11-02-primer-post.markdown
├ └── 2015-11-03-segundo-post.markdown
├── _site
└── index.html
_config.yml: Aquí es toda la configuración de nuestro blog, podemos especifica desde el nombre del blog, hasta el host y todo lo que nosotros queramos agregar.
_drafts: Como su nombre lo dice, son simples borradores que aún estamos escribiendo y no es necesariamente que no queremos que se publiquen aún.
_includes: Aquí vamos a tener una especie templates que usaremos para poner en nuestro blog como un header o un footer.
_layouts: Son templates que usaremos para nuestros artículos .
_posts: Aquí es donde guardaremos todos nuestros artículos, escritos en MarkDown o Textile los cuales va a ser compilados en la carpeta _site.
_site: Como mencione antes aquí es donde se colocara nuestros artículos compilados.
index.html: Archivo raíz de nuestro sitio.
Igual vamos a tener otra serie de carpetas como css o images en donde obviamente vamos a tener nuestros estilos y archivos que nosotros necesitemos agregar.
Nuestro primer artículo:
Antes de empezar a escribir nuestro artículo primero definimos algunas cosas como el nombre y fecha, de la siguiente forma:
---
layout: post
title: "Bienvendido"
date: 2015-11-02 19:51:01 -0600
categories: Bienvenida
---
Esto lo ponemos al inicio de nuestro artículo
Ya que tenemos esto, podemos escribir nuestro artículo, un ejemplo sencillo seria de la siguiente manera:
---
layout: post
title: "Bienvendido"
date: 2015-11-02 19:51:01 -0600
categories: Bienvenida
---
Bienvenido a un ejemplo de un artículo con **Jekyll**, con `MarkDown` tienes un montón de opciones para tus artículos como:
* Texto en negritas: **Texto**
* Texto en enfatizado: *Texto*
* Código: `Código`
* Notas:
> Ejemplo de una nota
* Enlaces:
[Fili Santillán](http://filisantillan.com/)
y mucho más...
El cual se vería de la siguiente forma:
Finalmente, guardamos nuestros artículos, que tienen que estar en la carpeta de _posts y de la siguiente forma:
YYYY-MM-DD-Nombre-del-articulo.markdown
2015-11-03-mi-primer-articulo.markdown
Jekyll es una excelente forma de compartir nuestras experiencias y conocimiento de una forma sencilla para los que estamos familiarizados en trabajar con HTML, CSS y JavaScript además de que contamos con Github Pages para publicar todo de forma gratuita y sencilla.
Ahora ya no hay excusas para no compartir lo que sabemos, nuestras experiencias, conocimiento y así fortalecer el contenido en español.
¡Adelante!, escribe algo hoy e inicia en este maravilloso mundo del blogging.