~sircmpwn/openring

ref: ec47d0b3842147a156216ed7b2630600bec73371 openring/README.md -rw-r--r-- 1.5 KiB View raw
ec47d0b3Noah Loomans allow custom date formats 3 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
# ...

Contributing

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