2019-06-03 18:27:44 +00:00
|
|
|
# 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](https://yukari.sr.ht/openring) so you
|
|
|
|
can integrate this with your CI deploy. For example, on
|
|
|
|
[builds.sr.ht](https://sourcehut.org), add a step like this to your
|
|
|
|
`.build.yml`:
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
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
|
|
|
|
# ...
|
|
|
|
```
|
2019-06-04 14:43:22 +00:00
|
|
|
|
|
|
|
![Screenshot of a generated web ring](https://sr.ht/TRrJ.png)
|