Comentarios estáticos para una sección sin dependencia externa

Fuentes: My comment section is static HTML

Este blog integra sus comentarios directamente en el HTML generado por Hugo, de modo que la lectura no requiere JavaScript, widgets, iframes, rastreadores, cookies ni peticiones a servicios de terceros. Al publicar una entrada, el sitio realiza una llamada API a Popsicle Boat, un servidor Phoenix, para crear un hilo asociado y guardar su dirección en los metadatos del artículo.

Durante la compilación, Hugo descarga el archivo replies.json de cada hilo, genera los comentarios como HTML y limita la profundidad de las respuestas. Si el servidor no está disponible, la compilación continúa y la página se publica sin los comentarios nuevos. Esta separación permite que una caída del sistema de comentarios no interrumpa la generación ni la lectura del blog.

Para escribir, la página muestra un formulario HTML tradicional que envía el mensaje mediante POST. Popsicle Boat gestiona el inicio de sesión, la confirmación, un honeypot, comprobaciones del tiempo de envío, límites de frecuencia y otras medidas contra bots y spam. Tras aceptar un comentario, el servidor activa un gancho de compilación; aproximadamente un minuto después, Hugo incorpora el mensaje a una nueva versión de la página y el navegador puede actualizarla.

La arquitectura sacrifica inmediatez y exige una cuenta para comentar. Además, si el servidor falla durante una compilación, los comentarios recientes no aparecen hasta el siguiente proceso. A cambio, conserva las conversaciones dentro de las páginas generadas, reduce la dependencia de terceros y mantiene operativo el blog cuando el servicio de comentarios está caído. El autor también documenta una API para crear hilos, obtener respuestas y conectar un gancho de compilación.