mirror of
https://github.com/fenwick67/mastofeed
synced 2024-12-22 07:16:14 +01:00
Create README.md
This commit is contained in:
parent
bf32b9fdfc
commit
12c24df6db
27
README.md
Normal file
27
README.md
Normal file
@ -0,0 +1,27 @@
|
||||
# Mastofeed
|
||||
|
||||
Embed a mastodon feed in your blog et cetera.
|
||||
|
||||
## Usage guide
|
||||
|
||||
The homepage has a tool for generating iframe code for you, with a sensible `sandbox` attribute. The feeds fit comfortably in a 400px wide area.
|
||||
|
||||
## API
|
||||
|
||||
### GET `/api/feed?url=${url}`
|
||||
|
||||
> example: `/api/feed/url=https%3A%2F%2Foctodon.social%2Fusers%2Ffenwick67.atom`
|
||||
|
||||
Returns a html page which displays a mastodon feed for an atom feed URL. Note that URLs must be URI encoded (i.e. `encodeURIComponent('https://octodon.social/users/fenwick67.atom')` ).
|
||||
|
||||
Mastodon Atom feed URLs follow this convention:
|
||||
|
||||
`https://${instance}/users/${username}.atom`
|
||||
|
||||
## Installation
|
||||
|
||||
This is a straightforward node project with zero databases or anything, you should just be able to run `npm install` and then `npm start` to get up and running. Set your `PORT` environment variable to change the port it listens on.
|
||||
|
||||
## Improve me
|
||||
|
||||
Feel free to add a chaching layer, improve the styles and add more features.
|
Loading…
Reference in New Issue
Block a user