Taxonomía de tags, highlighting de código y analítica

por Asur Bernardo

Seguimos adelante, esta vez avanzo un poco más con el interlinking creando una taxonomía de tags, además de server-side code highlighting y he montado todo lo necesario para recopilar datos y analizarlos con Cloudflare, Google Analytics y Search Console, además de un pequeño análisis de lo más interesante de cada uno.

Tabla de contenidos:

Highlighting de código ✨

Desde un principio esta funcionalidad ha estado en el punto de mira, me encanta escribir snippets en mis posts, porque talk is cheap, show me the code es un mantra con el que me identifico y me gusta ir de hardcore programmer.

Me encanta como está implementado esto en Hugo, se puede considerar server-side highlighting, ya que a la hora de compilar tu contenido a HTML se utiliza Chroma, una librería escrita en Go que analiza y aplica markup a tus snippets y luego a través de CSS puedes darles estilos.

En mi opinión esto es un acercamiento mucho más óptimo que al highlight en el cliente, como el de highlight.js ya que además de no ocupar tiempo en el hilo de javascript analizando texto al vuelo, no habrá ningún parpadeo en el que el código salga sin estilos.

Para resaltar un trozo de código a la hora de escribir contenido tengo que usar un shortcode nativo de Hugo:

{{< highlight php "linenos=table" >}}

<?php

// ... code

function foo() {
    $bar = 'string';
}

{{< /highlight >}}

Que se verá de la siguiente manera:

1
2
3
4
5
6
7
<?php

// ... code

function foo() {
    $bar = 'string';
}

Uno de mis objetivos era que se pudiese copiar y pegar el código resaltado sin incluir los números de línea, algo que pasa muy a menudo en muchas webs y me saca de quicio. Para hacerlo posible hay que incluir el atributo "linenos=table" al shortcode, de esta forma se utilizarán tablas HTML al maquetar la estructura de código y sus líneas independientemente, en vez de solo insertar un número al principio de estas últimas.

Como detalle final, la librería de Chroma es compatible con los temas de Pygments, otra librería similar pero escrita en Python, y esto abre un abanico enorme de combinaciones de colores. Yo me he decantado por el tema Github, como no… Para aplicarlo tenemos que habilitar en la configuración de nuestro sitio pygmentsUseClasses = true e incluir el CSS generado por el comando hugo gen chromastyles --style=github > syntax.css a nuestro fichero de estilos.

Taxonomía de tags 🏷️

Las taxonomías son maneras de agrupar elementos por características comunes. La primera implementación que voy a hacer al respecto es la de tags. Es una estrategia muy común a la hora de crear una estructura de links para SEO, también ayudará, por supuesto, a los usuarios a encontrar contenido que les interese más fácilmente.

Hugo ya incluye por defecto dos taxonomías: tags y categorías, además de poder crear las tuyas propias. He empezado por tags por mera comodidad, creo que las categorías las dejaré para cuando implemente unas migas de pan y lo haré todo junto.

La implementación, al estar ya soportado, no tiene mucha miga, para empezar añadimos las tags en la metadata del post de turno:

tags = ['Evolutivo', 'Data', 'Hugo']

Una vez tenemos los datos, pasan a formar parte del objeto del post y los podemos listar, como se puede ver encima del título de este post:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{{ $taxonomy := "tags" }}
<ul id="{{ $taxonomy }}">
    <li>Tags:</li>
    {{ range .Param $taxonomy }}
        {{ $name := . }}
        {{ with $.Site.GetPage (printf "/%s/%s" $taxonomy ($name | urlize)) }}
            <li><a href="{{ .Permalink }}">{{ $name }}</a></li>
        {{ end }}
    {{ end }}
</ul>

Por último tenemos que crear una plantilla para las páginas de taxonomía. Es obligatorio que se llame taxonomy.html y es lo que se renderizará cuando se navegue al link que tiene cada tag. Ya tenemos accesibles todas las entradas pertenecientes a esa tag, por lo que el código se parece mucho al de la homepage, un título (que será el nombre de la tag) y un bucle para imprimir los links:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{{ define "main" }}
  <div>
    <h1>{{ .Title }}</h1>
    <ul>
        {{ range .Pages }}
            <li>
                <a href="{{ .Permalink }}">
                    {{.PublishDate.Format "02-01-2006"}} | {{ .Title }}
                </a>
            </li>
        {{ end }}
    </ul>
  </div>
{{ end }}

Finiquitado, ya tenemos una taxonomía básica montada y la estructura básica para añadir más en el futuro!

Analítica 📊

Soy un nerd para los números, no tengo ni idea de análisis ni representación de datos pero me encanta mirar gráficas, por lo que la parte de analítica iba a llegar más pronto que tarde. Por el momento he decidido utilizar tres fuentes de datos: Google Analytics, Search console y Cloudflare.

Google Analytics

Google Analytics es una navaja suiza, con el conocimiento suficiente que espero ir adquiriendo con el tiempo puedes hacer prácticamente lo que quieras en lo que recolección de datos se refiere.

Para añadirlo en una página AMP tenemos que usar el componente amp-analytics de la siguiente manera:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
<amp-analytics type="gtag" data-credentials="include">
  <script type="application/json">
    {
      "vars": {
        "gtag_id": "UA-128498798-1",
        "config": {
          "UA-128498798-1": { "groups": "default" }
        }
      },
      "triggers": {
        "trackPageview": {
          "on": "visible",
          "request": "pageview"
        }
      }
    }
  </script>
</amp-analytics>

Los datos que más me interesan son:

Usuarios y sesiones: De manera general puedo ver la cantidad de usuarios y sesiones de la web, así como el porcentaje de rebote y las páginas visitadas por cada sesión.

Adquisición: También me gusta ver como han llegado los usuarios al sitio y la diferencia de calidad de los diferentes tipos.

Tiempo en página de posts: Una vista algo más atómica de como están funcionando cada uno de los posts, para posteriormente poder analizarlo e iterar.

Por supuesto hay muchos más datos, como demográfica y flujos de navegación pero no me interesan tanto en la fase actual en la que está el blog, en un futuro quizás los revisite.

Search console

Search console te muestra datos de la indexación de tu web en Google, así como las mejoras manuales que ha detectado en tu web.

El proceso de validación es a través de DNS, lo único que hay que añadir es un registro TXT con el contenido que se nos indica al registrarnos y listo, ya tenemos acceso.

Type  | Name              | Content                         | TTL
------|-------------------|---------------------------------|------
TXT   | asurbernardo.com  | google-site-verification=drV... | 5 min

Las partes a las que prestaré más atención son:

Rendimiento: Las veces que aparecen una página de esta web en Google listada, en que posición y que CTR tiene.

Cobertura: Información sobre como está indexado este site en Google, las páginas correctas y los posibles errores.

Mejoras: Todas las señales que indican a Google la calidad de la página más allá del contenido, como datos estructurados, AMP, etc.

Cloudflare

Con Cloudflare no he tenido que hacer nada, ya estaba montado desde el principio como proxy de esta web, pero sigue teniendo una parte de analítica muy interesante, que está más orientada a los datos técnicos y son mucho más crudos que en el resto de plataformas ya que son recaudados a nivel DNS y proxy.

Las partes más interesantes son:

Requests: Esto es más por curiosidad que otra cosa, al final el ancho de banda consumido y los hits cacheados le concierne a Github, no a mí, pero aún así me encanta saberlo.

Datos técnicos: Ver que porcentaje de uso de http/2, la cantidad de datos ahorrados por la compresión gzip y la descomposición de como se usa el ancho de banda, de nuevo, no es que sea imprescindible pero puede dar información relavante dependiendo del contexto, y qué mejor manera de hacerlo que en forma de quesitos?

Siguientes pasos 👣

Para el siguiente evolutivo ya tengo bastante claro en que va a consistir, ya he empezado a trabajar (con ayuda) en una mejora del workflow de desarrollo y redacción de contenido, vamos a crear un flujo con Docker, docker-compose y Makefiles, además también me voy a apuntar a la beta abierta de Github Actions y haremos algo de despliegue continuo. Stay tuned! 😎

Wayback Machine ⏰

Ver la versión original de este post.

Asur Bernardo

Back end developer sin ningún tipo de gusto estético. Me encanta la programación, el cacharreo y la tecnología en general. Siempre intento aprender cosas nuevas.

¡Si te ha gustado comparte y comenta!

Load more