40 lines
1.2 KiB
Markdown
40 lines
1.2 KiB
Markdown
|
# 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
|
||
|
# ...
|
||
|
```
|