feat: add support for giscus and utterances

This commit is contained in:
welpo 2023-07-14 21:22:23 +02:00
parent 3e215e18e2
commit 5993e950c7
No known key found for this signature in database
GPG key ID: A2F978CF4EC1F5A6
20 changed files with 426 additions and 59 deletions

View file

@ -1,22 +1,31 @@
+++
title = "Sin JavaScript obligatorio"
date = 2023-01-06
updated = 2023-07-08
updated = 2023-07-13
description = "JavaScript solo se utiliza cuando HTML y CSS no son suficientes."
[taxonomies]
tags = ["funcionalidad"]
tags = ["funcionalidad", "tutorial"]
+++
## ¿JavaScript?
Este tema funciona perfectamente sin JavaScript. Opcionalmente, puede cargar una cantidad mínima para añadir algunas funciones que son imposibles de lograr con HTML y CSS:
Este tema no tiene JavaScript obligatorio. Opcionalmente, puede cargar una cantidad mínima para agregar algunas características que son imposibles de lograr con HTML y CSS.
- **El cambio de modo claro/oscuro**. Habilitado estableciendo `theme_switcher = true`. (~900 bytes)
- **Copia de bloques de código con un clic**. Se activa configurando `copy_button = true`. (~700 bytes)
### Opciones globales
Estas dos configuraciones se deben aplicar en la sección `[extra]` de tu archivo `config.toml`.
- **Interruptor de modo claro/oscuro**. Habilitado configurando `theme_switcher = true`. (~900 bytes)
- **Copia de bloques de código con un solo clic**. Habilitado configurando `copy_button = true`. (~700 bytes)
La [funcionalidad de KaTeX](@/blog/markdown.es.md#katex), que requiere cargar un archivo JavaScript de 274 KB, se puede activar para publicaciones específicas. Esto se puede hacer configurando `katex = true` en la sección `[extra]` del encabezado de la publicación.
Estas dos configuraciones se pueden aplicar en la sección `[extra]` de tu `config.toml`.
Aparte de esto, es un tema rápido con HTML y CSS. Como debería ser (en su mayoría) la web :-)
- [**Comentarios**](@/blog/comments.es.md). giscus (2 KB) o utterances (1 KB) se pueden habilitar globalmente configurando `enabled_for_all_posts = true` en la sección apropiada de tu archivo `config.toml` (`[extra.giscus]` o `[extra.utterances]`).
### Opciones para publicaciones individuales
Las siguientes configuraciones se pueden habilitar en publicaciones específicas configurando ciertas variables en la sección `[extra]` del front matter del post.
- [**KaTeX**](@/blog/markdown.es.md#katex) (274 KB) se puede habilitar con `katex = true`.
- [**Comentarios**](@/blog/comments.es.md). Se pueden habilitar en posts específicos configurando `utterances = true` o `giscus = true`.
Aparte de eso, es un tema rápido con HTML y CSS que funciona con JavaScript deshabilitado. Como debería ser (en su mayoría) la web :-)