#retejo — Public Fediverse posts

9/

A regular users might write Markdown like this:

"""
# Hello!

How do you do?
"""

Or write HTML like this:

"""
<article>
<h1>Hello!</h1>
<p>How do you do?</p>
</article>
"""

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

8/

REMEMBER: this is for power-users, not regular users

How would you get ActivityPub / ActivityStreams into HTML using RDFa‽

Like this:

<div vocab="https://www.w3.org/ns/activitystreams#" typeof="Note">
<p property="name">Hello!</p>
<p>How do you do?</p>
</div>

AGAIN, REMEMBER: this is for power-users, not regular users.

Regular users can just write Markdown or HTML and Retejo will figure this out automatically for you

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

7/

If you are wondering what RDFa is —

You might be more familiar with OpenGraph.

https://ogp.me/

OpenGraph is usually the thing that causes "preview cards" to be showed for links shared on social-media.

OpenGraph is written in RDFa. Which, in practice, is some special HTML elements added to the page.

For example:

<meta property="og:image" content="https://example.com/img/preview.png" />

So what about ActivityPub‽ —

#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

2/

"forgejo" comes from the Esperanto word "forĝejo".

"retejo" is (also) an Esperanto word.

The meaning of the Esperanto word "retejo" can be understood as follows:

ret-: The root for "net" or "web".
-ej-: A suffix meaning "place" or "site".
-o: The noun ending.

https://codeberg.org/reiver/retejo

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

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

1/

If you are curious about where the "Retejo" name comes from —

The way the name "retejo" was chosen was inspired by how the name "forgejo" chosen.

...

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

#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

2/

Retejo pulls its data from a Forgejo / Gitea site — such as Codeberg.

That means I can write things using whatever text-editor I want by editing a file.

And then push that file to Codeberg — or any other Forgejo / Gitea site — using git

And then, it automatically shows up on my Retejo site

https://codeberg.org/reiver/retejo

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

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

1/

Another motivation for creating Retejo is this:

https://mastodon.social/@reiver/114076598430655105

I want to be able to write long-form articles using whatever text-editor I choose to use, editing a file, and using git.

Not everyone will want to create long-form content this way — but I want to create long-form content this way.

...

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

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

3/

I kept that type of user in mind when designing Retejo —

That some people want to write in Markdown rather than HTML.

So, Retejo has native support for Markdown.

And, in particular, CommonMark with the GitHub Flavored Markdown (GTM) extensions that most people expect nowadays.

https://codeberg.org/reiver/retejo

.

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

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

2/

One thing I noticed about the Gemini-Protocol community is that —

Some of the people who are attracted to Gemini are attracted to it, because — they want a Web that was based on Markdown instead of HTML.

And, the Gemini-Protocol + gemtext seemed close to being a Markdown-based Web.

https://mastodon.social/@reiver/111180217090707425

...

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

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

1/

One of my other passions, in addition to the Fediverse and Social Web, is — small-net.

One of the popular protocols in small-net is — the Gemini-Protocol.

https://geminiprotocol.net/

...

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

#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

Ĉu mia retejo estas blogo aŭ ne? :gutkato_pensas:

Por mi, blogo ĉiam estis fluo de artikoloj ordigitaj en unu vico laŭ dato, skribitaj kun la intenco, ke ili estu parto de unu tuto: la blogo. Oni supozu, ke la leganto ĉiam trovos kaj legos ilin ene de la blogo, por kiu ili estis skribitaj. :gutkato_libro:

Mi fojfoje afiŝas verkojn, sed mi apartigas ilin al diversaj kategorioj. Mia intenco estas, ke la verkoj estu memstaraj; se iu prenus mian poemon, rakonton, aŭ eseon, kaj metus ĝin aliloken, tio ne impresus strange, ĉar mi kutime skribas ilin kiel memstarajn verkojn, ne supozante, ke la leganto legos ĝin en mia retejo, ene de unu kohera fluo. :gutkato_flucerba:

Freŝdate mi pripensis aldoni novan kategorion al la retejo, nomi ĝin »Blogo«, kaj uzi ĝin laŭ mia supre menciita difino de blogo. Sed mi ne certas, ĉu tio ne estus konfuza, ĉar iuj homoj jam nomis mian nunan retejon blogo. Komentoj kaj opinioj estas tre bonvenaj! :gutkato_hihias:

#lang_eo #blogo #blogoj #demandoj #enketo #enketoj #retejo #retejoj #vivo

Mi pasigis la matenon skribante testojn por mia nova programo, kaj kia bona malŝparo tio estis!
Mi sentas tiom sekura, ĝuste nun! :gutkato_kontenta:

Mi malkutimiĝis al testoskribado antaŭ longa tempo — mi rekutimiĝu! :gutkato_fajrokuloj:

#lang_eo #programado #lispo #retejo #reto #lignukso #gnu #linukso

@marcxjo Jes, mi lernis Esperanton en 1995 (antaŭ tio mi dum kelkaj jaroj estis eterna komencanto). Mia #retejo estas en tri lingvoj, en tiu nombro #Esperanto.

Mi membris en #UEA en 1996—2005, en TEJO en 1996—2003, kaj en 1998—2003 mi estis junulara delegiito.

Foje mi redaktas Vikipedion, en tiu nombro Vikipedion en Esperanto. Mi tradukis en Esperanton pli ol cent vikipediajn artikolojn (plejparte el la rusa, kelkajn el la angla). Jen unu el ili: https://eo.wikipedia.org/wiki/David_Mentelli.

#Vikipedio #traduko

Mi aldonis al mia TTT-ejo reagan paĝon, rezulton de du semajnoj de mia laboro. Se iu ne scias, mia TTT-ejo estas disponebla ĉe https://fishk.in/eo/ kaj ne enhavas kodon en JavaScript.

#lang_eo #eo #Gamliel #Fiŝkin #Interreto #TTT #TTTejo #retejo