@reiver ⊼ (Charles) :batman:
1/
It doesn't take much effort to make your website join the Fediverse and the open social-web IN A VERY BASIC WAY,.
And by "VERY BASIC WAY" I mean — being able to look up your website using a Fediverse ID and have a profile show up.
I did it for my (new) personal website last night.
(Screenshot of the profile Mastodon shows for my (new) personal website attached.)
NOTE: DO NOT FOLLOW IT YET. FOLLOWING DOESN'T WON'T WORK YET.
...
All I had to do was —
🧵
@reiver ⊼ (Charles) :batman:
2/
The first thing I did was make WebFinger work on my (new) personal website.
(I.e., "/.well-known/webfinger".)
Which needs to return JSON similar to what is in the attached screenshot.
(And also best return a "Content-Type: application/jrd+json".)
...
Your implementation would replace "subject" and "href" with your own values.
...
So, next —
@reiver ⊼ (Charles) :batman:
3/
The next thing I did was make that "self" URL I returned from WebFinger work.
It needs to return something like what is in the attached screenshot.
...
There is a lot there, but what is there is straightforward.
I will go into what it means in a practical sense —
@reiver ⊼ (Charles) :batman:
4/
"preferredUsername" is your Fediverse handle (without the host).
"name" is your name.
"summary" is the text for your profile's (short) bio.
"attachement" are a list of name-value pairs you set on your profile. I used it just for a "Location". You could create a list of them.
"published" is the date when you joined the Fediverse.
...
@reiver ⊼ (Charles) :batman:
5/
"url" is the URL of the version of your profile someone would go to to see it in a web-browser. (Since this is a my (new) personal website is a solo single-user site, I set it to my home-page.)
You can just set "id" to whatever URL you returned from WebFinger (for the "self" URL).
"icon" is the profile avatar image.
"image" is the banner image on your profile.
...
@reiver ⊼ (Charles) :batman:
6/
And then there are a bunch of new URLs in there.
"following", "followers", "icon.url", "image.url"., "inbox".
We need to make those work, too.
So let's do that —
@reiver ⊼ (Charles) :batman:
7/
Making "icon.url" and "image.url" (from the "self" URL) work are straight forward —
They are just images — the avatar image and banner image respectively.
Upload those images somewhere. (It doesn't have to be the same place I put mine.)
And make the JSON returned from your "self" URL return the URLs to wherever you uploaded your avatar image and banner image.
...
@reiver ⊼ (Charles) :batman:
8/
So now let's look at making the "following" and "followers" URLs work.
...
@reiver ⊼ (Charles) :batman:
9/
This (in the attached screenshot) is what I return from my "following" URL.
...
For your implementation —
"totalItems" is probably the most interesting thing in there at this point — that is the number of people you follow.
(A full implementation would get this number from the actual number of people you follow. But this VERY BASIC implementation can just put whatever number you want.)
Just set "id" whatever URL you have for "following".
...
@reiver ⊼ (Charles) :batman:
10/
For your implementation —
The URL for "first" will eventually matter — but not yet.
I didn't implement it. It you go to it right now it will return a "404 Not Found".
But — that seems to be OK if all you want to do is — look up your website using a Fediverse ID and have a profile show up.
...
GNU social JP is a social network, courtesy of GNU social JP管理人. It runs on GNU social, version 2.0.2-dev, available under the GNU Affero General Public License.
All GNU social JP content and data are available under the Creative Commons Attribution 3.0 license.