Can’t smash the Like button hard enough for what Miriam Suzanne has to say on the challenging technical hurdles of implementing Webmentions:
The first round required several online services along with HTML & JS changes to my static site, just to verify my indieweb identity. Then more changes to the site and more online services to help fetch any mentions
(so far, nothing to see, but that’s probably expected). It seems the only way to test the setup is to launch all those changes publicly, and then ask for other devs to send you mentions.[…]
I’m an experienced web developer, and I can figure it out. But the steps aren’t simple, and most of my friends are not web developers. So, to me, this all feels like the prototype of an idea – a proof of concept.
A proof of concept for sure. And one that has been around for quite some time. The IndieWeb idea of owning your own data and using your website as a social hub is right up my alley — and likely yours, too, as someone working on the front end.
Update! David Shanske is one of the developers of the WordPress plugins that support IndieWeb features and he not only published a wonderful explanation of how everything fits together, but also reached out directly and helped me wrap it all around my head.
Yet, I’ve tinkered on and off with it — specifically Webmentions — over the past like three years with little to show for it. The problem isn’t so much the documentation of getting started because it’s all there. It’s more a combination of things…
- The wiki is confusing. Wikis are super cool in general, but the non-linear nature of it makes it tough to know where to start and where to end.
- The plugin ecosystem is complex. My personal site is on WordPress and there’s a plugin designed to make it easy to integrate IndieWeb features on it. Except that it’s really one plugin that steers you to install several others, each one introducing a technology that I honestly struggle to understand.
- There’s a bunch of terms to learn. I mean, “IndieWeb” and “Webmention” are already difficult to grok. Toss in things like “Micropub,” “Microformats,” “IndieAuth,” and “Semantic Linkbacks,” and suddenly it feels like a bunch of puzzle pieces from different puzzles trying to fit together.
- Some middleware seems necessary? For example, I had to give a service called Bridgy access to my Twitter to get that activity going. It apparently has something to do with Twitter’s shortened
t.coURLs and making them play well with microformats.
But, like Miriam, I struggled my way through it and got something working in the end. This is the sort of visual I wish I had when I was first getting started, and maybe it’ll help you too.
Feels like a lot to get Webmentions going, but maybe that’s only because I have such a light grasp of the tech and how it all fits together. All the pieces are there, though, and even with the initial struggle, I love the IndieWeb concept, er prototype.
I’ve been trying to make my own personal site to comply to Indieweb requirements and I share yours and miriamsuzanne’s experience. With this level of complication the Indieweb will never really take-off. As in: my grandma is on the Indieweb to ;-) My biggest grieve with the Indieweb wiki is that it is very opinionated about things, like considering object oriented programming an anti pattern.
But then again, I too love the concept of Indieweb and the group of people who bother to maintain the Indieweb-stuff seems to be quite small. With a little more help maybe things get less complicated.
While I agree with the sentiment, as a non-hardcore designer/developer I can safely say it’s less complicated than it looks. Especially given the fact that I was able to fully implement webmentions on my static website (Jekyll).
Except for Micropub, which is totally optional for an Indieweb-enabled website, not all those plugins are required if you know how to edit WordPress templates.
In that case, adding a few lines to the header php file and edit the post template to accommodate Microformats is quite feasible. Once you get the grasp of what needs to be done – I said I agreed with the sentiment: that’s why it took me a while to do it :D
A bit of write-up about how I did it, in the correct order: https://minutestomidnight.co.uk/blog/indieweb-and-webmentions-for-my-static-site/