Cómo habilitar comentarios en el blog con Giscus
Hoy he añadido un sistema de comentarios al blog basado en Giscus, una herramienta que permite a los lectores comentar los artículos sin que sea necesario que abandonen el sitio.
Blog¶
Un tema visual propio para el blog
La documentación de clase y el blog comparten el mismo sitio MkDocs, pero no tienen por qué tener la misma cara. La documentación usa el tema Material con su paleta azul habitual; el blog, en cambio, está pensado para tener un aspecto más cercano a un diario de desarrollo: tipografía monoespaciada, fondo oscuro opcional y cabeceras al estilo terminal. En este artículo vamos a ver cómo conseguir eso sin tocar el tema global ni romper el comportamiento del sitio al navegar entre secciones.
Nuevo flujo de despliegue: setup_env.py, uv y scripts multiplataforma
Al sistema de publicación de apuntes y recursos se le han aplicado tres novedades: un script de configuración inicial del entorno, migración a uv para gestionar dependencias Python y scripts de despliegue en Python que funcionan en cualquier plataforma sin necesitar bash ni rsync.
Configuración anterior
Hasta ahora preparar el entorno de desarrollo requería ejecutar una serie de comandos git y pip a mano. En Windows había un problema adicional: los scripts de despliegue (deploy.sh, deploy-github.sh) necesitan bash y rsync, herramientas que no vienen de serie.
La solución ha sido crear un script de configuración automática y versiones Python de los scripts de despliegue.
MkDocs: de los apuntes en Markdown a un sitio web publicado
Cuando tenemos apuntes, documentación o recursos en archivos Markdown y queremos publicarlos como un sitio web navegable, MkDocs es una de las herramientas más directas que existen. La idea es sencilla: una carpeta con ficheros .md, un fichero de configuración mínimo y en pocos minutos tenemos un sitio con buscador, navegación lateral y un aspecto profesional. En este artículo vamos a recorrer todo el proceso, desde la instalación en Ubuntu hasta publicar el resultado, pasando por la configuración del tema Material y algunos ajustes que marcan la diferencia.