💾 Archived View for gemini.smallweb.space › antenna › about.gmi captured on 2024-05-26 at 14:33:31. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2023-11-14)
-=-=-=-=-=-=-
/\ \ \ @ /\_\/ _|_ _|___|___ DSN ANTENNA
DSN Antenna is a copy of the original Antenna by @ew0k. The intent is to transmit (aggregate) posts of a non-computer-related nature. This was a need identified by the community since the non-technical geminauts were seemingly lost in a sea of technical how-to's. Most gemlogs have some regular posts in them, but you have to hunt for them, hence, DSN Antenna is here to simplify this search.
1. Create a separate gemlog that avoids computer-related technical explanations, and submit it to DSN Antenna (see below)
2. Use Bubble by @skyjake, and submit your individual posts via the "Submit to DSN Antenna" option. This has the advantage of being able to be selective on which individual posts you want to submit to DSN Antenna
This version of Antenna was originally created because the original by ew0k has been down. I hadn't seen their gemlog post saying it'd be down and @skyjake and @solderpunk made mention on #BBS that a new instance could be made...so that's what I set out to do. After the main Antenna came back up @solderpunk asked me if I would theme it, and after some thought decided upon a non-technical 'deep thoughts' type theme for the site to spread non-technical "humanity" to the deep space network.
This is a feed aggregator with a twist. It doesn't have a list of feeds that it repeatedly checks. Instead it takes feed URLs as user input and puts them in a queue. The queue is checked every five minutes, and an attempt to ingest each feed is made. Once a feed has been ingested it's removed from the queue and thus forgotten.
If you want an Atom, RSS, gemsub, or twtxt feed featured here then call gemini://gemini.smallweb.space/antenna/submit?<URL to your feed> each time it's updated! This way Antenna will only fetch feeds that are active. No more useless hammering of dead feed files.
The URL to a twtxt file is submitted the same way as any other feed, but twtxt posts end up on their own page in order to not clutter the gemlog listing.
Here's the gmi page for twtxt posts.
And here's a plain text version, similar to the output from a twtxt registry.
A common convention in the twtxt world is to add metadata in comments (lines beginning with #), such as a description or avatar URL. Antenna recognizes one such data field:
# nick = Your Nickname
This is not by any means mandatory. In its absence the URL to the file will be written twice instead, since it's used for both the nickname field and the URL field. It is the only way to inform Antenna of your preferred nick, however.
Keep in mind that this service runs on limited hardware, and that my internet connection historically has had a whole lot of issues. And that I'm learning python3 as I go. If a feed you submitted once didn't show up it's likely that Antenna failed to fetch or parse it, and the error checks and recovery I have in place are insufficient.
Some common errors that make Antenna fail include:
"But, ew0k, I don't have control over my publishing flow! I'm on a hosted service, or using a tool I can't modify."
Fear not! As the submission call is always the same, and you don't even need an Atom/RSS feed, you can just follow this superb advice:
"[...] have an unlisted page on your gemlog that has a link to antenna with the querystring pre-populated" - ~palm93
"I have this one long page that I update with new microblog entries, and it doesn't follow any of those formats. What do I do?"
Well, let's say you have a page /microblog.gmi then make another (let's say /feed.gmi) with something like this content:
# Your Name => microblog.gmi YYYY-MM-DD Microblog
Update the timestamp when you've added something to /microblog.gmi and submit the URL to /feed.gmi to Antenna.
"The ordering of entries sometimes change a bit randomly."
Yes and no. The page is regenerated whenever it has fetched and parsed a feed, even if it already had all those entries. Gemsub entries only have a date, meaning that all entries fetched from gemsub feeds marked with the same date have no specific order relative to each other. It depends on how SQLite3 gives them back when sorting by timestamp.
Use this service responsibly. I take the liberty to refrain from fetching feeds or display entries from URLs that I or someone I trust have found unsavory, hateful, illegal, harmful, or just gives me really bad vibes. This is a fun passion project for me; I'll keep it up as long as I still find it fun, and I'll try to keep it fun for myself. If you submit a feed and find that it never updates this could be why. Remember that there's a human factor here, and I can't guarantee that I'll be consistent or correct in my judgements.
Reach out to me if you have questions or suspect human errors or bugs in the process!
gritty@smallweb.space
Cheers,
Gritty