From 60824174fe8ec1c9e3b3a0b277e8479944892153 Mon Sep 17 00:00:00 2001 From: welpo Date: Sat, 5 Apr 2025 00:01:16 +0200 Subject: [PATCH] Update docs --- .../blog/mastering-tabi-settings/index.ca.md | 22 ++++++++++++++++++- .../blog/mastering-tabi-settings/index.es.md | 22 ++++++++++++++++++- content/blog/mastering-tabi-settings/index.md | 10 +++++---- 3 files changed, 48 insertions(+), 6 deletions(-) diff --git a/content/blog/mastering-tabi-settings/index.ca.md b/content/blog/mastering-tabi-settings/index.ca.md index 74f62f4..4ce5225 100644 --- a/content/blog/mastering-tabi-settings/index.ca.md +++ b/content/blog/mastering-tabi-settings/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Domina la configuració de tabi: guia completa" date = 2023-09-18 -updated = 2025-02-16 +updated = 2025-04-05 description = "Descobreix les múltiples maneres en què pots personalitzar tabi." [taxonomies] @@ -1007,6 +1007,26 @@ Per a més informació, consulta la [pàgina de documentació de CSP](@/blog/sec --- +## Indieweb + +### h-card representativa + +| Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | +| :--: | :-----: | :-----------: | :---------------: | :-----------------: | +| ❌ | ❌ | ✅ | ❌ | ❌ | + +Per defecte, tabi afegeix una h-card representativa [h-card](https://microformats.org/wiki/h-card) **oculta** a la pàgina d'inici. Tot i que és invisible per als visitants, està disponible per als analitzadors de microformats. Pots comprovar la validesa de la targeta amb l'eina [Indiewebify.me](https://indiewebify.me/validate-h-card/). + +Per desactivar l'h-card, estableix `enable = false` a la secció `[extra.hcard]` de `config.toml`. + +L'h-card predeterminada inclou el teu nom, l'URL del lloc web i els enllaços a les xarxes socials. + +Pots establir una imatge de perfil i una petita biografia amb els paràmetres `avatar` i `biography`. + +Totes les altres [propietats h-card](https://microformats.org/wiki/h-card#Properties) es poden afegir llistant-les a la secció `[extra.hcard]` del fitxer de configuració. Simplement substitueix tots els caràcters `-` per `_`. + +--- + [^1]: Si estàs utilitzant un repositori Git remot, potser voldràs automatitzar el procés d'actualització del camp `updated`. Aquí tens una guia per a això: [Zola Git Hook: actualitzant les dates de les publicacions](https://osc.garden/ca/blog/zola-date-git-hook/). [^2]: Per a codificar el teu correu electrònic en base64 pots utilitzar [eines en línia](https://www.base64encode.org/) o, al teu terminal, executar: `printf 'mail@example.com' | base64` diff --git a/content/blog/mastering-tabi-settings/index.es.md b/content/blog/mastering-tabi-settings/index.es.md index e999216..5fcefd4 100644 --- a/content/blog/mastering-tabi-settings/index.es.md +++ b/content/blog/mastering-tabi-settings/index.es.md @@ -1,7 +1,7 @@ +++ title = "Domina la configuración de tabi: guía completa" date = 2023-09-18 -updated = 2025-02-16 +updated = 2025-04-05 description = "Descubre las múltiples maneras en que puedes personalizar tabi." [taxonomies] @@ -1008,6 +1008,26 @@ Para obtener más información, consulta la [página de documentación de CSP](@ --- +## Indieweb + +### h-card representativa + +| Página | Sección | `config.toml` | Sigue Jerarquía | Requiere JavaScript | +| :--: | :-----: | :-----------: | :---------------: | :-----------------: | +| ❌ | ❌ | ✅ | ❌ | ❌ | + +Por defecto, tabi añade una [h-card](https://microformats.org/wiki/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](https://indiewebify.me/validate-h-card/). + +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](https://microformats.org/wiki/h-card#Properties) se pueden añadir listándolas en la sección `[extra.hcard]` del archivo de configuración. Simplemente reemplaza todos los caracteres `-` por `_`. + +--- + [^1]: Si estás utilizando un repositorio Git remoto, es posible que quieras automatizar el proceso de actualización del campo `updated`. Aquí tienes una guía para eso: [Zola Git Hook: actualizando las fechas de las publicaciones](https://osc.garden/es/blog/zola-date-git-hook/). [^2]: Para codificar tu correo electrónico en base64 puedes utilizar [herramientas en línea](https://www.base64encode.org/) o, en tu terminal, ejecutar: `printf 'mail@example.com' | base64` diff --git a/content/blog/mastering-tabi-settings/index.md b/content/blog/mastering-tabi-settings/index.md index 93afe42..c212e5e 100644 --- a/content/blog/mastering-tabi-settings/index.md +++ b/content/blog/mastering-tabi-settings/index.md @@ -1,7 +1,7 @@ +++ title = "Mastering tabi Settings: A Comprehensive Guide" date = 2023-09-18 -updated = 2025-04-02 +updated = 2025-04-04 description = "Discover the many ways you can customise your tabi site." [taxonomies] @@ -113,7 +113,7 @@ The description is regular Markdown content, set outside the front matter. #### Listing Recent Posts -To show posts on your main page, you first need to decide where these posts will be served from: the root path (`/`) or a subdirectory (e.g., `/blog`). +To show posts on your main page, you first need to decide where these posts will be served from: the root path (`/`) or a subdirectory (e.g., `/blog`). **Option A: Serve posts from the root path (`/`)** @@ -1026,12 +1026,14 @@ See the [CSP documentation page](@/blog/security/index.md) for more information. | :--: | :-----: | :-----------: | :---------------: | :-----------------: | | ❌ | ❌ | ✅ | ❌ | ❌ | -Tabi adds a representative [h-card](https://microformats.org/wiki/h-card) to the homepage out of the box. It is hidden to the naked eye, but remains visible by microformat parsers. You can check the validity of the card with the [Indiewebify.me](https://indiewebify.me/validate-h-card/) tool. +By default, tabi adds a **hidden** representative [h-card](https://microformats.org/wiki/h-card) to the homepage. While invisible to visitors, it's available to microformat parsers. You can check the validity of the card with the [Indiewebify.me](https://indiewebify.me/validate-h-card/) tool. -It is possible to disable the h-card by setting `enable = false` in the `[extra.hcard]` section of the config file. +To disable the h-card, set `enable = false` in the `[extra.hcard]` section of `config.toml`. The default h-card includes your name, website url and social media links. + You can set a profile picture and a small bio with the `avatar` and `biography` settings. + All other [h-card properties](https://microformats.org/wiki/h-card#Properties) can be added by listing them under the `[extra.hcard]`section of the config file. Simply replace all `-` characters by `_`. ---