~sircmpwn/openring

ref: f75cc73b8b7874d2125ce0b9ec2b650f9022a255 openring/README.md -rw-r--r-- 1.3 KiB View raw
f75cc73b — Jeff Kaufman improve handling of feeds with no summary 8 months ago

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
# ...