mirror of
https://github.com/georgemandis/bubo-rss.git
synced 2024-11-09 13:34:22 +00:00
Merge branch 'main' into glitch
This commit is contained in:
George Mandis
commit
6aa4dc80b3
75
README.md
75
README.md
@ -1,16 +1,17 @@
|
|||||||
[](https://app.netlify.com/sites/bubo-rss-demo/deploys)
|
[](https://app.netlify.com/sites/bubo-rss-demo/deploys)
|
||||||
|
|
||||||
# 🦉 Bubo Reader (2.0)
|
# 🦉 Bubo Reader
|
||||||
|
|
||||||
Bubo Reader is a hyper-minimalist <acronym title="Really Simple Syndication">RSS</acronym> and <acronym title="JavaScript Object Notation">JSON</acronym> feed reader you can deploy on your own server, [Netlify](https://netlify.com) in a few steps or [Glitch](https://glitch.com) in even fewer steps! The goal of the project is to generate a webpage that shows a list of links from a collection of feeds organized by category and website. That's it.
|
Bubo Reader is a hyper-minimalist <acronym title="Really Simple Syndication">RSS</acronym> and <acronym title="JavaScript Object Notation">JSON</acronym> feed reader you can deploy on your own server, [Netlify](https://netlify.com) in a few steps or [Glitch](https://glitch.com) in even fewer steps! The goal of the project is to generate a webpage that shows a list of links from a collection of feeds organized by category and website. That's it.
|
||||||
|
|
||||||
It is named after this [silly robot owl](https://www.youtube.com/watch?v=MYSeCfo9-NI) from Clash of the Titans (1981).
|
It is named after this [silly robot owl](https://www.youtube.com/watch?v=MYSeCfo9-NI) from Clash of the Titans (1981).
|
||||||
|
|
||||||
You can read more about how this project came about on my blog:
|
You can read more about this project on my blog:
|
||||||
|
|
||||||
- [Introducing Bubo RSS: An Absurdly Minimalist RSS Feed Reader](https://george.mand.is/2019/11/introducing-bubo-rss-an-absurdly-minimalist-rss-feed-reader/).
|
- [Introducing Bubo RSS: An Absurdly Minimalist RSS Feed Reader](https://george.mand.is/2019/11/introducing-bubo-rss-an-absurdly-minimalist-rss-feed-reader/).
|
||||||
|
- [Publishing Bubos RSS to Netlify with GitHub Actions](https://george.mand.is/2020/02/publishing-bubos-rss-to-netlify-with-github-actions/)
|
||||||
|
|
||||||
|
## Get Started
|
||||||
## Getting Started
|
|
||||||
|
|
||||||
- Clone or fork the repo and run `npm install` to install the dependencies.
|
- Clone or fork the repo and run `npm install` to install the dependencies.
|
||||||
- Update `feeds.json` to include categories and links to feeds you would like to see.
|
- Update `feeds.json` to include categories and links to feeds you would like to see.
|
||||||
@ -18,19 +19,10 @@ You can read more about how this project came about on my blog:
|
|||||||
|
|
||||||
That's it! You should now have a static page with links to the latest content from your feeds in the `public` folder, ready to serve.
|
That's it! You should now have a static page with links to the latest content from your feeds in the `public` folder, ready to serve.
|
||||||
|
|
||||||
## Differences in Bubo 2.0
|
<details>
|
||||||
|
<summary>
|
||||||
Version 2.0 has introduced some substantial changes for Bubo! While the static output remains endearingly spartan, the engine that builds it has changed a bit.
|
<strong>Anatomy of Bubo Reader</strong>
|
||||||
|
</summary>
|
||||||
Hopefully all of these changes are in services of making this project more useful to others and encouraging outside contributions.
|
|
||||||
|
|
||||||
Changes of note:
|
|
||||||
|
|
||||||
- Bubo has been rewritten in [TypeScript](https://www.typescriptlang.org/). It's pretty slick! I anticipate the typing could be improved, but it's a start.
|
|
||||||
- You fill find an `.nvmrc` file in the root of this project. Learn more [about nvm](https://github.com/nvm-sh/nvm) if you're unfamiliar.
|
|
||||||
- The script will actually write your `index.html` file for you (Previously the build script simply ran `node src/index.js > output/index.html`). It makes a strong assumption that this file lives in the `public` folder.
|
|
||||||
- There is a somewhat sophisticated mechansim in-place for batching & throttling your requests, if needed.
|
|
||||||
## Anatomy of Bubo Reader
|
|
||||||
|
|
||||||
The static pieces:
|
The static pieces:
|
||||||
|
|
||||||
@ -45,14 +37,19 @@ The engine:
|
|||||||
- `src/renderer.ts` — The renderer that loads Nunjucks, the template and understands how to process the incoming feed data. Prefer something else? This is the place to change it!
|
- `src/renderer.ts` — The renderer that loads Nunjucks, the template and understands how to process the incoming feed data. Prefer something else? This is the place to change it!
|
||||||
- `src/utilities.ts` — A variety of parsing and normalization utilities for Bubo, hidden away to try and keep things clean.
|
- `src/utilities.ts` — A variety of parsing and normalization utilities for Bubo, hidden away to try and keep things clean.
|
||||||
|
|
||||||
## Throttling
|
</details>
|
||||||
|
|
||||||
In the main `index.ts` file you will find two values that allow yout to batch and throttle your feed requests:
|
<details>
|
||||||
|
<summary>
|
||||||
|
<strong>Throttling</strong>
|
||||||
|
</summary>
|
||||||
|
|
||||||
- `MAX_CONNECTIONS` dictates the maximium number of requests a batch can have going at once.
|
In the main `index.ts` file you will find two values that allow you to batch and throttle your feed requests:
|
||||||
- `DELAY_MS` dictates the amount of de;ay time between each batch.
|
|
||||||
|
|
||||||
The default configuration is **no batching or throttling** beacuse `MAX_CONNECTIONS` is set to `Infinity`. If you wanted to change Bubo to only fetch one feed at a time every second you could set these values to:
|
- `MAX_CONNECTIONS` dictates the maximum number of requests a batch can have going at once.
|
||||||
|
- `DELAY_MS` dictates the amount of delay time between each batch.
|
||||||
|
|
||||||
|
The default configuration is **no batching or throttling** because `MAX_CONNECTIONS` is set to `Infinity`. If you wanted to change Bubo to only fetch one feed at a time every second you could set these values to:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const MAX_CONNECTIONS = 1;
|
const MAX_CONNECTIONS = 1;
|
||||||
@ -67,22 +64,20 @@ const DELAY_MS = 2500;
|
|||||||
```
|
```
|
||||||
|
|
||||||
In practice, I've never _really_ run into an issue leaving `MAX_CONNECTIONS` set to `Infinity` but this feels like a sensible safeguard to design.
|
In practice, I've never _really_ run into an issue leaving `MAX_CONNECTIONS` set to `Infinity` but this feels like a sensible safeguard to design.
|
||||||
## Demos
|
|
||||||
|
|
||||||
You can view live demos here:
|
</details>
|
||||||
|
|
||||||
- [https://bubo-rss-demo.netlify.com/](https://bubo-rss-demo.netlify.com/)
|
<details>
|
||||||
- [http://bubo-rss.glitch.me/](http://bubo-rss.glitch.me/)
|
<summary>
|
||||||
|
<strong>Getting Started</strong>
|
||||||
Not the most exciting-looking demos, I'll admit, but they work!
|
</summary>
|
||||||
|
|
||||||
**Getting Started**
|
|
||||||
|
|
||||||
- [Deploying to Glitch](#glitch)
|
- [Deploying to Glitch](#glitch)
|
||||||
- [Deploying to Netlify](#netlify)
|
- [Deploying to Netlify](#netlify)
|
||||||
- [Keeping feeds updated](#updated)
|
- [Keeping feeds updated](#updated)
|
||||||
|
|
||||||
<a id="glitch"></a>
|
<a id="glitch"></a>
|
||||||
|
|
||||||
## Deploying to Glitch
|
## Deploying to Glitch
|
||||||
|
|
||||||
The quickest way is to remix the project on Glitch:
|
The quickest way is to remix the project on Glitch:
|
||||||
@ -93,6 +88,7 @@ There is also a `glitch` branch on this repo if you'd prefer to start there.
|
|||||||
Just change some feeds in `./config/feeds.json` file and you're set! If you'd like to modify the style or the template you can changed `./public/style.css` file or the `./config/template.html` file respectively.
|
Just change some feeds in `./config/feeds.json` file and you're set! If you'd like to modify the style or the template you can changed `./public/style.css` file or the `./config/template.html` file respectively.
|
||||||
|
|
||||||
<a id="netlify"></a>
|
<a id="netlify"></a>
|
||||||
|
|
||||||
## Deploying to Netlify
|
## Deploying to Netlify
|
||||||
|
|
||||||
- [Fork the repository](https://github.com/georgemandis/bubo-rss/fork)
|
- [Fork the repository](https://github.com/georgemandis/bubo-rss/fork)
|
||||||
@ -102,6 +98,7 @@ Just change some feeds in `./config/feeds.json` file and you're set! If you'd li
|
|||||||
The deploy settings should automatically import from the `netlify.toml` file. All you'll need to do is confirm and you're ready to go!
|
The deploy settings should automatically import from the `netlify.toml` file. All you'll need to do is confirm and you're ready to go!
|
||||||
|
|
||||||
<a id="updated"></a>
|
<a id="updated"></a>
|
||||||
|
|
||||||
### Keeping Feeds Updated
|
### Keeping Feeds Updated
|
||||||
|
|
||||||
#### Using Netlify Webhooks
|
#### Using Netlify Webhooks
|
||||||
@ -112,21 +109,29 @@ To keep your feeds up to date you'll want to [setup a Build Hook](https://www.ne
|
|||||||
- [Zapier](https://zapier.com/)
|
- [Zapier](https://zapier.com/)
|
||||||
- [EasyCron](https://www.easycron.com/)
|
- [EasyCron](https://www.easycron.com/)
|
||||||
|
|
||||||
#### Using GitHub Actions
|
|
||||||
|
|
||||||
Coming soon—there is an old branch that demonstrates this, but it needs to be revisisted in light of Bubo 2.0.
|
|
||||||
|
|
||||||
#### Rolling Your Own
|
#### Rolling Your Own
|
||||||
|
|
||||||
If you already have a server running Linux and some command-line experience it might be simpler to setup a [cron job](https://en.wikipedia.org/wiki/Cron).
|
If you already have a server running Linux and some command-line experience it might be simpler to setup a [cron job](https://en.wikipedia.org/wiki/Cron).
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
## Demos
|
||||||
|
|
||||||
|
You can view live demos here:
|
||||||
|
|
||||||
|
- [https://bubo-rss-demo.netlify.com/](https://bubo-rss-demo.netlify.com/)
|
||||||
|
- [http://bubo-rss.glitch.me/](http://bubo-rss.glitch.me/)
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
|
|
||||||
If you found this useful please consider sponsoring me or this project.
|
If you found this useful please consider [sponsoring me or this project](https://github.com/sponsors/georgemandis).
|
||||||
|
|
||||||
If you'd rather run this on your own server please consider using one of these affiliate links to setup a micro instance on [Linode](https://www.linode.com/?r=8729957ab02b50a695dcea12a5ca55570979d8b9), [Digital Ocean](https://m.do.co/c/31f58d367777) or [Vultr](https://www.vultr.com/?ref=8403978).
|
If you'd rather run this on your own server please consider using one of these affiliate links to setup a micro instance on [Linode](https://www.linode.com/?r=8729957ab02b50a695dcea12a5ca55570979d8b9), [Digital Ocean](https://m.do.co/c/31f58d367777) or [Vultr](https://www.vultr.com/?ref=8403978).
|
||||||
|
|
||||||
## Showcase
|
## Showcase
|
||||||
|
|
||||||
Here are some websites using Bubo Reader:
|
Here are some websites using Bubo Reader:
|
||||||
|
|
||||||
- [Kevin Fiol](https://kevinfiol.com/reader/) ([repo](https://github.com/kevinfiol/reader))
|
- [Kevin Fiol](https://kevinfiol.com/reader/) ([repo](https://github.com/kevinfiol/reader))
|
||||||
|
|
||||||
|
Please share if you would like to be featured!
|
||||||
|
|||||||
@ -1,16 +1,20 @@
|
|||||||
{
|
{
|
||||||
"Web Development": [
|
"Developer News": [
|
||||||
"https://hacks.mozilla.org/feed/",
|
"https://hacks.mozilla.org/feed/",
|
||||||
"https://web.dev/feed.xml",
|
"https://web.dev/feed.xml",
|
||||||
"https://v8.dev/blog.atom",
|
"https://v8.dev/blog.atom",
|
||||||
"https://alistapart.com/main/feed/",
|
"https://alistapart.com/main/feed/",
|
||||||
"https://css-tricks.com/feed/",
|
"https://css-tricks.com/feed/",
|
||||||
"https://dev.to/feed"
|
"https://dev.to/feed",
|
||||||
|
"https://changelog.com/feed"
|
||||||
],
|
],
|
||||||
"Blogs": [
|
"Blogs": [
|
||||||
"https://george.mand.is/feed.xml",
|
"https://george.mand.is/feed.xml",
|
||||||
"https://joy.recurse.com/feed.atom"
|
"https://joy.recurse.com/feed.atom"
|
||||||
],
|
],
|
||||||
|
"Social": [
|
||||||
|
"https://social.mandis.dev/@georgemandis.rss"
|
||||||
|
],
|
||||||
"My GitHub Projects": [
|
"My GitHub Projects": [
|
||||||
"https://github.com/georgemandis.atom",
|
"https://github.com/georgemandis.atom",
|
||||||
"https://github.com/georgemandis/bubo-rss/releases.atom",
|
"https://github.com/georgemandis/bubo-rss/releases.atom",
|
||||||
|
|||||||
1791
package-lock.json
generated
1791
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
24
package.json
24
package.json
@ -29,21 +29,21 @@
|
|||||||
},
|
},
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"chalk": "^5.0.0",
|
"chalk": "^5.1.2",
|
||||||
"node-fetch": "^3.1.0",
|
"node-fetch": "^3.3.0",
|
||||||
"nunjucks": "^3.2.0",
|
"nunjucks": "^3.2.3",
|
||||||
"rss-parser": "^3.6.3",
|
"rss-parser": "^3.12.0",
|
||||||
"express": "^4.17.1"
|
"express": "^4.17.1"
|
||||||
},
|
},
|
||||||
"engines": { "node": "16.x" },
|
"engines": { "node": "16.x" },
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@types/node": "^16.11.10",
|
"@types/node": "^16.18.4",
|
||||||
"@types/nunjucks": "^3.2.0",
|
"@types/nunjucks": "^3.2.1",
|
||||||
"@types/xml2js": "^0.4.9",
|
"@types/xml2js": "^0.4.11",
|
||||||
"@typescript-eslint/eslint-plugin": "^5.4.0",
|
"@typescript-eslint/eslint-plugin": "^5.45.0",
|
||||||
"@typescript-eslint/parser": "^5.4.0",
|
"@typescript-eslint/parser": "^5.45.0",
|
||||||
"eslint": "^8.3.0",
|
"eslint": "^8.29.0",
|
||||||
"tslib": "^2.3.1",
|
"tslib": "^2.4.1",
|
||||||
"typescript": "^4.5.2"
|
"typescript": "^4.9.3"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
Loading…
Reference in New Issue
Block a user