RSSPAPER/README.md

44 lines
1.3 KiB
Markdown
Raw Normal View History

2021-07-06 22:20:41 +02:00
<h1 align="center">
2021-07-20 21:49:39 +02:00
<img alt="RSSpaper logo" src="media/newsreader-banner.png">
2021-07-06 22:20:41 +02:00
</h1>
2021-07-06 18:02:59 +02:00
<p align="center">
2021-07-20 00:24:32 +02:00
<a href="https://rsspaper.andros.dev/">👉 DEMO 👈</a> (My own feed generated daily with Github Actions)
2021-07-06 22:29:09 +02:00
</p>
2020-11-03 23:57:47 +01:00
2021-07-20 00:32:46 +02:00
Generate a static page with the latest news from your favorite feeds. Is it an RSS client? Yes, except that it generates an **HTML/PWA** that you can read or **install on your tablet or mobile** and to **update the news you must run it again**.
2021-07-06 22:26:44 +02:00
## Run
2021-07-20 00:24:32 +02:00
1) Create a file `config.yaml` with the following content. You can also use `config.yaml.example` as a base config and change it to fit your needs.
2021-07-06 22:26:44 +02:00
``` yaml
2021-07-20 00:26:05 +02:00
# Change the title, it's for you. Maybe you see "My newspaper"?
title: RSSPAPER
2021-07-06 22:26:44 +02:00
# Options: light or dark
theme: light
# Options: daily, weekly or all
edition: weekly
feeds:
- https://programadorwebvalencia.com/feed/
- https://republicaweb.es/feed/
```
2021-07-20 00:24:32 +02:00
2) Download the latest version of RSSpaper (`rsspaper-{version}-standalone.jar`).
2021-07-06 22:26:44 +02:00
2021-07-20 00:32:46 +02:00
https://github.com/tanrax/RSSPAPER/releases
2021-07-06 22:26:44 +02:00
2021-07-30 12:06:54 +02:00
(Both `jar` and `config.yaml` must be in the same directory)
2021-07-06 22:26:44 +02:00
2021-07-20 00:24:32 +02:00
3) Now you can execute.
2020-11-03 23:57:47 +01:00
2020-11-04 07:25:21 +01:00
```sh
2021-07-06 22:26:44 +02:00
java -jar rsspaper-{version}-standalone.jar
2020-11-04 07:25:21 +01:00
```
2020-11-03 23:57:47 +01:00
2021-07-07 01:07:59 +02:00
Great 🎉. You already have your 📰 own Static RSS Newspaper 📰.
2021-07-06 22:26:44 +02:00
That's it, now you just have to open `dist/index.html`.