There are examples of the #ActivityPub extensions #Bookwyrm makes, which are on the (commonly taken) path of protocol decay and whack-a-mole programming by their #LinkedData non-conformance, unfortunately.

Yet that means there's opportunity for #FEP's if there are more #interoperability parties. 😃

Here's an example of Quotation, which has no LD context:

https://github.com/bookwyrm-social/bookwyrm/blob/main/bookwyrm/tests/data/ap_quotation.json

And here of Edition which is incorrectly placed in #ActivityStreams context:

https://github.com/bookwyrm-social/bookwyrm/blob/main/bookwyrm/tests/data/bw_edition.json

4/

Apparently, Bookwyrm stores quotations with:

type="Quotation"

And if one Bookwyrm server talks to another Bookwyrm server, then — the ActivityPub / ActivityStreams representation of the quotation will have:

type="Quotation"

...

BUT — if a non-Bookwyrm server talks to a Bookwyrm server, then — the ActivityPub / ActivityStreams representation of the quotation will have:

type="Note"

#ActivityPub#ActivityStreams#FediDev#Fediverse#ObjectTypeNote#ObjectTypeQuotation

Quotations & the Fediverse / ActivityPub

1/

One thing I used to do a lot on social-media is — post quotations.

Sometimes I was reading a book. And, I would quote things from the book and post it on social-media.

Or I was reading a scholarly paper, or reading a blog post, or watching a video, or listening to a podcast, etc.

...

I was thinking — how could you represent a quotation in ActivityPub‽

#ActivityPub#ActivityStreams#FediDev#Fediverse#ObjectTypeNote#ObjectTypeQuotation

4/

Apparently, Bookwyrm stores quotations with:

type="Quotation"

And if one Bookwyrm server talks to another Bookwyrm server, then — the ActivityPub / ActivityStreams representation of the quotation will have:

type="Quotation"

...

BUT — if a non-Bookwyrm server talks to a Bookwyrm server, then — the ActivityPub / ActivityStreams representation of the quotation will have:

type="Note"

#ActivityPub#ActivityStreams#FediDev#Fediverse#ObjectTypeNote#ObjectTypeQuotation

3/

Apparently the Bookwyrm developer had the exact same idea!

(Which isn't too surprising.)

Here is how it works —

...

#ActivityPub#ActivityStreams#FediDev#Fediverse#ObjectTypeNote#ObjectTypeQuotation

2/

How could you represent a quotation in ActivityPub‽

...

I suppose there are 2 major approaches.

Either use an existing Object Type. Maybe:

type="Note"

Or create a new Object Type:

type="Quotation"

...

Here is the interesting thing though —

#ActivityPub#ActivityStreams#FediDev#Fediverse#ObjectTypeNote#ObjectTypeQuotation

Quotations & the Fediverse / ActivityPub

1/

One thing I used to do a lot on social-media is — post quotations.

Sometimes I was reading a book. And, I would quote things from the book and post it on social-media.

Or I was reading a scholarly paper, or reading a blog post, or watching a video, or listening to a podcast, etc.

...

I was thinking — how could you represent a quotation in ActivityPub‽

#ActivityPub#ActivityStreams#FediDev#Fediverse#ObjectTypeNote#ObjectTypeQuotation

1/

I have spending time thinking of ways you could automatically create ActivityPub / ActivityStreams data from HTML and Markdown

Most people will probably write in plain UTF-8 text, or Markdown, or HTML

How to do you take that and get it onto the Fediverse and Social Web‽

This isn't just a question of how to technically do it — but also a question of user-experience (UX)

I.e., what are "good" ways of doing it‽

...

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

6/

Obviously, beginners are NOT going to do this, but — some power-users may want this level of control.

There are different way this could be done, but — one way might be that power-users could use RDFa to explicitly specify what data from the HTML gets into the ActivityPub / ActivityStreams data.

Again, beginners and typical users would NOT do this.

But a power-user might want to.

Here is an example —

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

5/

So, what would be a good user-experience (UX) for power-users be — in a system that automatically creates ActivityPub / ActivityStreams data from HTML and Markdown‽

One thought I had is that power-users could explicitly mark what data from their HTML gets into the ActivityPub / ActivityStreams data (if they want to).

I'll explain —

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

4/

I think one mistake some software does is — they create a good experience for beginners, but have a poor experience for power-users.

And keep in mind that — some beginners become power-users later on.

I think it is important to design for power-users, too, in addition to beginners.

...

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

3/

If a typical user is writing in Markdown, and their Markdown file has a level-1 heading right at the beginning, then —

That could go into the ActivityPub "name" field.

And, similar could be done for HTML, too.

...

But what about power users —

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

2/

What are "good" ways of automatically creating ActivityPub / ActivityStreams data from HTML and Markdown‽

I think the answer depends on who, for example, is writing HTML, and how they are writing it.

For example, is this a typical user? Is this a power-user? Do they know HTML? And if they do know HTML, how well do they know it? Etc?

I will show you what I mean —

...

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

1/

I have spending time thinking of ways you could automatically create ActivityPub / ActivityStreams data from HTML and Markdown

Most people will probably write in plain UTF-8 text, or Markdown, or HTML

How to do you take that and get it onto the Fediverse and Social Web‽

This isn't just a question of how to technically do it — but also a question of user-experience (UX)

I.e., what are "good" ways of doing it‽

...

#ActivityPub#ActivityStreams#FediDev#Fediverse#Markdown #retejo#RDFa

Retejo

I have been working on a new type of web-server for serving static web-sites.

I started working on it recently — on August 23rd. But, have had the idea for it for a number of years.

...

What is different about this web-server for static web-sites‽

Well, of course, it supports HTML.

But, it also supports Markdown, and ActivityPub natively!

https://codeberg.org/reiver/retejo

#ActivityPub#ActivityStreams #codeberg #forgejo #gitea #markdown #retejo#StaticSite#StaticWeb#StaticWebSite

1/

Probably the biggest thing that motivated me to create Retejo now (as I've had the idea for this for a number of year) is —

...

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub#ActivityStreams #codeberg #forgejo#GeminiProtocol #gitea #markdown #retejo#SmallNet #SmallWeb#StaticSite#StaticWeb#StaticWebSite

4/

So, I thought — what if I just ran my own web-server to server files from Codeberg.

And thus, Retejo was born.

https://codeberg.org/reiver/retejo

...

But, while I am at it, I can also add automatic ActivityPub / ActivityStreams support to it.

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub#ActivityStreams #codeberg #forgejo#GeminiProtocol #gitea #markdown #retejo#SmallNet #SmallWeb#StaticSite#StaticWeb#StaticWebSite

3/

№1:

The software powering Codeberg Pages seems like it isn't being maintained anymore beyond minor fixes

№2:

Although Codeberg is pretty reliable, Codeberg Pages doesn't that reliable.

...

So, I thought —

...

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub#ActivityStreams #codeberg #forgejo#GeminiProtocol #gitea #markdown #retejo#SmallNet #SmallWeb#StaticSite#StaticWeb#StaticWebSite

2/

Although I've had a Codeberg account for a number of years — I recently started the process of migrating over to Codeberg (from GitHub).

Codeberg has something similar to GitHub Pages — called Codeberg Pages

https://codeberg.page/

However —

...

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub#ActivityStreams #codeberg #forgejo#GeminiProtocol #gitea #markdown #retejo#SmallNet #SmallWeb#StaticSite#StaticWeb#StaticWebSite