openring 0.1.2

A webring for static site generators written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

<h1 align="center">
    ⛓<br>
    openring-rs
</h1>

<div align="center">
    <strong>A tool for generating a webring from RSS feeds.</strong>
</div>
<br>
<br>

This is a rust-port of Drew DeVault's [openring](https://git.sr.ht/~sircmpwn/openring), with the
primary differences being:
- the template is provided as a argument, not read from stdin
- we show a little progress bar

`openring-rs` is a tool for generating a webring from RSS feeds, so you can populate a template with
articles from those feeds and embed them in your own blog. An example template is provided in
`in.html`.

## Install

```
cargo install openring
```

## Usage

```
A webring for static site generators written in Rust

Usage: openring [OPTIONS] --template-file <FILE>

Options:
  -n, --num-articles <NUM_ARTICLES>  Total number of articles to fetch [default: 3]
  -p, --per-source <PER_SOURCE>      Number of most recent articles to get from each feed [default: 1]
  -S, --url-file <FILE>              File with URLs of RSS feeds to read (one URL per line)
  -t, --template-file <FILE>         Tera template file
  -s, --urls <URLS>                  A specific URL to consider (can be repeated)
  -h, --help                         Print help information
  -V, --version                      Print version information
```

## Using Tera Templates

The templates supported by `openring-rs` are written using [Tera](https://tera.netlify.app/). Please
refer to the Tera documentation for details.

## Why a Rust Port?

Just for fun. You probably want to use Drew's stuff, it's likely better. But, this works for me.