mirror of https://git.sr.ht/~sircmpwn/openring synced 2026-02-28 16:06:20 +01:00

A webring for static site generators

Go to file

danso e4f5a02691 sort feeds before cropping them Cutting each feed down to `perSource` items works great if the entries in that feed are already in chronological order. What if they're not? Or if they're in reverse order? Sort each source first, then take `perSource` items from it.		2026-02-13 09:52:03 +01:00
LICENSES	Improve licensing details	2021-12-21 09:30:57 +01:00
.gitignore	Initial commit	2019-06-03 14:55:23 -04:00
go.mod	Rewrote flag parsing to use flag-like interface	2019-06-23 13:53:43 -04:00
go.sum	Rewrote flag parsing to use flag-like interface	2019-06-23 13:53:43 -04:00
in.html	Add BIDI support	2023-08-07 11:20:02 +02:00
openring.go	sort feeds before cropping them	2026-02-13 09:52:03 +01:00
README.md	Remove link to pre-compiled binary	2020-06-14 18:04:57 -04:00

README.md

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.

Contributing

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