Hace unos años añadí comentarios a este blog con Utterances, que guarda cada comentario como una issue de GitHub. Funcionaba, pero lleva sin recibir cambios desde 2022, y no quería esperar a que se rompiera.
Así que lo he cambiado por Giscus. La idea es la misma, pero en lugar de usar las issues usa las Discussions de GitHub, que encajan mucho mejor con una conversación. Y, a diferencia de Utterances, se sigue manteniendo.
Los comentarios que ves aquí abajo ya son de Giscus, y no se ha perdido ninguno de los antiguos.
Cómo funciona
Cada página de tu web tiene su propia discussion en un repositorio de GitHub, y cada comentario es un comentario de esa discussion. No hay base de datos ni servidor: todo vive en GitHub.
Cuando alguien entra en un artículo, Giscus busca la discussion que le corresponde. Si no existe, el bot de Giscus la crea la primera vez que alguien comenta o reacciona.
Para comentar hace falta una cuenta de GitHub. Puedes hacerlo desde el propio blog, autorizando la app de Giscus, o directamente en la discussion de GitHub.
Por qué Giscus y no Utterances
- Reacciones. Además de comentar, puedes reaccionar al artículo con emojis, como en GitHub.
- Respuestas en hilo. Las Discussions permiten responder a un comentario concreto. En una issue, todo va en una sola lista.
- Carga diferida. Con
data-loading="lazy", los comentarios solo se cargan cuando el lector llega a ellos. - Idiomas. La interfaz está traducida a más de 30 idiomas, español incluido.
- Mantenimiento. Sigue recibiendo cambios en 2026.
Igual que Utterances, es open source, gratis y no tiene anuncios ni rastreo.
Cómo se configura
Yo ya tenía un repositorio solo para los comentarios, el mismo que usaba con Utterances. Para Giscus necesita tres cosas:
- Que sea público. Si no, los lectores no pueden ver las discussions.
- Que tenga las Discussions activadas. Se activan en Settings → General → Features.
- Que tenga instalada la app de Giscus.
Después entra en giscus.app, escribe el nombre del repositorio y elige las opciones. La propia web te genera el <script> con los identificadores de tu repositorio y de la categoría ya rellenos. Este es el que uso yo:
<script
src="https://giscus.app/client.js"
data-repo="baumannzone/baumannzonedev-comments"
data-repo-id="R_kgDOHJPgsA"
data-category="Comments"
data-category-id="DIC_kwDOHJPgsM4CfuZO"
data-mapping="pathname"
data-strict="0"
data-reactions-enabled="1"
data-emit-metadata="0"
data-input-position="bottom"
data-theme="preferred_color_scheme"
data-lang="es"
data-loading="lazy"
crossorigin="anonymous"
async
></script>
Lo he pegado en la plantilla de los artículos, en el mismo sitio donde estaba el de Utterances.
Estos son los atributos que más importan:
data-repo-idydata-category-id: no los escribas a mano, cópialos de giscus.app.data-category: la categoría de Discussions donde se crean las conversaciones. Yo he creado una llamada Comments para tenerlas separadas del resto. Giscus recomienda que sea de tipo Announcements: así solo tú y el bot podéis abrir discussions nuevas, y los demás solo pueden comentar en las que ya existen.data-mapping: cómo se relaciona cada página con su discussion. Conpathname, la discussion se llama como la ruta del artículo. Si cambias la URL, los comentarios no aparecerán en la nueva.data-strict: con1, Giscus busca la discussion por un hash del título en lugar de por el título. Evita que dos artículos con rutas parecidas acaben compartiendo comentarios, pero yo lo tengo en0por la migración. Te lo explico abajo.data-theme: conpreferred_color_schemese adapta al modo claro u oscuro del sistema. Ojo, va con guiones bajos. En Utterances espreferred-color-scheme, con guiones normales.
Si usas React, Vue o Svelte, tienes un componente oficial, @giscus/react, @giscus/vue o @giscus/svelte, que hace lo mismo sin pegar el <script>.
Cómo he migrado los comentarios de Utterances
Lo que más miedo me daba era perder los comentarios antiguos. No hace falta: GitHub convierte issues en discussions y conserva todos los comentarios.
Se hace desde cada issue: en la barra lateral, pulsas Convert to discussion, eliges la categoría y confirmas. La issue queda cerrada y bloqueada, con un enlace a la nueva discussion. Los comentarios conservan su autor y su fecha.
GitHub no tiene una API para hacerlo, así que fui una a una. Eran 13 issues, unos diez minutos.
Después, Giscus tiene que encontrarlas. Busca cada discussion por su título, según lo que pongas en data-mapping. Utterances y Giscus calculan pathname exactamente igual: la ruta del artículo sin la barra inicial, como blog/testing-con-javascript/. Como usaba pathname en los dos, no he tenido que renombrar nada.
Algunas de mis issues antiguas no llevan la barra final, como blog/dibujar-con-css, porque las URLs del blog no la tenían cuando se crearon. Tampoco ha sido un problema: la búsqueda de GitHub ignora esa barra y Giscus las encuentra igual.
Lo único que no encaja es data-strict="1". Las discussions convertidas no tienen el hash del título en el cuerpo, y tendría que añadirlo a mano en cada una. Por eso lo he dejado en 0.
Que nadie use tus comentarios en otra web
Al publicar el script con mis identificadores, me entró la duda: ¿y si alguien lo copia?
Los identificadores no son secretos. Están en el código fuente de cualquier página del blog, y giscus.app los saca de cualquier repositorio público. Con ellos nadie puede escribir en tu repositorio ni tocar tu cuenta.
El problema es otro. Si alguien pega tu script en su web, los comentarios de su web acaban como discussions en tu repositorio.
Para evitarlo, Giscus lee un archivo giscus.json en la raíz del repositorio de comentarios. Este es el mío:
{
"origins": ["https://www.baumannzone.dev", "https://baumannzone.dev"],
"originsRegex": ["http://localhost:[0-9]+"]
}
origins: los dominios donde se permite cargar los comentarios. Pon las dos versiones, con y sinwww.originsRegex: lo mismo, pero con expresiones regulares. Lo uso para que funcione enlocalhostcon cualquier puerto, mientras pruebo en local.
Si el dominio no está en la lista, Giscus no carga el widget. Lo he probado desde otro dominio y no aparece nada.
Lo que no cambia
Sigue dependiendo de GitHub. Para comentar hace falta una cuenta, y eso deja fuera a quien no la tenga. Para un blog técnico no es un problema, para uno de recetas sí.
Además, la app de Giscus necesita permiso para crear discussions en el repositorio. Igual que con Utterances, úsala en un repositorio dedicado solo a los comentarios, no en el de tu código.
Pruébalo tú mismo: deja un comentario o una reacción aquí abajo. ¿Usas Giscus en tu blog, o sigues con Utterances?
