GOPHERSPACE.DE - P H O X Y
gophering on gopher.black
----------------------------------------
webmentions and microsub
December 23rd, 2019
----------------------------------------

This phlog is about web stuff. Specifically it's about Indyweb
things and microformats.

I use my website https://tomasino.org as an IndieAuth [0] portal.
When logging into sites that understand the IndieWeb concept,
I provide my "Home" URL as an identifier. Then the site scrubs
through all the various links I have on that page and picks out
those that it can understand for authentication. In most cases
I get GPG and GitHub hits, though occasionally a site will support
more. I oAuth in, and bam... identified. It's pretty neat and
requires very little effort on my side.

[0] IndieAuth

There are much fancier IndieWeb doodads though, and I wanted to
start taking advantage of some. In particular Webmentions had
drawn my attention. It's a different way to handle commenting
that, honestly, reminds me of what we do here in gopherspace.
Instead of leaving a comment on a post somewhere, you just write
your own blog post and "notify" the original. The original page
can then choose whether to add a link to yours or ignore it or
whatever. Everyone maintains control of their own words and all is
well!

So I opened up the IndieWeb sites and went digging into
Webmentions [1]. I was immediately reminded why I abandonded this
the last time around. While the concept is incredibly simple, the
implementation is annoyingly complex and the terminology for
things is as bad as git [2].

[1] Webmentions
[2] Git Man Page Generator

Since my sites are all static I wasn't looking for a plugin or
even something that automatically displayed anything on the
front-end at all. I just wanted something to process webmentions
and give me a way to see that they happened. For my low traffic
sites, a Webmention-to-Email system would have been perfect.

There are a number of things out there already. Some support the
Webmention client role and others the server because--did I not
mention this?--you need webmentions set up on both sides for it to
work. So to actually do it you need reading, writing, discovery
and parsing. There are a handful of projects doing the various
points and most of them are "in development" to varying degrees.
Almost all of them have complex esoteric documentation that only
makes sense if you're already familiar with the protocol enough to
write your own software. Lovely!

There are a few 3rd party services that offer the basics without
charge. I don't know if they work or not, but that's what I ended
up trying. I really don't want to spend the whole Christmas break
figuring this stuff out. I don't expect to get many, if any,
mentions anyway. Webmention.io is the service I went with. I used
IndieAuth to log in and then grabbed the links it gave me to paste
on my various blogs. I have no idea how to "use" Webmentions from
the other side, and no idea how to test if I'm set up correctly.

I wonder if I need to IndieAuth with the blog URL itself and then
use webmention.io directly to that property only and then repeat
the process for the other site. It says I should be able to use it
on many sites though, so hopefully it's fine. Time will tell.

Webmention.io provides a microformat feed of the mentions you
receive. I was going to grab the RSS one and plug it into my RSS
reader until I noticed the mention of this other IndieWeb format,
Microsub.

Oh joy! Another one. :D

Microsub seems like an abstraction layer above microformats that
can be interpretted as feeds or notifications. RSS and Atom are
valid inputs, but so are other bits. Like other IndieWeb things,
there's a big push to separate client & servers. In this case
I found Aperture [3] as a server and I'm using a couple different
clients to see the front-end.

[3] Aperture

Most of these projects are also "in development", but they seem
functional enough that I was able to dupe my tt-rss contents over.
As I mentioned in my last post [4], I'm looking for a replacement
for that software anyway so maybe this will work out.

[4] Poisoning the Well

Eventually I'd like to run all these services myself (though
I have no desire to write the software to do so myself). I have
nginx running on this webserver already so if I can dockerize the
bits & pieces together into an IndieWeb multi-container and
reverse proxy everything that would be perfect. For now I'm
putting a pin in it. Things are good enough.

- - - - -

Are any of you running IndieWeb goodness? Have thoughts or
suggestions? Wanna vent? Send me a mention in the lovely gopher
style!