Este es un nuevo espacio dedicado exclusivamente a los temas técnicos. Para mis divagues sobre motos, libros, viajes y demás, sigue funcionando el sitio normal de cerodriguez, así que veremos qué sale, ya que hace rato que no escribo sobre temas técnicos.

Para arrancar, y a modo de empezar con algo simple, vamos con la presentación del blog. El sitio es estático, es decir, genero todos los html en mi computadora y los subo al servidor web. Para hacer esto de una manera decente (sin meter mano archivo por archivo), estoy usando Hugo y escribiendo en el editor de texto usando markdown para el formato.

Por qué uso Hugo? Por simplicidad ante todo. Es un solo ejecutable, sin dependencias a instalar y que cumple con mis espectativas, que de momento no pueden ser más simples. Escribir post y publicar. Para ello, primero hice que Hugo creara una estructura básica en blanco: hugo new site ./programador.

Con esto ya tengo la estructura básica para empezar a escribir, solamente agregé a la carpeta themes uno que me gustó de los ya existentes en el sitio github para que se vea bonito y a escribir archivos de texto en la carpeta content generando post.

Todavía me falta entender bastante cómo funciona Hugo, ya que todavía no tengo muy en claro muchas opciones, pero para arrancar ya es bastante. Ahora solamente tengo que hacer hugo para que en la carpeta public tenga todo el sitio creado listo para subirlo al servidor.

Si quiero ver cómo está quedando el sitio final, ejecuto desde la línea de comando hugo server y se ejecutará un servidor web que vía http://localhost:1313 me muestra el sitio funcionando completo.

Como se ve, usarlo es muy fácil y para probarlo no hace falta instalar ninguna librería adicional. Solo descargar el binario y ejecutarlo.

Algunas notas sobre el uso

El formato de una entrada es un archivo escrito en formato markdown, con el siguiente encabezado

+++
date        = "2015-05-26"
title       = "Sitio Nuevo"
description = "Detalles sobre este nuevo sitio"
tags        = [ "general", "web", "hugo"]
slug        = "sitionuevo"
author      = "Magoo"
+++

Contenido de la entrada...

En el encabezado se pueden agregar o quitar parámetros, incluso con la intrucción hugo new ./sitionuevo.md se crea el archivo sitionuevo.md con algunos de los campos ya escritos (por ejemplo la fecha y hora). La forma de crear los archivos en blanco sobre los cuales se escribirá queda a gusto de cada uno, ya que no hay que olvidarse que estamos trabajando con archivos de texto, así que tenemos bastantes libertades sobre su generación.

Algunos de los themes del repositorio necesitan respetar cierta configuración en la generación de las entradas y las categorías así que si al momento de descargarlo y tratar de usarlo no se ve la información en forma correcta, es probable que tengamos que ir al archivo README.md para ver si no nos está faltando configurar algo o declarar algún parámetro.

El archivo de configuración que genera al crear la estructura en blanco con hugo new site ./rutaAlSitioEnDisco es bastante básico y completo. Leyendo un poco la configuración se pueden agregar parámetros.

Actualmente, mi archivo de configuración config.toml es:

theme = "purehugo" 
baseurl = "http://www.programador.com.ar/"
languageCode = "es-AR"
title = "Magoo Carlos Enrique Rodriguez"
uglyUrls = false 
verbose = true 
verboseLog = true 
watch = false 
paginate = 5
paginatePath = "page"

[params]
  description = "Un programador"
  twitter = "magooracss"
  github = "magooracss" 
  

Con el tiempo voy a investigar más en la configuración y los manejos de código en el theme de Hugo, ya que actualmente estoy más que contento con esta forma de generar contenido para la web.