Initial commit

February 25, 2016 hexo blogging

Hoy quería retomar la idea de tener mi própio blog para escribir sobre distintas ideas y quizás ir desarrollando algunas de ellas. Ya alguna vez hice mi blog en blogspot, pero me duró poco la emoción. La necesidad de conectarme para escribir no me resultaba cómodo. Hace un tiempo vi una charla donde mostraban un blog hecho en Markdown y que al pushear el código a un repositorio git, el blog se actualizaba. Eso es lo que necesito, pero al no recordar el blog decidí buscar un poco por internet a ver qué encontraba.

Luego de mirar varios motores de templates para blogs me llamó la atención Hexo y decidí probarlo. Otra opción bastante interesante es Rho, pero por el momento voy a probar esta aplicación.

Los requisitos que busqué son:

  1. Que sea Open Source
  2. Que tenga sintaxis Markdown
  3. Que soporte control de versiones (de preferencia Git)
  4. Que pueda deployarse fácilmente
  5. Que sea lindo (que ya venga con temas suma)
  6. Que soporte LaTeX

Comenzando con Hexo

El comienzo es bastante simple como lo explica en su página:

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

Al iniciar el server lo primero que noto es que el tema por defecto no es muy atractivo y tiene algunas cosas en chino (gracias Google Translate por detectar el idioma), así que decidí buscar uno entre los disponibles. El que me gustó fue Again pero luego de mirar la página de ejemplo me asusté pensando que iba a instalar otro tema en chino, pero viendo un poco el código del tema, descubrí que es fácil de configurar editando su archivo de configuración, así que puse manos a la obra, pero luego de ver como quedó mi blog, me desilusioné.

Pasé a buscar otros temas, los vi todos creo y me quedé con 2: spfk y tranquilpeak. Sigo probando, pero vamos a como instalar los temas:

Instalando y configurando el nuevo tema:

  1. Descargar el código del tema en la carpeta themes:

    git clone <git-url> themes/<theme-name>
  2. Instalar las dependencias necesarias (si hay alguna)

  3. Editar el theme en el archivo config.yml

    theme: <theme-name>
  4. Reiniciar el servidor

Luego de probar varios temas creo que me quedo con tranquilpeak, en principio por contar con buena documentación, pero la instalación del tema fue un poquito diferente a otros porque el código en github es para hacer el build del tema. Para empezar descargué el tema ya buildeado que provee el desarrollador.

Luego tuve que crear las páginas que no andaban por defecto y configurar algunas variables (unas cuantas). Pero después de una media hora está casi todo listo.

Generando el blog

El blog en modo desarrollo se ve bien, pero para producción Hexo permite generar una versión estática del mismo con el comando hexo generate. Lo que hace es generar el blog en una carpeta public que debería ser subida a nuestro servidor web.

Deploy

Finalmente para deployar tiene un comando deploy. Instalé el plugin para deployar con rsync para mi caso particular y si estás leyendo esto es porque anduvo bien. Está configurado con un nginx como servidor http.

Recuperación de viejas entradas de blog

Para terminar el día, encontré que podía importar mis viejas entradas de blog en blogger! Creo que es más que suficiente por hoy.


Profile picture

Written by Gastón Fournier Software Engineer at @getunleash working from Cunit, Tarragona, Spain, where I live with my wife and 2 dogs. Find me on Twitter Github LinkedIn