YAHR Matey

Companion documentation for Yet Another Homelab Repo

How To: Join a WebRing



Sharing

One of the reasons for this blog was to share how to do various homelab stuff with Linux, and we can't count on search engines to do that.

Hopefully these posts will reach someone who is looking for them!

WebRings

I've just recently found out about Webrings and I think they're wonderful.

Shout out to wheresalice.info and envs.net for having gorgeous sites.

Let's walk through joining xn--sr8hvo.ws as an example. I expect my ring memberships to evolve over time like this blog, but this was the first ring that I was introduced to the concept through so I'm givin it some love \<3

There are two steps to joining:

  • Provide the <link/>s or <a/>s in your site's source
  • Validate with the websites listed at the bottom of indieweb.org wiki

Joining & Validating with the IndieWeb

I wanted to use Codeberg as my IdP for this, so I used indielogin.com.

Since I'm using Codeberg, I added the following to my footer in an appropriate location:

<link href="https://codeberg.org/spont" rel="me">

Get your updates published, copy your URL, and head over to https://indielogin.com/ and enter your URL to validate that it's working.

Note: You cannot get away with providing just the <link rel='me'/> element, you'll need some sort of identity to link to; I chose my Codeberg user.

Add an h-card span that points to your social(s) or Codeberg user. Be sure to add the proper classes that the specs call for:

<span class="h-card">
    <a href='https://codeberg.org/spont' rel='me' class='u-url u-uid'>codeberg.org/spont</a>
</span>

That should satisfy the indieweb authentication requirements.

Test your URL again to make sure that it's valid.

It should be a relatively simple change, you can see mine in their entirety:

            <link href="https://codeberg.org/spont" rel="me">
            <div class="social-links">
                <div class="codeberg-social-link">
                    <span class="h-card">
                        <a href='https://codeberg.org/spont' rel='me' class='u-url u-uid'>codeberg.org/spont</a>
                    </span>
                </div>
            </div>

Joining a Webring

Now that we've got our public identity, we can join a Webring with it.

Head over to https://xn--sr8hvo.ws/ and enter your URL.

This will:

  • Authenticate you with the IndieWeb
  • Check statuses of both your:
  • IndieWeb Profile status
  • IndieWeb Webring Links

It will also provide you with some HTML to add so that you can integrate your site into the Webring!

My full footer looks like:

    <footer class="article__meta">
        <link href="https://codeberg.org/spont" rel="me">
        <div class="social-links">
            <div class="codeberg-social-link">
                <span class="h-card">
                    <a href='https://codeberg.org/spont' rel='me' class='u-url u-uid'>codeberg.org/spont</a>
                </span>
            </div>
        </div>
        <div class="webring-links">
            <a href="https://xn--sr8hvo.ws/previous">←</a>
            An <a href="https://xn--sr8hvo.ws">IndieWeb Webring</a> πŸ•ΈπŸ’
            <a href="https://xn--sr8hvo.ws/next">β†’</a>
        </div>
    </footer>

Summary

We now have our website plugged into a network of others and a great new source of entertainment exploring these pages and their design.

You did it, yay!