✨ feat: add support for giscus and utterances

content/blog/comments.es.md

@@ -0,0 +1,96 @@
++++
+title = "Añade comentarios a tus publicaciones con giscus o utterances"
+date = 2023-07-14
+description = "Descubre cómo habilitar una sección de comentarios en tus publicaciones usando giscus o utterances, permitiendo la interacción y feedback de los lectores."
+
+[taxonomies]
+tags = ["funcionalidad", "tutorial"]
+
+[extra]
+giscus = true
++++
+
+tabi actualmente soporta dos sistemas de comentarios: [giscus](https://giscus.app/es) y [utterances](https://utteranc.es/).
+
+giscus y utterances son proyectos de código abierto que te permiten añadir una sección de comentarios a tu sitio web usando las «issues» (utterances) o «discussions» (giscus) de GitHub. Son perfectos para generadores de sitios estáticos como Zola, ya que permiten a tus lectores interactuar y dejar comentarios en tus publicaciones sin requerir un backend tradicional ni una base de datos.
+
+Al estar basados en GitHub, giscus y utterances requieren que los usuarios tengan una cuenta en dicha plataforma y autoricen la respectiva aplicación. Alternativamente, los visitantes también pueden comentar directamente en la discusión o «issue» correspondiente de GitHub.
+
+Ambas son excelentes herramientas para agregar comentarios a tu blog, pero giscus tiene algunas ventajas:
+- Más temas.
+- Soporte para reacciones.
+- Respuestas a comentarios y vista de conversación.
+- Más seguro: utterances requiere habilitar estilos en línea inseguros («unsafe inline styles») para ajustar la altura del frame; giscus no.
+- Soporte multilingüe: utterances solo está disponible en inglés; giscus soporta más de 20 idiomas.
+- Desarrollo más activo: el último commit de giscus, a fecha de esta publicación, fue hace una semana. El último commit de utterances fue hace más de un año.
+
+## Configuración
+
+Cada sistema de comentarios requiere una configuración similar. Primero, visita el sitio web del sistema que quieres habilitar: [giscus.app](https://giscus.app/es) o [utteranc.es](https://utteranc.es/).
+
+Sigue las instrucciones de la sección **Configuración** del sitio web, y elige las opciones que prefieras. Luego, establece los valores que se muestran en la sección **Habilitar giscus/utterances** (el bloque de código `script`) en la sección correspondiente de tu `config.toml`: `[extra.giscus]` o `[extra.utterances]`.
+
+### giscus
+
+giscus tiene algunos ajustes más que utterances:
+
+```toml
+[extra.giscus]
+enabled_for_all_posts = false
+automatic_loading = true
+repo = "tuNombreDeUsuarioDeGithub/tuRepositorio"
+repo_id = "TuIDdeRepositorio"
+category = "Anuncios"
+category_id = "TuIDdeCategoría"
+mapping = "slug"
+strict_title_matching = 1  # 1 para habilitar, 0 para deshabilitar.
+enable_reactions = 1  # 1 para habilitar, 0 para deshabilitar.
+comment_box_above_comments = true
+light_theme = "noborder_light"
+dark_theme = "noborder_dark"
+lang = ""  # Deja en blanco para que coincida con el idioma de la página.
+lazy_loading = true
+```
+
+### utterances
+
+```
+[extra.utterances]
+enabled_for_all_posts = false
+automatic_loading = true
+repo = "tuNombreDeUsuarioDeGithub/tuRepositorio"
+issue_term = "slug"
+label = "💬"
+light_theme = "github-light"
+dark_theme = "photon-dark"
+lazy_loading = true
+```
+
+### Ajustes comunes
+
+La opción `enabled_for_all_posts = true` habilitará globalmente el sistema de comentarios correspondiente.
+
+Alternativamente, puedes habilitar los comentarios en publicaciones concretas con `utterances = true` o `giscus = true`. Por ejemplo, así habilitarías giscus:
+
+```toml,hl_lines=09-10
++++
+title = "Los molinos de viento de mi vida: reflexiones de un escudero"
+date = 1605-01-16
+description = "Mi viaje junto a Don Quijote, enfrentándome a gigantes imaginarios y descubriendo las verdaderas batallas de la vida."
+
+[taxonomies]
+tags = ["personal", "reflexiones"]
+
+[extra]
+giscus = true
++++
+```
+
+Si accidentalmente habilitas ambos sistemas, Zola mostrará un error.
+
+Si tu web tiene múltiples idiomas con publicaciones coincidentes (como esta demo), y te gustaría compartir comentarios entre idiomas, debes usar `issue_term = "slug"`. Esto usará el nombre del archivo Markdown (sin la etiqueta de idioma) como identificador. Todas las demás opciones crearán diferentes secciones de comentarios para cada idioma.
+
+
+## Ejemplo en vivo
+
+Al final de esta publicación encontrarás el widget de giscus usando los ajustes mostrados [arriba](#giscus).