Sin JavaScript obligatorio
Este tema no requiere JavaScript de manera obligatoria. Opcionalmente, puede cargar una cantidad mínima de JavaScript para añadir algunas características que son imposibles de lograr con solo HTML y CSS.
Opciones habilitadas globalmente
Búsqueda. Habilitada estableciendo un idioma por defecto y
build_search_index = true
en la sección principal deconfig.toml
. (~23KB de JavaScript)El interruptor de modo claro/oscuro puede habilitarse configurando
theme_switcher = true
en la sección[extra]
de tuconfig.toml
(~1KB de JavaScript).Descodificación de correo electrónico (~400 bytes). Para proteger contra bots que recopilan correos electrónicos desde tu sitio web, puedes configurar
encode_plaintext_email = true
. Si tu sitio está en un repositorio público, para mayor protección, considera configurar tuemail
como una cadena codificada en base64[1].
Opciones que se pueden sobreescribir de forma jerárquica
Las siguientes opciones pueden especificarse para publicaciones, secciones y a nivel global, siguiendo la jerarquía de página > sección > config.toml
:
- Soporte de KaTeX. Habilitado al configurar
katex = true
(274 KB). - Diagramas de Mermaid. Habilitado al configurar
mermaid = true
(~2.5 MB). - Copia de bloques de código con un solo clic. Habilitado al configurar
copy_button = true
(~700 bytes). - Mostrar ruta/URL en bloques de código. Se activa configurando
add_src_to_code_block = true
. (~400 bytes) - Filtraje por etiquetas para cuadrículas de tarjetas (p. ej. proyectos) (~2KB). Habilitado al configurar
enable_cards_tag_filtering = true
.
Para especificar estas opciones:
- Globalmente: Añádelas en la sección
[extra]
de tuconfig.toml
. - Para una sección: Añádelas en la sección
[extra]
del front matter del_index.md
de la sección. - Para una publicación individual: Configura las variables correspondientes en la sección
[extra]
del front matter de la publicación.
Opciones que pueden habilitarse globalmente o para publicaciones individuales
- Comentarios. giscus (2 KB), utterances (1 KB), Hyvor Talk (~800 bytes) o Isso (1KB) pueden habilitarse globalmente configurando
enabled_for_all_posts = true
en la sección apropiada de tuconfig.toml
([extra.giscus]
,[extra.utterances]
,[extra.hyvortalk]
o[extra.isso]
). Para habilitar comentarios en publicaciones individuales, configura el nombre del sistema= true
(por ejemplo,hyvortalk = true
) en el front matter de la publicación.
Aparte de eso, es un tema rápido con HTML y CSS que funciona con JavaScript deshabilitado. Justo como debería ser (la mayoría de) la web :-)
Para codificar tu correo electrónico en base64 puedes usar herramientas en línea o, en tu terminal, ejecutar:
printf 'mail@example.com' | base64
. ↩