Domina la configuración de tabi: guía completa

Esta es la guía completa sobre la configuración en tabi. Si tienes alguna pregunta, puedes abrir un issue en GitHub o inciar una discusión.

Jerarquía de configuración

tabi tiene una jerarquía que te permite personalizar tu sitio en diferentes niveles. La jerarquía (de menor a mayor prioridad) es la siguiente:

1. Configuraciones globales: Estas son las configuraciones que se aplican a todo tu sitio. Se establecen en config.toml.
2. Configuraciones de sección: Estas son las configuraciones que se aplican a una sección de tu sitio (por ejemplo, /blog o /projects). Se establecen en la metainformación del archivo _index.md de la sección.
3. Configuración de la página «padre»: Para páginas anidadas (páginas dentro de páginas), estas son las configuraciones de la página que las contiene.
4. Configuraciones de página: Estas son las configuraciones que se aplican a una sola página. Se establecen en la metainformación de la página.

En todos los casos, las opciones de tabi se establecen en la sección [extra].

Para las configuraciones que siguen esta jerarquía, el valor establecido en una página reemplaza el valor de una sección, que a su vez reemplaza el valor global. En resumen: cuanto más específica sea la configuración, mayor prioridad tendrá, o página > página padre/sección > config.toml.

Búsqueda

tabi soporta búsqueda local accesible y multilingüe con Elasticlunr. Para activarla, necesitas:

1. Establecer un default_language en config.toml.
2. Establecer build_search_index = true.
3. Opcionalmente, configurar la sección [search].

Por ejemplo:

base_url = "https://example.com"
default_language = "en"
build_search_index = true

[search]
index_format = "elasticlunr_json" # O el menos eficiente "elasticlunr_javascript".
include_title = true
include_description = true
include_path = true
include_content = true

Nota: para soporte de búsqueda en Chino/Japonés, necesitas usar una build personalizada de Zola.

Consideraciones para usuarios de Zola 0.17.X

Zola 0.17.X no proporciona acceso a la variable search.index_format (reporte del bug). Al usar tabi, se asume el uso del índice JSON, que es más eficiente. Sin embargo, debido a otro bug solucionado en 0.18.0, el índice JSON para sitios multilingües no se genera correctamente.

Los usuarios con versiones de Zola anteriores a 0.18.0 que quieran usar el índice JavaScript necesitan establecer la variable index_format en dos lugares:

[search]
index_format = "elasticlunr_javascript"

[extra]
index_format = "elasticlunr_javascript"

Esto asegura que tabi cargue los archivos correctos. Recomendamos actualizar a Zola 0.18.0 o posterior para una funcionalidad óptima.

Detalles de implementación

Para detalles técnicos sobre la implementación de la búsqueda en tabi, incluyendo cuándo se carga el índice, características de accesibilidad y otros detalles, consulta el Pull Request #250.

Soporte multilingüe

tabi ofrece soporte multilingüe completo para tu sitio Zola, desde configurar un idioma predeterminado hasta añadir todos los que desees. Consulta la preguntas frecuentes sobre idiomas para más información.

Apariencia

Página principal

La página principal de esta demo tiene un encabezado con una imagen, un título y una descripción:

Cabecera

Para configurar la imagen y el título, puedes usar la variable header en el front matter del archivo _index.md de la sección. Por ejemplo:

[extra]
header = {title = "¡Hola! Soy tabi~", img = "blog/mastering-tabi-settings/img/main.webp", img_alt = "Óscar Fernández, el autor del tema" }

La descripción es contenido Markdown normal, escrito fuera del front matter.

Listando publicaciones recientes

Para mostrar publicaciones en la página principal, primero debes decidir de dónde se servirán: de la ruta raíz (/) o de un subdirectorio (por ejemplo, /blog).

Opción A: Servir publicaciones desde la ruta raíz (/)

Configura paginate_by en el front matter de tu archivo content/_index.md:

title = "Últimas publicaciones"
sort_by = "date"
paginate_by = 5  # Muestra 5 publicaciones por página.

[extra]
header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Tu nombre" }

Opción B: Servir publicaciones desde un subdirectorio (por ejemplo, /blog)

Utiliza section_path en la sección [extra] de tu archivo content/_index.md:

title = "Últimas publicaciones"
sort_by = "date"
# No configures `paginate_by` aquí.

[extra]
header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Tu nombre" }
section_path = "blog/_index.md"  # Dónde encontrar tus publicaciones.
max_posts = 5  # Muestra hasta 5 publicaciones en la página principal.

Notas adicionales:

• El title en el front matter establece el título que aparece sobre las publicaciones.
• Usa la ruta completa al archivo _index.md de la sección para section_path. Usar section_path = "blog/" no funcionará.

Fijar publicaciones

Puedes fijar publicaciones para mantenerlas en la parte superior de la página principal. En esta demo, esta publicación está fijada, por lo que aparece primera con un icono y etiqueta de “fijada”:

Las publicaciones fijadas se muestran primero, manteniendo su orden relativo según el sort_by de la sección, seguidas por el resto de las publicaciones.

Para fijar una publicación, añade lo siguiente a su front matter:

[extra]
pinned = true

Mostrar la fecha de los artículos en el listado

Por defecto, cuando se listan los artículos, se muestra la fecha de creación. Puedes configurar qué fecha(s) mostrar usando la opción post_listing_date. Configuraciones disponibles:

• date: Muestra solo la fecha de publicación original del artículo (opción por defecto).
• updated: Muestra solo la fecha de la última actualización del artículo. Si no hay fecha de actualización, muestra la fecha de publicación original.
• both: Muestra tanto la fecha de publicación original como la fecha de la última actualización.

Listado de proyectos

Puedes mostrar una selección de proyectos en tu página principal. Para hacer esto, primero necesitarás configurar el directorio projects.

Una vez hecho esto, configura la ruta a los proyectos en la sección [extra] de tu archivo _index.md:

[extra]
projects_path = "projects/_index.md"

Esto mostrará los 3 proyectos de mayor prioridad (con menor peso; el mismo orden que en Proyectos). Para mostrar más o menos proyectos, puedes establecer max_projects en [extra].

Por defecto, la sección de proyectos se mostrará en la parte inferior de la página principal, bajo los posts. Si prefieres que aparezca en la parte superior, establece show_projects_first = true.

Interruptor de modo claro y oscuro

El interruptor de modo claro y oscuro (el icono de luna/sol en la esquina superior derecha) puede habilitarse configurando theme_switcher = true en config.toml.

Modo predeterminado (claro/oscuro)

El tema predeterminado puede especificarse con la variable default_theme, que acepta "dark" o "light". Si no lo especificas, el tema predeterminado será el tema del sistema.

Pieles personalizadas

Las pieles de tabi cambian el color principal del sitio. Puedes configurar la piel en config.toml con skin = "nombre_de_la_piel". Por ejemplo, skin = "lavender" se ve así (haz clic para cambiar entre modo claro y oscuro):

Explora las pieles disponibles y aprende cómo crear la tuya propia consultando la documentación.

Fuente sans serif (paloseco)

tabi utiliza una fuente serif para los párrafos de los artículos (la que estás viendo ahora). Puedes cambiar a una fuente sans serif (la que ves en los encabezados/menú) en todo tu sitio configurando override_serif_with_sans = true en config.toml.

Haz clic en la imagen para comparar las fuentes:

Indicador de enlaces externos

Si deseas añadir un icono a los enlaces externos, configura la sección [markdown] (no [extra]) en tu config.toml:

[markdown]
external_links_class = "external"

Esto añadirá un pequeño icono junto a los enlaces externos:

Estilos CSS personalizados

Puedes cargar estilos CSS personalizados para todo el sitio o en páginas específicas utilizando stylesheets, que acepta una lista de rutas hacia archivos CSS. Por ejemplo:

stylesheets = ["css/custom.css", "css/another.css"]

Color del tema del navegador

El color del tema del navegador es el color que aparece en la barra de pestañas del navegador:

Puedes establecerlo en config.toml como browser_theme_color = "#087e96". Si deseas diferentes colores para los modos oscuro/claro, puedes establecer un conjunto de colores con browser_theme_color = ["#ffffff", "#000000"]. El primer color es para el modo claro, el segundo para el oscuro.

Esta variable acepta cualquier color CSS válido, así que puedes usar palabras clave (por ejemplo, blue), códigos hexadecimales (por ejemplo, #087e96) o valores RGB/HSL (por ejemplo, rgb(8, 126, 150)).

Etiquetas compactas

Por defecto, la página de etiquetas muestra las etiquetas así:

NombreEtiqueta — n publicación[es]

Establecer compact_tags = true mostrará las mismas de este modo:

NombreEtiqueta ⁿ

Orden de las etiquetas

Por defecto, la página de etiquetas ordena las etiquetas alfabéticamente, dada la configuración predeterminada de tag_sorting = "name". Si configuras tag_sorting = "frequency", se ordenarán según el número de publicaciones (de mayor a menor).

Series

Para una explicación detallada, consulta la documentación de series.

Enlace para saltar a las publicaciones

Por defecto, aparece automáticamente un enlace “Saltar a publicaciones” junto al título de la serie cuando una serie tiene un contenido de más de 2000 caracteres:

Establece show_jump_to_posts = true para forzar la activación de la función y show_jump_to_posts = false para desactivarla.

Indexación de páginas de series

Por defecto, las páginas de series se indexan (usando una indexación basada en 1) según el sort_by de la sección de series.

Establece post_listing_index_reversed = true para invertir el índice.

Integración con repositorios Git

❓: show_remote_source sí sigue la jerarquía y puede configurarse en una página, sección o globalmente. El resto de las configuraciones solo pueden establecerse en config.toml.

Estas configuraciones te permiten vincular tu sitio web tabi con un repositorio público de Git en GitHub, GitLab, Gitea o Codeberg. Configuraciones de ejemplo:

remote_repository_url = "https://github.com/welpo/tabi"
remote_repository_git_platform = "auto"
remote_repository_branch = "main"
show_remote_changes = true
show_remote_source = true

Esto habilita dos funciones:

1. show_remote_source = true añade un enlace al código fuente de tu sitio (tu remote_repository_url) que se mostrará en el pie de página:

1. show_remote_changes = true añade un enlace «Ver cambios ↗» al historial de commits del artículo actualizado, al lado de la fecha de última actualización ¹:

Al hacer clic en este enlace, serás dirigido al historial de commits del artículo, donde podrás ver los cambios realizados en él:

Páginas

Proyectos

tabi tiene una plantilla integrada para proyectos. Para habilitarla, puedes crear un directorio en content/projects/. Allí, puedes crear un archivo _index.md con el siguiente contenido en el bloque de metadatos:

title = "Proyectos"
sort_by = "weight"
template = "cards.html"
insert_anchor_links = "left"

[extra]
show_reading_time = false
quick_navigation_buttons = true

• title es el título de la página.
• sort_by determina cómo se ordenan los proyectos. Puedes ordenar por «date», «update_date», «title», «title_bytes», «weight», «slug» o «none».
• template = "cards.html" establece la plantilla para renderizar la página de proyectos.
• insert_anchor_links = "left" añade enlaces ancla a los encabezados.
• show_reading_time = false oculta el tiempo estimado de lectura.
• quick_navigation_buttons = true muestra los botones de navegación rápida.

Junto al archivo _index.md, puedes crear un archivo para cada proyecto. Por ejemplo, este es el bloque de metadatos para la página del proyecto tabi:

title = "tabi"
description = "Un tema de Zola rápido, ligero y moderno con soporte multilingüe."
weight = 1

[extra]
local_image = "img/tabi.webp"

• title es el título del proyecto.
• description es la descripción del proyecto.
• weight determina el orden en el que se muestran los proyectos. Cuanto menor sea el peso, más arriba aparecerá el proyecto.
• local_image es la ruta de la imagen del proyecto. Esta imagen se muestra en la página de proyectos.

Cuando un usuario haga clic en la imagen o el título de un proyecto, será llevado a la página del proyecto. Si prefieres que los usuarios vayan a un enlace externo, puedes establecer link_to = "https://example.com" en la sección [extra] del archivo .md del proyecto.

La página del proyecto individual se renderiza con la plantilla predeterminada, a menos que establezcas otra, por ejemplo, template = "info-page.html".

Filtrar proyectos

Si agregas etiquetas a tus proyectos, verás un filtro de etiquetas:

El sistema de filtrado de etiquetas utiliza mejora progresiva:

• Sin JavaScript: Las etiquetas enlazan directamente a páginas de etiquetas dedicadas (por ejemplo, /tags/nombre-etiqueta).
• Con JavaScript: Filtrado instantáneo, sincronización de URL (#nombre-etiqueta) y navegación por teclado.

Para desactivar esta función, establece enable_cards_tag_filtering = false en la sección [extra] del archivo projects/_index.md o en config.toml.

title = "nombre del proyecto"
weight = 40

[taxonomies]
tags = ["etiqueta uno", "etiqueta 2", "tercera etiqueta"]

Archivo

Agregar una página de archivo es similar a agregar una página de proyectos. Puedes crear un directorio en content/archive/. Allí, puedes crear un archivo _index.md con el siguiente encabezado:

title = "Archivo"
template = "archive.html"

Por defecto, el archivo mostrará las publicaciones ubicadas en blog/. Para personalizar esto, puedes modificar la sección [extra] del archivo _index.md:

• Para una sola ruta: Establece section_path = "tu-ruta/" para listar publicaciones de un directorio específico. Asegúrate de incluir la barra inclinada al final.

• Para múltiples rutas: Si deseas agregar publicaciones de varios directorios, section_path puede especificarse como una lista de rutas. Por ejemplo:

  [extra]
  section_path = ["blog/", "notas/", "ruta-tres/"]
  

El archivo muestra las publicaciones en orden cronológico inverso (las más recientes primero). Puedes invertir este orden estableciendo archive_reverse = true en la sección [extra]:

[extra]
archive_reverse = true  # muestra las publicaciones más antiguas primero

Etiquetas

tabi tiene soporte integrado para etiquetas. Para habilitarlas, simplemente añade la taxonomía a tu config.toml:

taxonomies = [{name = "tags", feed = true}]

Luego, puedes añadir etiquetas a tus publicaciones agregándolas al array tags en el bloque de metadatos de tu publicación. Por ejemplo:

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"]

Página acerca de

Si deseas tener una página que no sea un artículo, por ejemplo para un apartado “Acerca de”, “Contacto” o “Derechos de autor”, puedes usar la plantilla info-page.html.

Primero, crea un directorio dentro de content/ con el nombre que prefieras. Por ejemplo, content/pages/. Luego, crea un archivo _index.md dentro de ese directorio. El archivo debería verse así:

+++
render = false
insert_anchor_links = "left"
+++

• render = false indica a Zola que no renderice la sección.
• insert_anchor_links = "left" añade enlaces ancla a los encabezados. Esto es opcional.

Dentro del directorio, puedes crear cualquier cantidad de archivos .md.

En esta demo, la página Sobre mí utiliza la plantilla info-page.html. El bloque de metadatos es el siguiente:

title = "Sobre mí"
template = "info-page.html"
path = "about"

Fíjate cómo se establece path = "about". Zola colocará la página en $base_url/about/. Si deseas que la página esté disponible en /contacto/, tendrías que establecer path = "contacto".

La plantilla info-page.html también se puede utilizar para crear lading pages en la ruta raíz ("/"). Para hacerlo, el archivo content/_index.md debería verse así:

+++
title = "Título de la página"
template = "info-page.html"
+++

Contenido con Markdown.

SEO

tabi se encarga de la mayoría de las tareas de SEO por ti (como etiquetas del protocolo Open Graph, descripción, esquema de colores…), pero hay ciertas configuraciones que puedes personalizar.

Favicon

El favicon es el pequeño icono que aparece en la pestaña del navegador. Puedes establecerlo en config.toml con favicon = "img/favicon.png".

Favicon de emoji

También puedes establecer un emoji como tu favicon con favicon_emoji. Por ejemplo, favicon_emoji = "👾".

Nota: Algunos navegadores no admiten favicons de emoji. Consulta la tabla de compatibilidad en caniuse.

URL canónica

La URL canónica es una manera de indicar a los motores de búsqueda cuál es la URL preferida para el contenido de tu sitio web. Esto es útil para el SEO y para evitar problemas de contenido duplicado.

Por defecto, la URL canónica es la URL de la página en la que te encuentras. Sin embargo, puedes cambiar esto configurando canonical_url en el front matter de tu página o sección.

Si tienes un sitio con una estructura idéntica y contenido coincidente, puedes configurar base_canonical_url en tu config.toml. La URL canónica se creará reemplazando el $base_url de la URL actual con el $base_canonical_url que establezcas.

Por ejemplo, si configuras base_canonical_url = "https://example.com", la URL canónica de la página $base_url/blog/post1 será https://example.com/blog/post1. Esto es útil si tienes un sitio con varios dominios que comparten el mismo contenido.

Nota: para asegurarte de que la URL canónica sea correcta, probablemente sea mejor configurar canonical_url individualmente para cada página.

Tarjetas para redes sociales

Las tarjetas para redes sociales son las imágenes que se muestran cuando compartes un enlace en redes sociales:

Puedes establecer la imagen para redes sociales con social_media_card = "img/social_media_card.png".

Puedes especificar rutas tanto relativas como absolutas.

• Ruta relativa: Coloca la imagen en la misma carpeta que tu entrada de blog y especifica su nombre. Por ejemplo, social_media_card = "relative_image.png".

• Ruta absoluta: Coloca la imagen en una carpeta específica y especifica la ruta desde la raíz. Por ejemplo, social_media_card = "img/absolute_image.png".

Si ambas rutas, relativa y absoluta, son válidas, la ruta relativa tendrá prioridad.

Dado que sigue la jerarquía, si no está configurado en una página, pero sí lo está en una sección, se utilizará la imagen de la sección. Si no está configurado en una página o sección, pero sí en config.toml, se usará la imagen global.

Creador del fediverso

Puedes mostrar tu perfil del fediverso en las vistas previas de enlaces de Mastodon configurando la variable fediverse_creator en tu config.toml. Por ejemplo, para @username@example.com, usa:

fediverse_creator = { handle = "username", domain = "example.com" }

Navegación

Barra de navegación

La barra de navegación es la barra en la parte superior de la página que contiene el título del sitio y el menú de navegación. Puedes personalizar los elementos que aparecen configurando menu en config.toml.

Soporta links relativos para páginas internas y links absolutos para enlaces externos. Por ejemplo:

menu = [
    { name = "blog", url = "blog", trailing_slash = true },
    { name = "archivo", url = "archive", trailing_slash = true },
    { name = "etiquetas", url = "tags", trailing_slash = true },
    { name = "proyectos", url = "projects", trailing_slash = true },
    { name = "acerca de", url = "about", trailing_slash = true },
    { name = "github", url = "https://github.com/welpo/tabi", trailing_slash = false },
]

Botones de navegación rápida

Los botones de navegación rápida son los botones que aparecen en la parte inferior derecha de la pantalla. Deberías verlos en esta página, si no estás en un dispositivo móvil. Se ven así:

Para activarlos, establece quick_navigation_buttons = true.

Table de contenido

Habilita el índice de contenidos justo debajo del título y metadatos del artículo con toc = true.

Para saber más sobre cómo personalizarlo, consulta la documentación sobre la Tabla de contenido.

Enlace a los artículos anterior y siguiente

Muestra enlaces a los artículos anterior y siguiente en la parte inferior de los posts. Se ve así:

Para activar esta función, configura show_previous_next_article_links = true y asegúrate de que tu sección tiene sort_by (por ejemplo, sort_by = "date").

Por defecto, los artículos siguientes estarán en el lado izquierdo de la página y los artículos anteriores en el lado derecho. Para invertir el orden (artículos siguientes en el lado derecho y artículos anteriores en el lado izquierdo), establece invert_previous_next_article_links = true.

Por defecto, esta sección de navegación tendrá el ancho completo del sitio (igual que la barra de navegación de la parte superior). Para hacerla más estrecha, coincidiendo con el ancho del artículo, establece previous_next_article_links_full_width = false.

Todas estas configuraciones siguen la jerarquía.

Enlaces de retorno en notas al pie

Establecer footnote_backlinks = true añadirá enlaces de retorno a las notas al pie de tus publicaciones, como este:

Cuando hagas clic en un enlace de retorno (la flecha ↩), te llevará de vuelta al punto del texto donde se hizo referencia a la nota al pie.

Usabilidad

Botón de copiar en bloques de código

Establecer copy_button = true añadirá un pequeño botón de copiar en la parte superior derecha de los bloques de código, como este:

Nombres de bloques de código clicables

Establece code_block_name_links = true para habilitan los enlaces clickables en los nombres de bloques de código. Consulta la documentación para ver ejemplos y uso.

Forzar bloques de código de izquierda a derecha

Por defecto, los bloques de código se renderizan de izquierda a derecha, independientemente de la dirección general del texto. Establece force_codeblock_ltr = false para permitir que los bloques de código sigan la dirección del documento. Útil para idiomas de derecha a izquierda que necesitan bloques de código de derecha a izquierda.

Soporte para KaTeX

KaTeX es una biblioteca JavaScript rápida y fácil de usar para la representación de matemáticas TeX en la web. Puedes habilitarlo con katex = true. Mira cómo se ve en tabi aquí.

Soporte para Mermaid

Mermaid es una herramienta de diagramación y gráficos basada en JavaScript. Puedes activarla con mermaid = true.

Por defecto, la biblioteca Mermaid se sirve localmente. Si prefieres usar un CDN, establece serve_local_mermaid = false en config.toml. El uso de un CDN servirá la versión más reciente de Mermaid; la opción local servirá la versión incluida con tabi.

Consulta la documentación de Mermaid para instrucciones de uso y ejemplos.

Subconjunto de fuente personalizada

Las fuentes personalizadas causan parpadeo del texto en Firefox. Para solucionar esto, tabi carga un subconjunto de glifos para el encabezado. Dado que esto (ligeramente) aumenta el tiempo de carga inicial, es una buena idea intentar minimizar el tamaño de este subconjunto, o desactivarlo por completo si no estás usando una fuente personalizada en tu tema.

Puedes crear un subconjunto personalizado adaptado a tu sitio, guardarlo como static/custom_subset.css, y hacer que se cargue con custom_subset = true.

Para desactivar el subconjunto, puedes usar enable_subset = false.

Para obtener más información, incluyendo instrucciones sobre cómo crear un subconjunto personalizado, consulta la documentación.

Contenido completo en el feed

Por defecto, el feed Atom solo contiene el resumen/descripción de tus publicaciones. Puedes incluir el contenido completo de las publicaciones estableciendo full_content_in_feed = true en config.toml.

Ocultar contenido del feed

Puedes controlar cómo aparece el contenido en los feeds usando dos configuraciones:

• hide_from_feed = true: Oculta el contenido de todos los feeds (feed principal, feeds de sección y feeds de etiquetas)
• hide_from_main_feed = true: Oculta el contenido solo del feed principal mientras lo mantiene visible en los feeds de sección y de etiquetas

Comentarios

Para activar los comentarios en una página, establece el nombre del sistema como true en el front matter. Por ejemplo, utterances = true.

Si quieres activar los comentarios de forma global, puedes hacerlo estableciendo enabled_for_all_posts = true en la sección apropiada de tu config.toml (por ejemplo, en [extra.giscus]).

Si has activado un sistema globalmente, pero quieres desactivarlo en una página específica, puedes hacerlo estableciendo el nombre del sistema como false en el front matter. Por ejemplo, utterances = false.

Lee la documentación para obtener más información sobre los sistemas disponibles y su configuración.

Análisis web

tabi ofrece soporte para 3 sistemas de análisis web que respetan la privacidad: Plausible, GoatCounter y Umami.

Puedes configurarlos en la sección [extra.analytics] de tu archivo config.toml.

• service: el servicio a utilizar. Las opciones disponibles son "goatcounter", "umami", y "plausible".

• id: el identificador único para tu servicio de análisis. Esto varía según el servicio:

  • Para GoatCounter, es el código elegido durante el registro. Instancias auto-alojadas de GoatCounter no requieren este campo.
  • Para Umami, es la ID del sitio web.
  • Para Plausible, es el nombre de dominio.

• self_hosted_url. Opcional. Utiliza este campo para especificar la URL si tienes una instancia auto-alojada. La URL base variará según tu configuración particular. Algunos ejemplos:

  • Para GoatCounter: "https://stats.example.com"
  • Para Umami: "https://umami.example.com"
  • Para Plausible: "https://plausible.example.com"

Un ejemplo de configuración para GoatCounter no auto-alojada sería:

[extra.analytics]
service = "goatcounter"
id = "tabi"
self_hosted_url = ""

Pie de página

Iconos de redes sociales

Puedes añadir iconos de redes sociales al pie de página con socials, que acepta una lista de objetos de redes sociales. Por ejemplo:

socials = [
    { name = "github", url = "https://github.com/welpo/", icon = "github" },
    { name = "soundcloud", url = "https://soundcloud.com/oskerwyld", icon = "soundcloud" },
    { name = "instagram", url = "https://instagram.com/oskerwyld", icon = "instagram" },
    { name = "youtube", url = "https://youtube.com/@oskerwyld", icon = "youtube" },
    { name = "spotify", url = "https://open.spotify.com/artist/5Hv2bYBhMp1lUHFri06xkE", icon = "spotify" },
]

Para ver una lista de todos los iconos integrados, echa un vistazo al directorio static/social_icons en GitHub.

¿Echas en falta algún icono? Si crees que sería una buena adición a tabi, no dudes en abrir un issue o enviar un pull request (ejemplo).

Para usar un icono personalizado, puedes añadirlo al directorio static/social_icons de tu sitio. Por ejemplo, si añades custom.svg, puedes referenciarlo así:

{ name = "custom", url = "https://example.com", icon = "custom" }

Icono de feed

Puedes añadir un enlace a tu feed RSS/Atom en el pie de página con feed_icon = true.

Nota para usuarios de Zola 0.19.X: cuando hay dos nombres de archivo en feed_filenames, solo se enlazará el primero en el pie de página.

Menú de pie de página

Puedes añadir un menú al pie de página con footer_menu, que acepta una lista de elementos de menú. Por ejemplo:

footer_menu = [
    {url = "about", name = "about", trailing_slash = true},
    {url = "privacy", name = "privacy", trailing_slash = true},
    {url = "sitemap.xml", name = "sitemap", trailing_slash = false},
    {url = "https://example.com", name = "external link", trailing_slash = true},
]

Copyright

Para añadir una mención sobre los derechos de autor a tu sitio web, configura copyright:

copyright = "© $CURRENT_YEAR Your Name $SEPARATOR Unless otherwise noted, the content in this website is available under the [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) license."

• $TITLE será reemplazado por la variable title configurada en config.toml
• $CURRENT_YEAR será reemplazado por el año actual
• $AUTHOR será reemplazado por la variable author
• $SEPARATOR será reemplazado por la variable separator.

Se procesará el texto en Markdown. Por ejemplo, la configuració de arriba:

Si tienes un sitio multilingüe y deseas establecer diferentes notificaciones de derechos de autor para diferentes idiomas, añade la traducción correspondiente a copyright_translations.{código_de_idioma} para cada idioma que quieras dar soporte. El código de idioma debe coincidir con el código de idioma de tabi. Por ejemplo:

copyright_translations.es = "© $CURRENT_YEAR $AUTHOR $SEPARATOR A menos que se indique lo contrario, el contenido de esta web está disponible bajo la licencia [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)."

Metadatos

Mostrar autoría

Para mostrar la autoría de un artículo, usa show_author = true.

Esto mostrará lxs autorxs establecidxs en la variable authors = [] en el front matter del artículo. Si esto no está disponible, se usará author = "" en config.toml.

Tiempo de lectura

Puedes activar o desactivar el tiempo estimado de lectura de un artículo con show_reading_time. Si lo estableces en true, se mostrará en los metadatos del artículo, así:

Dado que sigue la jerarquía, puedes activarlo o desactivarlo para páginas o secciones específicas. Por ejemplo, esta demo desactiva show_reading_time = false en la sección proyectos en el archivo _index.md, por lo que sus publicaciones individuales no muestran el tiempo de lectura.

Mostrar la fecha

Por defecto, la fecha se muestra debajo del título de la publicación. Puedes ocultarla con show_date = false. Esta configuración sigue la jerarquía.

Formato de fecha

tabi tiene dos formatos de fecha: long_date_format y short_date_format. El formato corto se utiliza en los metadatos de una publicación, mientras que el formato largo se utiliza al listar las publicaciones (es decir, en la sección de blog o en la página principal).

Por defecto es “6th July 2049” para ambos formatos en inglés. Para otros idiomas, el predeterminado es "%d %B %Y" para el formato largo y "%-d %b %Y" para el formato corto.

En Zola, la sintaxis para el formateo de tiempo está inspirada en strftime. Una referencia completa está disponible en la documentación de chrono.

Separador personalizado

El separador aparece en varios lugares: en el título del navegador, entre los metadatos de una publicación…

El separador por defecto es un punto de viñeta (•), pero puedes cambiarlo configurando algo como separator = "|".

Orden del título

Por defecto, el título en la pestaña del navegador es el nombre del sitio seguido del título de la página. Por ejemplo, el título de la sección del blog es «~/tabi • Blog».

Al configurar invert_title_order = true, puedes invertir el orden del título del sitio y el título de la página en la pestaña del navegador. Por ejemplo, la etiqueta del título de la sección del blog se convertiría en «Blog • ~/tabi».

Seguridad

Correo electrónico codificado

Para proteger tu dirección de correo electrónico de los spambots, puedes codificarla en el pie de página. Puedes hacer esto estableciendo email en una versión codificada en base64 de tu dirección de correo electrónico². Por ejemplo, email = "bWFpbEBleGFtcGxlLmNvbQ==" es la versión codificada en base64 de “mail@example.com”.

Si no quieres codificar tu correo electrónico tú mismo, tabi puede hacerlo por ti si configuras encode_plaintext_email = true. Esto te permite establecer un correo electrónico en texto plano en la configuración. Ten en cuenta que esto sólo protege tu dirección de correo electrónico en tu sitio, no en repositorios públicos.

Si el correo electrónico está codificado (ya sea por ti o por tabi), los usuarios con JavaScript desactivado no verán el icono de correo electrónico.

CSP (Content Security Policy)

La Content Security Policy (CSP) es una capa adicional de seguridad que ayuda a detectar y mitigar ciertos tipos de ataques, incluidos ataques de Cross Site Scripting (XSS) e inyección de datos. Estos ataques se utilizan para todo, desde robo de datos hasta desfiguración de sitios y distribución de malware.

tabi tiene una CSP predeterminada que permite imágenes y vídeos remotos, así como incrustaciones de YouTube y Vimeo. Puedes personalizarla con allowed_domains, que toma una lista de directivas de CSP. Esta es la CSP predeterminada:

allowed_domains = [
    { directive = "font-src", domains = ["'self'", "data:"] },
    { directive = "img-src", domains = ["'self'", "https://*", "data:"] },
    { directive = "script-src", domains = ["'self'"] },
    { directive = "style-src", domains = ["'self'"] },
    { directive = "frame-src", domains = ["player.vimeo.com", "https://www.youtube-nocookie.com"] },
]

Esta función está habilitada por defecto. Para deshabilitarla (y permitir todo), configura enable_csp = false en una página, sección o globalmente. La opción enable_csp sigue la jerarquía.

Para obtener más información, consulta la página de documentación de CSP.

Indieweb

h-card representativa

Por defecto, tabi añade una h-card representativa oculta a la página de inicio. Aunque es invisible para los visitantes, está disponible para los analizadores de microformatos. Puedes comprobar la validez de la tarjeta con la herramienta Indiewebify.me.

Para desactivar la h-card, establece enable = false en la sección [extra.hcard] de config.toml.

La h-card predeterminada incluye tu nombre, la URL del sitio web y los enlaces a redes sociales.

Puedes establecer una imagen de perfil y una pequeña biografía con los ajustes avatar y biography.

Todas las demás propiedades de h-card se pueden añadir listándolas en la sección [extra.hcard] del archivo de configuración. Simplemente reemplaza todos los caracteres - por _.

Extendiendo elementos HTML en tabi

Algunos elementos HTML en tabi pueden extenderse para admitir casos de uso adicionales, como agregar JavaScript personalizado para comportamientos en todo el sitio al final de la etiqueta <body> o incluir contenido adicional al final del elemento <head> que no esté soportado por otras configuraciones de tabi.

Consulta la tabla a continuación para ver los elementos que pueden extenderse:

No hay configuraciones explícitas que debas establecer para tu sitio o páginas. Simplemente crea el archivo de plantilla correspondiente para tu sitio, y tabi lo incluirá automáticamente.