One of my motivations for creating Retejo is for note taking.
I.e., something like a Fediverse & Social-Web version of Obsidian or Roam Research.
#Fediverse #retejo #SocialWeb
0
0
0
0
Hashtag
#retejo
Advertisement · 728 × 90
# retejo **retejo** is a next-generation single-user **static web-site server**, that is designed to work with any **forgejo** server (such as Codeberg) and provides built-in support for **Markdown** and the **Social Web** (i.e., **ActivityPub**, **ActivityStreams**, the **Fediverse**, etc). You can think of **retejo** as an alternative to **Codeberg Pages** and **GitHub Pages**. One nice thing about **retejo** is that, it isn't just a **web-site server**, but it is a **SOCIAL web-site server**. **retejo** automatically supports the **Social Web** (i.e., **ActivityPub**, **ActivityStreams**, the **Fediverse**, etc). Thus, for example, if you create an article on your **retejo** site, then it will automatically be a first-class object on the **Social Web** and the **Fediverse**. ## Who Here are some types of people who may want to use **retejo**: * users of **Codeberg** who want an alternative to **Codeberg Pages** * users of a **Forgejo** server who want something similar to **GitHub Pages** * people who want to write web-pages in **Markdown** rather than **HTML** * fans of the **gemini-protocol**, **small-net**, or **small-web**, who feel that creating wep-pages in **Markdown** (and limiting the HTML elements used) is _close enough_ * people who want what they post on their static web-site to automatically show up on the **Fediverse** and the broader **Social Web** — i.e.,a more powerful version of POSSE (_Publish (on your) Own Site, Syndicate Elsewhere_)
I tried creating a better description for retejo.
#retejo
0
1
0
0
<q-quotation> <blockquote> <p> Yesterday I was clever, so I wanted to change the world. Today I am wise, so I am changing myself. </p> </blockquote> <q-citation> ⸺ <q-creator>Rumi</q-creator> </q-citation> </q-quotation>
I wonder if custom HTML elements would be better.
(Technically, custom HTML elements are supposed to have a hyphen in them, which is why they are named like that.)
That might be a better UX for those willing to write HTML than HTML + RDFa.
RE […]
[Original post on mastodon.social]
0
0
0
0
<div vocab="http://purl.org/dc/elements/1.1/" prefix="dc: http://purl.org/dc/elements/1.1/"> <blockquote> <p> Yesterday I was clever, so I wanted to change the world. Today I am wise, so I am changing myself. </p> </blockquote> <p> ⸺ <span property="creator">Rumi</span>, <cite property="title">The Essential Rumi</cite> </p> </div>
AFAICT, most people don't want to write in HTML. (Not directly anyways.)
But, even for the ones that do, I suspect something like this is too much to create a quotation and citation.
Only a very small group of power-users might be willing to write that type of HTML. Maybe.
0
0
0
0
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 […]
0
0
0
0
3/
Apparently the Bookwyrm developer had the exact same idea!
(Which isn't too surprising.)
...
#ActivityPub #ActivityStreams #FediDev #Fediverse #ObjectTypeNote #ObjectTypeQuotation
0
0
1
0
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 […]
0
1
2
0
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 […]
[Original post on mastodon.social]
0
1
0
0
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
0
0
0
0
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 […]
0
0
1
0
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 […]
0
0
1
0
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 […]
0
0
1
0
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 / […]
0
0
1
0
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 […]
0
1
1
0
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 […]
0
0
1
0
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 […]
0
0
1
0
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 […]
1
3
2
0
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 […]
0
0
0
0
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 […]
0
0
1
0
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 […]
0
0
0
0
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 […]
0
0
1
0
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 […]
0
0
1
0
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 […]
0
1
1
0
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 […]
0
0
0
0
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 […]
0
0
0
0
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 […]
0
1
0
0
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 […]
0
0
1
0
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 […]
0
0
1
0