You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
97 lines
4.3 KiB
Markdown
97 lines
4.3 KiB
Markdown
2 years ago
|
+++
|
||
|
|
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).
|