ewen/rudibridge-mirror
1
0
Fork 0
mirror of https://codeberg.org/Ewen/rudibridge.git synced 2024-12-22 03:02:32 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
A rudimentary RSS bridge
6 commits 2 branches 0 tags 366 KiB
Vue 58%
Python 21.8%
TypeScript 10.3%
CSS 5.5%
Dockerfile 3.1%
Other 1.3%
Go to file
Ewen d6c6b58d59 fix: handling ungiven parameters
2024-05-09 08:02:33 +02:00
api fix: handling ungiven parameters 2024-05-09 08:02:33 +02:00
.env.dev feat: first somewhat (hardcoded) working version 2024-05-06 22:19:18 +02:00
.gitignore Initial commit 2024-04-30 12:19:16 +00:00
docker-compose.yml feat: first somewhat (hardcoded) working version 2024-05-06 22:19:18 +02:00
LICENSE Initial commit 2024-04-30 12:19:16 +00:00
README.md updated readme 2024-05-09 07:43:15 +02:00

README.md

Rudibridge

A rudimentary RSS bridge for changing web pages that don't have an RSS feed.

Architecture and usage

This (personal side-) project can be used to build an RSS feed from webpages that don't have any.

This project consists of two parts :

  • a back-end, written in Flask, that responds an RSS feed to GET requests with specific parameters
  • a front-end, written in Vue.js, a simple wrapper/helper to write the GET requests

Parameters

  • **url** (required): the URL of the page
  • **article** (required): the HTML tag encapsulating a feed item
  • **title** (required): the HTML tag of the article title
  • **articleClass**: a class name helping to filter the article element
  • **titleClass**: a class name helping to filter the title element
  • **section**: the HTML tag encapsulating the group of items. If not given, the entire page will be used
  • **content**: the HTML tag encapsulating the content, or description, of the item. The default is p
  • **contentClass**: a class name helping to filter the content element
  • **link**: the HTML tag encapsulating the link to the item. The default is a.
  • **linkClass**: a class name helping to filter the link element
  • **datetime**: the HTML tag encapsulating the date and time of the item. Any date and time format can be used, the parser will try to understand the format.
  • **datetimeClass**: a class name helping to filter the datetime element
  • **author**: the HTML tag encapsulating the author of the item
  • **authorClass**: a class name helping to filter the author element

Installation

Using Docker, for development purposes

You will need to have Docker and Docker Compose installed. Clone the repository, go to its root and run docker-compose up -d. To use the backend directly, go to the page http://localhost:8080/feed/ and start adding parameters!

For production

To do

Examples

(as of May 2024, the web pages can change over time and break the generated feeds)