I tried creating a better description for retejo.

#retejo

I tried creating a better description for retejo.

#retejo

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

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

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