A webring for static site generators
6d79d2e3 — Haelwenn (lanodan) Monnier a month ago
Add support for resolving relative feed URLs
Update README.md
Rewrote flag parsing to use flag-like interface

refs

master
browse log

clone

read-only
https://git.sr.ht/~sircmpwn/openring
read/write
git@git.sr.ht:~sircmpwn/openring

openring

This is a tool for generating a webring from RSS feeds, so you can link to other blogs you like on your own blog. It's designed to be fairly simple and integrate with any static site generator. The basic usage is:

openring \
  -s https://drewdevault.com/feed.xml \
  -s https://emersion.fr/blog/rss.xml \
  -s https://danluu.com/atom.xml \
  < in.html \
  > out.html

This will read the template at in.html (an example is provided, but feel free to adjust it to suit your needs), fetch the latest 3 articles from among your sources, and pass them to the template and write the output to out.html. Then you can include this file with your static site generator's normal file include mechanism.

A pre-compiled binary is available here so you can integrate this with your CI deploy. For example, on builds.sr.ht, add a step like this to your .build.yml:

tasks:
  - openring: |
      curl -O https://yukari.sr.ht/openring
      chmod +x openring
      ./openring \
        -s https://drewdevault.com/feed.xml \
        -s https://emersion.fr/blog/rss.xml \
        -s https://danluu.com/atom.xml \
        < _include/webring-in.html \
        > _include/webring-out.html
# ...

Contributing

Want to help? Send patches to the mailing list: ~sircmpwn/public-inbox@lists.sr.ht. Thanks!


Screenshot of a generated web ring