From f2d13b9468564ddf0adfff558727bf42d5233c40 Mon Sep 17 00:00:00 2001 From: Jeremiah Russell Date: Tue, 11 Feb 2025 08:57:39 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(blog):=20add=20webmentions?= =?UTF-8?q?=20section=20to=20mastering=20tabi=20settings?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - introduce webmentions as per W3C standard - provide configuration and usage instructions - include links for further reading --- content/blog/mastering-tabi-settings/index.md | 33 ++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/content/blog/mastering-tabi-settings/index.md b/content/blog/mastering-tabi-settings/index.md index ab8814b..58c4234 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-02-02 +updated = 2025-02-11 description = "Discover the many ways you can customise your tabi site." [taxonomies] @@ -759,6 +759,37 @@ If you have enabled a system globally, but want to disable it on a specific page Read [the docs](@/blog/comments/index.md) for more information on the available systems and their setup. +## Webmentions + +As described by the recommended W3C standard [Webmention][1] is a simple way to notify any URL when you mention it on your site. From the receiver's perspective, it's a way to request notifications when other sites mention it. + +For static sites [webmention.io][2] hosts a webmention endpoint that can be used to receive webmentions. This feature fetches the webmentions stored at webmention.io and displays them for a page. You will need to have setup an account for your website at webmention.io. When you enable the webmention feature it will advertise your webmention.io endpoint and display the webmentions for any post using the webmention shortcut. + +### Configuration and Usage + +Enable webmentions for your site by adding the following to your `config.toml` file. A directive for CSP is required to allow the webmention.io endpoint to be used. + +```toml +[extra] +allowed_domains = [ + { directive = "connect-src", domains = [ "https://webmention.io"] }, +] + +[extra.webmentions] +enable = true +# Specify the domain registered with webmention.io. +domain = "www.example.com" +``` + +Add the shortcut on the page where you want to display the webmentions: + +``` +{{/* webmentions() */}} +``` + +[1]: https://www.w3.org/TR/webmention/#abstract-p-1 +[2]: https://webmention.io/ + ### Analytics | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript |