Cómo montar un blog para dedicarme a lo importante, escribir.

La finalidad de este artículo es detallar los pasos a seguir para crear un blog como este y tener un entorno de desarrollo en local (Windows) donde poder previsualizar de forma sencilla los artículos antes de publicarlos. Y de esta manera, si cambio de PC, tengo todos los pasos detallados para que mi memoria no sufra, asi que vamos a ello.

Contenido

Requisitos para que todo funcione

Lo descrito en este blog hace referencia a un entorno con Windows instalado. Aunque se detalla la instalación sobre un Ubuntu.

Descargando Ruby y kit de desarrollo utilizados:

Para probar otras versiones ir a la página oficial pero siempre cuidado con que el Development Kit y la versión de Ruby sean compatibles.

Instalando Ruby (Windows)

ruby dk.rb init
ruby dk.rb install

Install dev kit ruby

Instalando Ruby (Ubuntu)

Instalando Jekyll (Windows/Ubuntu)

Desde la misma línea de comandos antes abierta:

Creando el blog

La manera más sencilla de crear nuestro blog es partir de uno ya existente y usarlo como base para luego personalizarlo a nuestro gusto. Aquí tenéis una lista de temas de blogs Jekyll. Jekyll themes
¡NOTA! En este articulo los ejemplos son sobre el repositorio de este mismo blog. Donde ya está configurada y adaptada la plantilla. Si elijes otra plantilla tendrás que instalar los paquetes gem que necesite y revisar la configuración.

Preparando el repositorio

Lo más importante, es tener cuenta en GitHub. Si no la tienes créala. GitHub Será nuestro repositorio y a la vez nuestro hosting. Todo de forma gratuita y libre. Con tu cuenta creada, inicia sesión y te doy 2 opciones:

Preparando entorno

Tenéis que tener instalado el tooling de Git en vuestra máquina. Mas info aquí

Configurando el blog

Abre el fichero _config.yml con tu editor favorito. Debemos configurar:
url: http://username.github.io
baseurl: http://username.github.io/
repository: username/username.github.io
userdisqus: usuario de la plataforma disqus para los comentarios ver más abajo

Y personalizaremos las propiedades:
title
tagline
description
author
name
twitter

Compilando y arrancando en local

Llegados a este punto únicamente tendrás que ejecutar el siguiente comando sobre la carpeta de trabajo:

bundle exec jekyll serve -w --config "_config.yml,_config_dev.yml"

Si no hay errores se ejecutará un servidor web sobre el puerto 4000 y ya podremos navegar a la url http://127.0.0.1:4000 Start jekyll

¡Y ya tenemos nuestro blog en local!

Publicando y viendo la magia de GitHubPages

Cuando ya tengamos creado un nuevo articulo la magia de publicarlo en la web es de GitHubPages. Solamente nos encargamos de hacer commit y push de los cambios hacia el repositorio.

git add .
git commit -m "siempre un comentario"
git push origin master

¡Así de fácil!

Configurando comentarios.

Para que los visitantes puedan dejar comentarios en post utilizamos la plataforma disqus.com que ya se encuentra instalada en esta plantilla. Crea una cuenta en Disqus y dar de alta tu blog. Luego configura en el fichero _config.yml el parámetro userdisqus con el usuario que has dado de alta.

Trabajando más cómodo con VS Code.

Este repositorio se encuentra ya configurado para trabajar con Visual Studio Code de una forma más rápida y cómoda. La carpeta .vscode tiene definida los ficheros que automatizan para la compilación y lanzar el navegador. Estos son los atajos de teclado:

Configuración en Local/Dev y en Producción

En este repositorio hay creados dos ficheros de configuración:

Guía para agregar nuevos artículos

Abrimos la carpeta de trabajo con el editor Visual Studio Code (puedes usar el que más te guste).
De la estructura del blog debemos de saber lo básico y seguir unas reglas para no generar desorden. Enumero las siguientes:

Bonus: más comandos jekyll

bundle exec jekyll serve -w –drafts
Ejecuta incluyendo los archivos en carpeta _drafts bundle exec jekyll serve -w –config “_config.yml,_config_dev.yml”
Ejecuta incluyendo los archivos en carpeta _drafts


Comparte esto: