Creación del blog usando R Markdown y Github Pages

Los detalles de todo el proceso seguido los podéis encontrar aquí. Claramente este es el paso más extenso y con más cambios. Incluía además de la creación de la estructura básica del blog, toda la migración desde el servicio anterior.

El proceso de aprendizaje de esta tecnología, la parte básica, no fue muy complicada a decir verdad. También es cierto que me falta mucho por aprender, y aunque he profundizado algo más, al menos cuanto necesito para cumplir mis objetivos, aun me queda mucho para dominar esta tecnología.

Eliminar Disqus como gestor de comentarios

Esto se llevó a cabo por los motivos ya mencionados en la entrada que da comienzo al proceso de renovación. Este paso incluye, claro, añadir como gestor de comentarios a Github Issues. Podéis encontrar referencias a este cambio aquí.

Seis meses sin cambios

Como apunte cómico, un descanso de seis meses nunca viene mal. Supongo que en algún momento me cansé del estado y de cómo estaba hecho el blog y me puse manos a la obra con algunas nuevas ideas.

Eliminar generación dinámica usando JavaScript

Como ya comenté en esta entrada, el blog se terminaba de generar dinámicamente en el dispositivo de cada usuario usando código JavaScript. Como ya se menciona ahí, esto tiene diversos problemas que ya se han solucionado.

En esta fase me tiré a la piscina con las plantillas de R Markdown, básicamente porque era necesario tocar directamente la compilación del blog para generar todo el código en ese momento. Estos cambios trajeron un aumento de velocidad de carga bastante interesante.

Aquí también se incluyó toda la información de las entradas en un único lugar. Ahora todo está mucho más claro y ordenado.

La navegación entre entradas es otro punto que también se llevó a cabo en esta fase. Antes, cada entrada realizaba cálculos en JavaScript para determinar cuál era su anterior y siguiente. Esto era más lento y no compatible para todos los dispositivos. Ahora, este cálculo se realiza también durante la compilación. Se calcula una sola vez, todo está incluido en el código HTML y es compatible con cualquier configuración del navegador.

Estos cambios traen más beneficios a parte de la velocidad. Ahora los buscadores encuentran enlaces funcionales que van a otros artículos del blog en lugar de código JavaScript que ellos no ejecutan. Esto mejora las conexiones internas del blog drásticamente, ya que antes la única página que relacionaba las entradas era la principal.

Relacionar las entradas

Continuando con las relaciones y los cambios hechos en la fase anterior, en esta fase apliqué una idea que me venía rondando la cabeza desde hacía bastante tiempo: la relación de entradas. Todo el proceso está explicado aquí.

A fin de cuentas, se trata de darle significado semántico a cada entrada, creando grupos y enlaces entre ellas de forma más o menos automática. Todos estos enlaces también se crean en tiempo de compilación, de forma que es una característica inmediata a la hora de visualizar el blog. Esta característica mejora de nuevo las relaciones internas del blog, y como he mencionado ya aumenta la semántica de cada entrada.

Ya he aplicado esta tecnología en el boceto de wiki disponible en Project Creation FX. En este otro caso se utilizan distintas relaciones y propiedades para que la función de relación ofrezca toda la potencia que puede dar.

Añadir el fichero sitemap.xml

Es posible que debería haber conocido la necesidad de disponer de este fichero en la raíz del alojamiento, pero a decir verdad no he sabido de su importancia hasta hace unas semanas.

Este paso es, básicamente, la generación del fichero y la subida del mismo al repositorio. No tiene mucha más relevancia. Al parecer, este fichero ayuda a los buscadores a localizar todas las páginas que son accesibles, pues es, a fin de cuentas, un mapa del sitio web.

La generación del fichero se puede automatizar si se usa GitHub Pages, como es el caso. Bastan con crear el fichero _config.yml en la raiz del repositorio con el siguiente contenido:

plugins:
  - jekyll-sitemap

GitHub se encarga del resto. El fichero no será visible en el repositorio, pero si se accede a la URL correspondiente, se debería poder ver el contenido del mismo sin problemas.

Ajustes finales

En este fase se incluyen diversos cambios de estilos y modificaciones menos importantes. Las listo a continuación para haceros una idea de todo lo que se ha ido tocado:

• Cambios menores en el estilo general de la página
• Mejorar la aplicación de los estilos
• Actualización del pie de página
• Añadir correos electrónicos con dominio personalizado en las secciones de contacto
• Añadir títulos de las entradas siguiente y anterior en forma de tooltip

Estos han sido todos los cambios que se han realizado en este proceso de actualización. Ya se ha mencionado que es posible que se incluya alguna que otra características o cambio, pero por el momento no hay nada programado. El camino desde Blogger al punto en el que nos encontramos no ha sido corto precisamente, pero nos ha servido para aprender bastantes cosas nuevas y poner en práctica muchas ideas.

Como punto positivo, he de decir que me alegra haber terminado este pequeño proyecto antes de fin de año, de forma que ahora hay sitio para nuevas ideas. Es muy posible que comencemos una nueva serie pronto con nuevas tecnologías.

También tengo pendiente la creación de un nuevo sitio web estático, y además Project Creation FX (tanto el proyecto como el sitio web) sigue teniendo bastantes horas de trabajo por delante. Todavía tengo que crear la versión 1.0 del proyecto y terminar algunas páginas más del sitio web para poder decir que la primera versión está terminada.

Parece que comenzaremos el nuevo año con bastantes ideas nuevas y otras tantas en proceso. Eso no puede ser malo, siempre está bien estar ocupado.

Hasta la próxima entrada,
Lázarus Surazal