mirror of
https://github.com/welpo/tabi.git
synced 2025-10-11 07:46:15 +02:00
⚡️ refactor: co-locate images (#200)
This commit is contained in:
Óscar Fernández
GitHub
parent
c0a07cb467
commit
8aabeaecc3
173 changed files with 205 additions and 205 deletions
138
content/blog/comments/index.es.md
Normal file
138
content/blog/comments/index.es.md
Normal file
|
|
@ -0,0 +1,138 @@
|
|||
+++
|
||||
title = "Añade comentarios a tus publicaciones con estas 4 plataformas"
|
||||
date = 2023-07-14
|
||||
updated = 2023-07-26
|
||||
description = "Descubre cómo habilitar una sección de comentarios en tus publicaciones usando giscus, utterances, Hyvor Talk, o Isso, permitiendo la interacción y feedback de los lectores."
|
||||
|
||||
[taxonomies]
|
||||
tags = ["funcionalidad", "tutorial"]
|
||||
|
||||
[extra]
|
||||
giscus = true
|
||||
quick_navigation_buttons = true
|
||||
toc = true
|
||||
social_media_card = "social_cards/es_blog_comments.jpg"
|
||||
+++
|
||||
|
||||
tabi actualmente soporta cuatro sistemas de comentarios: [giscus](https://giscus.app/es) y [utterances](https://utteranc.es/), [Hyvor Talk](https://talk.hyvor.com/) e [Isso](https://isso-comments.de/).
|
||||
|
||||
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 dos días. El último commit de utterances fue hace más de un año.
|
||||
|
||||
Hyvor Talk es una plataforma de comentarios de pago centrada en la privacidad. Ofrece todas las ventajas de giscus y algunas más, como moderación y detección de spam.
|
||||
|
||||
Isso es un sistema de comentarios de código abierto y autoalojado que almacena los comentarios en su propia base de datos. Una de sus principales ventajas es la privacidad; no comparte los datos de los usuarios con terceros. También tiene una interfaz ligera y limpia, lo que facilita que tus visitantes dejen comentarios. Isso también permite comentarios anónimos, lo que podría aumentar la participación de los usuarios en tu sitio web.
|
||||
|
||||
## Configuración
|
||||
|
||||
### Sistemas basados en GitHub
|
||||
|
||||
giscus y utterances requieren una configuración similar. Primero, visita el sitio web del sistema que quieras 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
|
||||
|
||||
```toml
|
||||
[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
|
||||
```
|
||||
|
||||
### Hyvor Talk
|
||||
|
||||
Configura tu web desde la [consola de Hyvor Talk](https://talk.hyvor.com/console) y rellena las opciones en `config.toml`:
|
||||
|
||||
```toml
|
||||
[extra.hyvortalk]
|
||||
enabled_for_all_posts = false
|
||||
automatic_loading = true
|
||||
website_id = "1234"
|
||||
page_id_is_slug = true
|
||||
lang = ""
|
||||
page_author = "" # Correo (o correo codificado en base64) del autor.
|
||||
lazy_loading = true
|
||||
```
|
||||
|
||||
### Isso
|
||||
|
||||
Para habilitar Isso, primero necesitarás instalar y ejecutar un servidor Isso ([aquí tienes una guía útil](https://blog.phusion.nl/2018/08/16/isso-simple-self-hosted-commenting-system/#1installingisso)). Luego, completa estas configuraciones en `config.toml`:
|
||||
|
||||
```toml
|
||||
[extra.isso]
|
||||
enabled_for_all_posts = false
|
||||
automatic_loading = true
|
||||
endpoint_url = "https://example.com/comments/" # URL a Isso.
|
||||
page_id_is_slug = true
|
||||
lang = ""
|
||||
max_comments_top = "inf"
|
||||
max_comments_nested = "5"
|
||||
avatar = true
|
||||
voting = true
|
||||
page_author_hashes = ""
|
||||
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 añadiendo el nombre del sistema (`utterances`, `giscus`, `hyvortalk` o `isso`) `= 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 más de un sistema, 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"` (en el caso de giscus y utterances) o `page_id_is_slug = true` (para Hyvor Talk e Isso). 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).
|
||||
Loading…
Add table
Add a link
Reference in a new issue