- Shring - lists.jdugan6240.dev

[PATCH 1/2] fix ringfairy not building
by Zunda 01 Aug '25

01 Aug '25

--- ringfairy.toml | 2 +- websites.json | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/ringfairy.toml b/ringfairy.toml index c35a12d..ff10f33 100644 --- a/ringfairy.toml +++ b/ringfairy.toml @@ -4,7 +4,7 @@ ring_description = "A small web of Unix-y personal sites." ring_owner = "Daniel Fichtinger" ring_owner_site = "https://ficd.sh" -filepath_list = "./websites.json" # Website list; should be a JSON file with 'name', 'url', etc +filepath_list = ["./websites.json"] # Website list; should be a JSON file with 'name', 'url', etc path_output = "./webring" # Generated files will be saved in this folder. path_assets = "./data/assets" # All contents of the asset folder will be copied directly into the output directory path_templates = "./data/templates" # The folder containing HTML templates to use, ie, anything with {{ tags }} diff --git a/websites.json b/websites.json index 19d3cab..602f113 100644 --- a/websites.json +++ b/websites.json @@ -51,6 +51,7 @@ "slug": "micahkepe", "about": "An assortment of my ramblings and random adventures.", "url": "https://micahkepe.com/blog/", - "owner": "Micah Kepe" + "owner": "Micah Kepe", + "atom": "https://micahkepe.com/blog/atom.xml" } ] -- 2.50.1

2 2

[PATCH] fix ringfairy not building
by Zunda 30 Jul '25

30 Jul '25

--- ringfairy.toml | 4 ++-- websites.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/ringfairy.toml b/ringfairy.toml index 5fb98e7..ff10f33 100644 --- a/ringfairy.toml +++ b/ringfairy.toml @@ -4,11 +4,11 @@ ring_description = "A small web of Unix-y personal sites." ring_owner = "Daniel Fichtinger" ring_owner_site = "https://ficd.sh" -filepath_list = "./websites.json" # Website list; should be a JSON file with 'name', 'url', etc +filepath_list = ["./websites.json"] # Website list; should be a JSON file with 'name', 'url', etc path_output = "./webring" # Generated files will be saved in this folder. path_assets = "./data/assets" # All contents of the asset folder will be copied directly into the output directory path_templates = "./data/templates" # The folder containing HTML templates to use, ie, anything with {{ tags }} -filename_template_redirect = "template.html" # This template gets reused to build the redirect pages for each site, and is ignored when building the other custom templates +filename_template_redirect = "redirect.html" # This template gets reused to build the redirect pages for each site, and is ignored when building the other custom templates client_user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" client_header = "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8" diff --git a/websites.json b/websites.json index c77451e..602f113 100644 --- a/websites.json +++ b/websites.json @@ -52,6 +52,6 @@ "about": "An assortment of my ramblings and random adventures.", "url": "https://micahkepe.com/blog/", "owner": "Micah Kepe", - "rss": "https://micahkepe.com/blog/atom.xml" + "atom": "https://micahkepe.com/blog/atom.xml" } ] -- 2.50.1

1 0

[PATCH] ringfairy fixes
by Zunda 27 Jul '25

27 Jul '25

--- {ringfairy => data}/assets/styles.css | 0 {ringfairy => data}/templates/grid.html | 0 {ringfairy => data}/templates/random.html | 0 data/templates/redirect.html | 5 +++-- ringfairy.toml | 6 +++--- 5 files changed, 6 insertions(+), 5 deletions(-) rename {ringfairy => data}/assets/styles.css (100%) rename {ringfairy => data}/templates/grid.html (100%) rename {ringfairy => data}/templates/random.html (100%) diff --git a/ringfairy/assets/styles.css b/data/assets/styles.css similarity index 100% rename from ringfairy/assets/styles.css rename to data/assets/styles.css diff --git a/ringfairy/templates/grid.html b/data/templates/grid.html similarity index 100% rename from ringfairy/templates/grid.html rename to data/templates/grid.html diff --git a/ringfairy/templates/random.html b/data/templates/random.html similarity index 100% rename from ringfairy/templates/random.html rename to data/templates/random.html diff --git a/data/templates/redirect.html b/data/templates/redirect.html index a3e01d3..2111226 100644 --- a/data/templates/redirect.html +++ b/data/templates/redirect.html @@ -3,7 +3,7 @@ <head> <meta charset="utf-8"> <meta http-equiv="refresh" content="0; url={{ url }}"> - <title>shring redirecting to {{ url }}...</title> + <title>Redirecting...</title> <style> body { @@ -13,6 +13,7 @@ </style> </head> <body> - <p>$ shring teleport <a href="{{ url }}">{{ url }}</a></p> + <p>A fairy is teleporting you to <a href="{{ url }}">{{ url }}</a>...!</p> </body> </html> + diff --git a/ringfairy.toml b/ringfairy.toml index 8377f0a..c35a12d 100644 --- a/ringfairy.toml +++ b/ringfairy.toml @@ -6,9 +6,9 @@ ring_owner_site = "https://ficd.sh" filepath_list = "./websites.json" # Website list; should be a JSON file with 'name', 'url', etc path_output = "./webring" # Generated files will be saved in this folder. -path_assets = "./ringfairy/assets" # All contents of the asset folder will be copied directly into the output directory -path_templates = "./ringfairy/templates" # The folder containing HTML templates to use, ie, anything with {{ tags }} -filename_template_redirect = "./ringfairy/templates/template.html" # This template gets reused to build the redirect pages for each site, and is ignored when building the other custom templates +path_assets = "./data/assets" # All contents of the asset folder will be copied directly into the output directory +path_templates = "./data/templates" # The folder containing HTML templates to use, ie, anything with {{ tags }} +filename_template_redirect = "redirect.html" # This template gets reused to build the redirect pages for each site, and is ignored when building the other custom templates client_user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" client_header = "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8" -- 2.50.1

1 0

[PATCH 2/2] i forgot to add ringfairy
by Zunda 27 Jul '25

27 Jul '25

--- ringfairy/assets/styles.css | 157 ++++++++++++++++++++++++++++++ ringfairy/templates/grid.html | 24 +++++ ringfairy/templates/random.html | 0 ringfairy/templates/template.html | 18 ++++ 4 files changed, 199 insertions(+) create mode 100644 ringfairy/assets/styles.css create mode 100644 ringfairy/templates/grid.html create mode 100644 ringfairy/templates/random.html create mode 100644 ringfairy/templates/template.html diff --git a/ringfairy/assets/styles.css b/ringfairy/assets/styles.css new file mode 100644 index 0000000..dcec5fb --- /dev/null +++ b/ringfairy/assets/styles.css @@ -0,0 +1,157 @@ +body { + font-family: monospace; +/* text-transform: lowercase;*/ + font-size: 18px; + line-height: 1.6; + background-color: #111; + color: #d4d4d4; + max-width: 80%; + margin: auto; +} + +h1 { + text-align: center; +} + +h1,h2,h3,h4 { + font-family: Courier New, Courier, Consolas, monospace; +} + +a { + color: #DF6464; + text-decoration: none; + background-color: transparent; +} + +a:hover, a:focus { + text-decoration: none; + background-color: #DF6464; + color: #d4d4d4; +} + +/*table { */ +/* width: 90%;*/ +/* border-collapse: collapse;*/ +/* margin: 12px auto;*/ +/* font-size: 1em;*/ +/*}*/ + + +table { + width: 100%; + border-collapse: collapse; + margin: 12px auto; + font-size: 1em; + font-family: Courier, Consolas, "Courier New", monospace; + table-layout: auto; + overflow-x: auto; + display: block; /* Enables horizontal scrolling */ +} + +tr { + margin-bottom: 10px; +} + +tr:nth-child(odd) { + background-color: #111; /* Light gray for odd rows */ +} + +tr>td:nth-of-type(4) { + white-space: normal; + overflow-wrap: break-word; + width: 100%; +} + +tr:hover { + background-color: #222; /* hover effect for table rows */ +} + +/*th, td {*/ +/* padding: 10px;*/ +/* border: 2px solid #666;*/ +/* text-align: left; */ +/* white-space: nowrap;*/ +/* overflow: hidden;*/ +/* text-overflow: ellipsis;*/ +/*}*/ + + +th, td { + padding: 6px 8px; + border: 1px solid #555; + text-align: left; + white-space: pre; /* Preserve spacing, prevent wrapping */ + overflow: hidden; + text-overflow: ellipsis; + font-family: inherit; + width: 10ch; +} + + +/*th {*/ +/* background-color: #444;*/ +/* text-align: center;*/ +/* font-size: 1.1em;*/ +/* font-family: Courier New, Courier, Consolas, monospace;*/ +/*}*/ + +th { + background-color: #333; + text-align: left; + font-weight: bold; +} + +.container { + max-width: 800px; + margin: auto; + padding: 12px; +} + +@media screen and (max-width: 600px) { + body { + font-size: 0.9rem; + } + +} +:root { + --card-border: #446868; + --card-link-color: #88bebe; +} +.cards-container { + width: 90%; + margin-left: auto; + margin-right: auto; +} +.cards-container a { + color: var(--card-link-color); +} +.cards { + display: grid; + grid-gap: 0.5rem; + grid-template-columns: repeat(auto-fit, minmax(25rem, 1fr)); +} +.card { + border: 2px solid var(--card-border); + border-radius: 0.5rem; +} +.card-name { + background-color: var(--card-border); + font-size: 1.25rem; + padding: 0.25rem; + border-radius: 0.25rem 0.25rem 0 0; + text-transform: lowercase; +} +.card-content { + padding: 0.5rem; +} +.card-link { + font-size: .95rem; + text-transform: lowercase; +} +.card-text { + font-size: 0.75rem; +} +.card-slug { + font-size: 0.75rem; +} + diff --git a/ringfairy/templates/grid.html b/ringfairy/templates/grid.html new file mode 100644 index 0000000..19b6921 --- /dev/null +++ b/ringfairy/templates/grid.html @@ -0,0 +1,24 @@ +<!DOCTYPE html> +<html lang="en"> + <link rel="stylesheet" href="./styles.css"> + <head> + <meta charset="UTF-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + <title>{{ ring_name }} List</title> + </head> + <body> + <div class="cards-container"> + <h1>{{ ring_name }} List</h1> + <p>{{ ring_description }}</p> + <p>Add all sites with declared RSS feeds to your feed reader with this <a href ="{{ opml }}">OPML</a> link.</p> + + {{ grid_of_sites | safe}} + + <br> + <footer> + <p>Last updated: {{ current_time }} </p> + <p>Powered by <a href="https://github.com/k3rs3d/ringfairy">ringfairy</a>!</p> + </footer> + </div> + </body> +</html> diff --git a/ringfairy/templates/random.html b/ringfairy/templates/random.html new file mode 100644 index 0000000..e69de29 diff --git a/ringfairy/templates/template.html b/ringfairy/templates/template.html new file mode 100644 index 0000000..0ae260d --- /dev/null +++ b/ringfairy/templates/template.html @@ -0,0 +1,18 @@ +<!doctype html> +<html lang="en"> +<head> + <meta charset="utf-8"> + <meta http-equiv="refresh" content="0; url={{ url }}"> + <title>Redirecting...</title> + + <style> + body { + background-color: #000; + color: #fff; + } + </style> +</head> +<body> + <p>A fairy is teleporting you to <a href="{{ url }}">{{ url }}</a>...!</p> +</body> +</html> -- 2.50.1

1 0

[PATCH] Rewrite faq page to look like a mock man-page. Changes capitalization to regular case to follow theming better and to improve legibility.
by Zunda 27 Jul '25

27 Jul '25

From: Lunarmagpie <Bambolambo0(a)gmail.com> --- data/templates/index.html | 11 ++-- pages/faq.md | 111 ++++++++++++++++++++------------------ 2 files changed, 63 insertions(+), 59 deletions(-) diff --git a/data/templates/index.html b/data/templates/index.html index 79b522e..419d3c4 100644 --- a/data/templates/index.html +++ b/data/templates/index.html @@ -7,12 +7,11 @@ <title>shring sh webring</title> </head> <body> - <h1>shring sh webring</h1> <p> - <code>$ man shring</code><br> + <code>$ shring about</code><br> <strong>shring</strong> (pronounced "shring", semantically "sh ring")<br> is <strong>a small web of unix-y personal sites</strong>.<br> - <strong>there are no further qualifiers</strong>. see the <a href="/faq">faq</a> for + <strong>there are no further qualifiers</strong>. please run <a href="/faq">`man shring`</a> for details.<br><br> <code>$ shring stat && shring ls --html | render</code><br> <strong><code>{{ number_of_sites }} members, built {{ current_time }} @@ -23,14 +22,14 @@ <code>$ shring feed --opml ><a href="{{ opml }}" >./shring.opml</a></code><br> <br> - <code>$ man 7 shring</code><br> + <code>$ shring tooling</code><br> shring is powered by <a href="https://github.com/k3rs3d/ringfairy" >ringfairy</a>, maintained by <a href="https://ficd.sh">daniel</a>, <a href="https://git.ficd.sh/ficd/shring" target="_blank" >open source</a>, and proudly <a href="https://no-js.club/">no-js</a>. - for information about joining, please see the <a href="/faq" - >faq</a>.<br><br> + for information about joining, please run <a href="/faq" + >`man shring`</a>.<br><br> </p> </body> </html> diff --git a/pages/faq.md b/pages/faq.md index 4373ad9..8b229ff 100644 --- a/pages/faq.md +++ b/pages/faq.md @@ -1,11 +1,7 @@ -<h1>shring faq</h1> - <center> <a href="/">return to index</a> </center> -<h3 id="toc">contents</h3> - <style> html { scroll-behavior: smooth; @@ -22,58 +18,65 @@ a { </style> +$ man shring + +<h3 id="toc">CONTENTS</h3> +  -- [what is the shring?](#what-is-the-shring) -- [what is a unix-y personal site?](#what-is-a-unix-y-personal-site) -- [what are the requirements to join?](#what-are-the-requirements-to-join) -- [do i need to use unix?](#do-i-need-to-use-unix) -- [can my site have javascript?](#can-my-site-have-javascript) -- [how can i join?](#how-can-i-join) -- [how is shring built?](#how-is-shring-built) +- [DESCRIPTION](#description) +- [EXAMPLES](#examples) +- [DEPENDENCIES](#dependencies) +- [CAN I USE JAVASCRIPT](#can-i-use-javascript) +- [HOW CAN I JOIN](#how-can-i-join)  -## what is the shring? +<h3 id="description">DESCRIPTION</h3> -the shring (pronounced "shring") +The shring (pronounced "shring") is **a small web of unix-y personal sites.** the word is composed of "sh" for "shell" and "ring" for "ring". -more specifically, +More specifically, shring is a **webring**. each site links to its "next" and "previous" neighbor. -if you follow the links, +If you follow the links, you'll eventually return to the page you started on. -**every shring member site is** +**Every shring member site is** 1. **personal** -2. **unix-y** +2. **unix-y**. -**there are no further qualifiers.** +**There are no further qualifiers.** -if a site meets these requirements, it's shringworthy. +If a site meets these requirements, it's shringworthy. [return](#toc) -## what is a unix-y personal site? +<h3 id="examples">EXAMPLES</h3> -we don't attempt to formalize a definition. -we all have some amorphous and generally interoperable idea +$ shring definition + +We don't attempt to formalize a definition. +We all have some amorphous and generally interoperable idea of what "**unix-y**" actually means. -in a sense, our understanding +In a sense, our understanding of what it means to be "unix-y" **is in itself unix-y**. -**we don't define unix-y +**We don't define unix-y because that would be un-unix-y.** -instead, we offer two **contrasting, non-authoritative examples**. +Instead, we offer two **contrasting, non-authoritative examples**. + -**a unix-y personal site is not**\ -an seo sloptimized "website" +$ shring counterexample + +**A unix-y personal site is not:**\ +An seo sloptimized "website" that only functions as a portfolio for landing an entry level developer job where every post is about @@ -81,8 +84,10 @@ the latest frontend agentic javascript ml tokenizer agent and what it taught you about b2b sales. -**a unix-y personal site can be**\ -blogs about your experience learning new programming paradigms, +$ shring example + +**A unix-y personal site can be:**\ +Blogs about your experience learning new programming paradigms, accounts of tinkering with shell scripts, stream-of-consciousness rambles about text editors, essays on the impermanence of being, @@ -95,23 +100,23 @@ kernel de(output truncated) [return](#toc) -## what are the requirements to join? +<h3 id="dependencies">DEPENDENCIES</h3> -your website: +Your website: -- must be a "**unix-y personal site**" as per the descriptions above -- must display shring's webring links +- Must be a "**unix-y personal site**" as per the descriptions above. +- Must display shring's webring links. - **heuristic**: you shouldn't have to go looking into the html source or some other voodoo shit just to find the next site in the webring -- must **not** be corpo slopware -- must **not** contain bigotry or hatred +- Must **not** be corpo slopware. +- Must **not** contain bigotry or hatred. [return](#toc) -## do i need to use unix? +<h3 id="do-i-need-to-use-unix">DO I NEED TO USE UNIX</h3> -the "-y" in "unix**-y**" is important. -if you (and by extension, your personal site) +The "-y" in "unix**-y**" is important. +If you (and by extension, your personal site) appreciate free software, the unix philosophy, hacking, and tinkering, then the shring welcomes you, @@ -119,24 +124,24 @@ os choice notwithstandding. [return](#toc) -## can my site have javascript? +<h3 id="can-i-use-javascript">CAN I USE JAVASCRIPT</h3> -although shring is proudly [no-js](https://no-js.club/), +Although shring is proudly [no-js](https://no-js.club/), and you certainly get bonus points for a static, javascript-free website,\ **member sites are welcome to include javascript**. -**however**, -if your site makes use of **bloated frameworks**, +**However**, +If your site makes use of **bloated frameworks**, **runs poorly** on older hardware, **serves ads**, or **tracks** its visitors, **it does not belong in the shring**. [return](#toc) -## how can i join? +<h3 id="how-can-i-join">HOW CAN I JOIN</h3> -to apply, compile the following information: +To apply, compile the following information: - the **name** of your site - your **url** @@ -149,25 +154,25 @@ to apply, compile the following information: - your **name**: - this can be a full name, nickname, username, whatever you want -please email your application to [daniel@ficd.sh](mailto:daniel@ficd.sh). +Please email your application to [daniel@ficd.sh](mailto:daniel@ficd.sh). -you will receive a response via [carrier pigeon](https://nameecho.com/carrior) +You will receive a response via [carrier pigeon](https://nameecho.com/carrior) within 300 business years. if you prefer to be contacted by message-in-a-bottle, include the name of the nearest body of water with an accessible shoreline, and your request will be accommodated. -preferably before applying, +Preferably before applying, add your shring links to your website: - `shring.sh/your-slug/previous` - `shring.sh` - `shring.sh/your-slug/next` -you are responsible for styling and positioning them +You are responsible for styling and positioning them however you see fit. -optional `88x31px` banners are coming soon. +Optional `88x31px` banners are coming soon. we also have a [mailing list](https://lists.jdugan6240.dev/mailman3/lists/shring.lists.jdugan6240.dev), which is used for announcements, @@ -179,13 +184,13 @@ The mailing list is maintained by [jdugan6240](https://jdugan6240.dev). [return](#toc) -## how is shring built? +<h3 id="architecture">ARCHITECTURE</h3> -shring's source is available on [git.ficd.sh](https://git.ficd.sh/ficd/shring). -the webring "backend" (static pages with html redirects) +The source code for shring is available's [git.ficd.sh](https://git.ficd.sh/ficd/shring). +Rhe webring "backend" (static pages with html redirects) is built using [ringfairy](https://github.com/k3rs3d/ringfairy). -additional pages (including this one) +Additional pages (including this one) are generated by a shell script. they are written in markdown, converted to html with pandoc, -- 2.50.1

1 0

[NEW MEMBER] Welcome, micah!
by Daniel Fichtinger 27 Jul '25

27 Jul '25

Hi folks, please welcome Micah, our newest member! They have a blog about the usual computing stuff, built with Zola, and using a custom theme that I must say is very clean! You can find it here: https://micahkepe.com/blog/ Cheers, Daniel -- Daniel Fichtinger Computer programmer. === https://ficd.sh https://git.ficd.sh https://codeberg.org/ficd

1 0

[PATCH] This commit adds jinja and a system to fetch our most recent blog posts and show them on the main screen.
by Zunda 27 Jul '25

27 Jul '25

This is very much my first time using Jinja and working with a build system like this, so it would be helpful if someone else wanted to go through and clean things up. I am pretty happy with what I have wrote so Im not sure what would need to be changed. --- data/assets/styles.css | 157 ------------------ data/templates/grid.html | 24 --- data/templates/random.html | 0 data/templates/template.html | 18 -- jinja_build.py | 31 ++++ justfile | 3 + most_recent_blogs.py | 106 ++++++++++++ ringfairy.toml | 6 +- .../index.html => templates/index.jinja | 24 ++- 9 files changed, 166 insertions(+), 203 deletions(-) delete mode 100644 data/assets/styles.css delete mode 100644 data/templates/grid.html delete mode 100644 data/templates/random.html delete mode 100644 data/templates/template.html create mode 100644 jinja_build.py create mode 100644 most_recent_blogs.py rename data/templates/index.html => templates/index.jinja (60%) diff --git a/data/assets/styles.css b/data/assets/styles.css deleted file mode 100644 index dcec5fb..0000000 --- a/data/assets/styles.css +++ /dev/null @@ -1,157 +0,0 @@ -body { - font-family: monospace; -/* text-transform: lowercase;*/ - font-size: 18px; - line-height: 1.6; - background-color: #111; - color: #d4d4d4; - max-width: 80%; - margin: auto; -} - -h1 { - text-align: center; -} - -h1,h2,h3,h4 { - font-family: Courier New, Courier, Consolas, monospace; -} - -a { - color: #DF6464; - text-decoration: none; - background-color: transparent; -} - -a:hover, a:focus { - text-decoration: none; - background-color: #DF6464; - color: #d4d4d4; -} - -/*table { */ -/* width: 90%;*/ -/* border-collapse: collapse;*/ -/* margin: 12px auto;*/ -/* font-size: 1em;*/ -/*}*/ - - -table { - width: 100%; - border-collapse: collapse; - margin: 12px auto; - font-size: 1em; - font-family: Courier, Consolas, "Courier New", monospace; - table-layout: auto; - overflow-x: auto; - display: block; /* Enables horizontal scrolling */ -} - -tr { - margin-bottom: 10px; -} - -tr:nth-child(odd) { - background-color: #111; /* Light gray for odd rows */ -} - -tr>td:nth-of-type(4) { - white-space: normal; - overflow-wrap: break-word; - width: 100%; -} - -tr:hover { - background-color: #222; /* hover effect for table rows */ -} - -/*th, td {*/ -/* padding: 10px;*/ -/* border: 2px solid #666;*/ -/* text-align: left; */ -/* white-space: nowrap;*/ -/* overflow: hidden;*/ -/* text-overflow: ellipsis;*/ -/*}*/ - - -th, td { - padding: 6px 8px; - border: 1px solid #555; - text-align: left; - white-space: pre; /* Preserve spacing, prevent wrapping */ - overflow: hidden; - text-overflow: ellipsis; - font-family: inherit; - width: 10ch; -} - - -/*th {*/ -/* background-color: #444;*/ -/* text-align: center;*/ -/* font-size: 1.1em;*/ -/* font-family: Courier New, Courier, Consolas, monospace;*/ -/*}*/ - -th { - background-color: #333; - text-align: left; - font-weight: bold; -} - -.container { - max-width: 800px; - margin: auto; - padding: 12px; -} - -@media screen and (max-width: 600px) { - body { - font-size: 0.9rem; - } - -} -:root { - --card-border: #446868; - --card-link-color: #88bebe; -} -.cards-container { - width: 90%; - margin-left: auto; - margin-right: auto; -} -.cards-container a { - color: var(--card-link-color); -} -.cards { - display: grid; - grid-gap: 0.5rem; - grid-template-columns: repeat(auto-fit, minmax(25rem, 1fr)); -} -.card { - border: 2px solid var(--card-border); - border-radius: 0.5rem; -} -.card-name { - background-color: var(--card-border); - font-size: 1.25rem; - padding: 0.25rem; - border-radius: 0.25rem 0.25rem 0 0; - text-transform: lowercase; -} -.card-content { - padding: 0.5rem; -} -.card-link { - font-size: .95rem; - text-transform: lowercase; -} -.card-text { - font-size: 0.75rem; -} -.card-slug { - font-size: 0.75rem; -} - diff --git a/data/templates/grid.html b/data/templates/grid.html deleted file mode 100644 index 19b6921..0000000 --- a/data/templates/grid.html +++ /dev/null @@ -1,24 +0,0 @@ -<!DOCTYPE html> -<html lang="en"> - <link rel="stylesheet" href="./styles.css"> - <head> - <meta charset="UTF-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <title>{{ ring_name }} List</title> - </head> - <body> - <div class="cards-container"> - <h1>{{ ring_name }} List</h1> - <p>{{ ring_description }}</p> - <p>Add all sites with declared RSS feeds to your feed reader with this <a href ="{{ opml }}">OPML</a> link.</p> - - {{ grid_of_sites | safe}} - - <br> - <footer> - <p>Last updated: {{ current_time }} </p> - <p>Powered by <a href="https://github.com/k3rs3d/ringfairy">ringfairy</a>!</p> - </footer> - </div> - </body> -</html> diff --git a/data/templates/random.html b/data/templates/random.html deleted file mode 100644 index e69de29..0000000 diff --git a/data/templates/template.html b/data/templates/template.html deleted file mode 100644 index 0ae260d..0000000 --- a/data/templates/template.html +++ /dev/null @@ -1,18 +0,0 @@ -<!doctype html> -<html lang="en"> -<head> - <meta charset="utf-8"> - <meta http-equiv="refresh" content="0; url={{ url }}"> - <title>Redirecting...</title> - - <style> - body { - background-color: #000; - color: #fff; - } - </style> -</head> -<body> - <p>A fairy is teleporting you to <a href="{{ url }}">{{ url }}</a>...!</p> -</body> -</html> diff --git a/jinja_build.py b/jinja_build.py new file mode 100644 index 0000000..6a2c345 --- /dev/null +++ b/jinja_build.py @@ -0,0 +1,31 @@ +from jinja2 import Environment, FileSystemLoader +from most_recent_blogs import get_most_recent_blogs +from datetime import datetime +import json + +def load_websites(): + with open("websites.json") as f: + return json.load(f) + +def main(): + # loading the environment + env = Environment(loader = FileSystemLoader('templates')) + + # loading the template + template = env.get_template('index.jinja') + + sites = load_websites() + number_of_sites = len(sites) + most_recent_blogs = get_most_recent_blogs() + print(most_recent_blogs) + + # rendering the template and storing the resultant text in variable output + output = template.render(most_recent=most_recent_blogs, sites=sites, number_of_sites=number_of_sites, current_time=str(datetime.utcnow())) + + # printing the output on screen + with open("webring/index.html", "w") as f: + f.write(output) + +if __name__ == '__main__': + main() + diff --git a/justfile b/justfile index 2a5cb3b..0d27dd7 100644 --- a/justfile +++ b/justfile @@ -51,11 +51,14 @@ deps: >"webring/$name/index.html" done +@_build_index: + python jinja_build.py # build the site build: clean just _build_ring just _build_pages + just _build_index # start development server, optional arg 'live', rebuild on changes [no-exit-message] diff --git a/most_recent_blogs.py b/most_recent_blogs.py new file mode 100644 index 0000000..eb2dd9c --- /dev/null +++ b/most_recent_blogs.py @@ -0,0 +1,106 @@ +# Tool to fetch most recent blog posts from the given RSS feeds +# Outputs JSON to stdout + +import json +import requests +import threading +import xml.etree.ElementTree as ET +import email.utils +import pprint + +def get_rss_links(): + with open("websites.json") as f: + return [site.get("rss") for site in json.load(f) if site.get("rss")] + +def fetch_all_rss(all_rss): + xmls = [] + + def fetch_single_rss(rss): + nonlocal xmls + req = requests.get(rss) + if req.status_code != 200: + return + xmls += [ET.fromstring(req.text)] + + threads = [] + for rss in all_rss: + t = threading.Thread(target=fetch_single_rss, args=(rss,)) + threads.append(t) + + for t in threads: + t.start() + + for t in threads: + t.join() + + return xmls + +def get_timestamped_blogposts(rss): + channel = rss.findall("channel")[0] + + channel_title = channel.find("title") + channel_link = channel.find("link") + channel_desc = channel.find("description") + + blogs = [] + + for blog in channel.findall("item"): + title = blog.find("title") + link = blog.find("link") + pub_date = blog.find("pubDate") + + blog = {} + + if channel_title is None or channel_link is None or channel_desc is None: + continue + if title is None or link is None or pub_date is None: + continue + + blog["title"] = title.text + blog["link"] = link.text + blog["pub_date"] = email.utils.parsedate_to_datetime(pub_date.text) + + blog["channel_title"] = channel_title.text + blog["channel_link"] = channel_link.text + blog["channel_desc"] = channel_desc.text + + blogs += [blog] + + return blogs + +def convert(all_blog_posts): + out = [] + + for post in all_blog_posts: + out += [{ + "title": post["title"], + "link": post["link"], + "channel_title": post["channel_title"], + "channel_link": post["channel_link"], + "channel_desc": post["channel_desc"], + "pub_date": post["pub_date"].strftime('%d, %b %Y'), + }] + + return out + +def get_most_recent_blogs(n=5): + rss_link_list = get_rss_links() + rsses = fetch_all_rss(rss_link_list) + + all_blog_posts = [] + + for rss in rsses: + all_blog_posts += get_timestamped_blogposts(rss) + + all_blog_posts.sort(key=lambda p: p["pub_date"].timestamp()) + all_blog_posts.reverse() + + return convert(all_blog_posts[:n]) + +def main(): + print(json.dumps(get_most_recent_blogs())) + + +if __name__ == '__main__': + main() + diff --git a/ringfairy.toml b/ringfairy.toml index 5fb98e7..8377f0a 100644 --- a/ringfairy.toml +++ b/ringfairy.toml @@ -6,9 +6,9 @@ ring_owner_site = "https://ficd.sh" filepath_list = "./websites.json" # Website list; should be a JSON file with 'name', 'url', etc path_output = "./webring" # Generated files will be saved in this folder. -path_assets = "./data/assets" # All contents of the asset folder will be copied directly into the output directory -path_templates = "./data/templates" # The folder containing HTML templates to use, ie, anything with {{ tags }} -filename_template_redirect = "template.html" # This template gets reused to build the redirect pages for each site, and is ignored when building the other custom templates +path_assets = "./ringfairy/assets" # All contents of the asset folder will be copied directly into the output directory +path_templates = "./ringfairy/templates" # The folder containing HTML templates to use, ie, anything with {{ tags }} +filename_template_redirect = "./ringfairy/templates/template.html" # This template gets reused to build the redirect pages for each site, and is ignored when building the other custom templates client_user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" client_header = "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8" diff --git a/data/templates/index.html b/templates/index.jinja similarity index 60% rename from data/templates/index.html rename to templates/index.jinja index 79b522e..407c86c 100644 --- a/data/templates/index.html +++ b/templates/index.jinja @@ -18,7 +18,24 @@ <strong><code>{{ number_of_sites }} members, built {{ current_time }} UTC</code></strong><br> </p> - {{ table_of_sites | safe}} + <table> + <tr> + <th>#</th> + <th>Name</th> + <th>URL</th> + <th>About</th> + <th>Owner</th> + </tr> + {% for site in sites %} + <tr> + <td>{{loop.index}}</td> + <td>{{site["name"]}}</td> + <td><a href="{{site['url']}}">{{site["url"]}}</a> {% if site["rss"] %}<a href="{{site['rss']}}">[rss]</a>{% endif %}</td> + <td>{{site["about"]}}</td> + <td>{{site["owner"]}}</td> + </tr> + {% endfor %} + </table> <p> <code>$ shring feed --opml ><a href="{{ opml }}" >./shring.opml</a></code><br> @@ -31,6 +48,11 @@ >open source</a>, and proudly <a href="https://no-js.club/">no-js</a>. for information about joining, please see the <a href="/faq" >faq</a>.<br><br> + <code>$ shring most-recent | tail -n5 </code><br> + {% for blog in most_recent %} + <a href="{{ blog['channel_link'] }}">{{ blog["channel_title"] }}</a>: <a href="{{ blog['link'] }}"> {{ blog["title"] }} </a> - {{ blog["pub_date"] }} + <br> + {% endfor %} </p> </body> </html> -- 2.50.1

1 0

New shring domain
by James Dugan 26 Jul '25

26 Jul '25

The main domain for the shring has been changed to shring.sh. The original domain shring.ficd.sh will redirect to the new domain for now, but it's recommended to switch over.

1 0

Test of the mailing list
by Jacob Haussman 26 Jul '25

26 Jul '25

This message is to test the mailing list. I need a message to see how archives work.

1 0