feat(indieweb): add hidden h-card (#506)

Co-authored-by: welpo <welpo@users.noreply.github.com>
This commit is contained in:
Henri Bourcereau 2025-04-05 14:10:16 +02:00 committed by GitHub
parent a384ac80c8
commit 94af15b6e8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 188 additions and 4 deletions

View file

@ -1,7 +1,7 @@
+++
title = "Mastering tabi Settings: A Comprehensive Guide"
date = 2023-09-18
updated = 2025-02-16
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 (`/`)**
@ -1018,6 +1018,26 @@ See the [CSP documentation page](@/blog/security/index.md) for more information.
---
## Indieweb
### Representative h-card
| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript |
| :--: | :-----: | :-----------: | :---------------: | :-----------------: |
| ❌ | ❌ | ✅ | ❌ | ❌ |
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.
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 `_`.
---
[^1]: If you're using a remote Git repository, you might want to automate the process of updating the `updated` field. Here's a guide for that: [Zola Git Pre-Commit Hook: Updating Post Dates](https://osc.garden/blog/zola-date-git-hook/).
[^2]: To encode your email in base64 you can use [online tools](https://www.base64encode.org/) or, on your terminal, run: `printf 'mail@example.com' | base64`.