Skip to content

About

Nuchronic.uk: a webring aggregator for the chronically ill on the indie web. Hosted on GitHub Pages.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

webring

Dark-mode Hacker News-inspired Jekyll feed for the chronically ill indie web.

Local development

This repo ships as a plain Jekyll site with GitHub Pages-compatible dependencies.

bundle install
bundle exec jekyll serve

Open http://127.0.0.1:4000/ to view the site locally.

To refresh static webmention data locally:

python _python/fetch_webmentions.py

To dry-run outgoing publication for a commit range locally:

python .github/scripts/publish_new_posts.py BEFORE_SHA AFTER_SHA --dry-run

To re-notify Bridgy Fed for recent posts that missed an earlier send:

python .github/scripts/publish_new_posts.py HEAD HEAD --retry-recent 20 --dry-run

Content model

  • The homepage is the new feed.
  • The top feed is generated by sorting posts by populatrity via a webmention count.
  • Posts live in _posts/ and use only title, link, author, and date front matter.
  • Pagination is enabled at 30 posts per page.
  • The submit link routes to the repo's GitHub issue form.
  • The site publishes an Atom feed at /feed.xml.

Automation

  • .github/workflows/cicd.yml syncs source feeds and deploys when new items land.
  • .github/workflows/cicd.yml also notifies Bridgy Fed about each newly added post after deploy, retries recent posts that missed an earlier Bridgy Fed notification, sends an outgoing webmention to the linked source when that source supports it, and commits the resulting cache files.
  • .github/workflows/webmentions.yml refreshes static webmention data every 3 hours and deploys when counts or mentions change.
  • Outgoing state is stored in .cache/.

Identity Setup

  • The site publishes hidden rel="me" links for GitHub and Bridgy in the page head.
  • Bridgy syndication via nuchronic.uk has been set up in Bridgy Fed for the target networks.
  • Post detail pages now include a hidden u-bridgy-fed link so a follow-up webmention can trigger Bridgy Fed immediately for new posts.

About

Nuchronic.uk: a webring aggregator for the chronically ill on the indie web. Hosted on GitHub Pages.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages