Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mldangelo/open-webring
Join a webring or create your own.
https://github.com/mldangelo/open-webring
webring
Last synced: 4 days ago
JSON representation
Join a webring or create your own.
- Host: GitHub
- URL: https://github.com/mldangelo/open-webring
- Owner: mldangelo
- Created: 2020-12-11T05:40:55.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-02T09:25:36.000Z (6 months ago)
- Last Synced: 2024-10-28T11:17:13.147Z (15 days ago)
- Topics: webring
- Language: JavaScript
- Homepage: https://openwebring.com
- Size: 4.18 MB
- Stars: 14
- Watchers: 3
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# open-webring
Join a webring, create your own, or fork this repository and host your own for free.
Rings are available at https://openwebring.com/ring/[slug].json. See the [sample](public/ring/sample.json) webring for an example.
## Manifesto
Do you remember when the internet used to be fun? Back in the days before search engines indexed everything, before the internet was hyper-optimized for business, webrings were the de-facto way to discover content. Open-Webring is designed for hobbyists, enthusiasts, artists, nostalgists, and creatives that would like to share their work in inclusive, online communities.
*nostalgia from my childhood -from the now defunct [webring.org](https://web.archive.org/web/19991013135810/http://webring.org/).*
Reproduced from [here](http://www.ke5fx.com/tesla.html).
TODO: Talk about membership.
## How To Join a Webring
1. Add an entry to the ring you wish to join in [public/ring](public/ring) and submit a PR to this repository. For example, we can join the [sample](public/ring/sample.json) webring which has the has the schema definition:
```json
{
"name": "string",
"title": "string",
"url": "string"
}
```
so a valid entry could be:
```json
{
"name": "Michael D'Angelo",
"title": "Software Engineer",
"url": "https://mldangelo.com"
}
```
1. Add open-webring to your website. Webrings can be added to your site in many formats. The simplest way is to add:
```html
```
to your website.
Alternatively, you can add an iframe:
```html
```
Or fetch and parse the webring yourself using javascript
```javascript
fetch('https://openwebring.com/ring/sample.json')
.then(response => response.json())
.then(data => console.log(data));
```
1. After we've validated that you have added open-webring to your site, we'll merge your PR and welcome you into the community.
## Goals
- Free, serverless webrings for anyone that wants to join.
- J~~A~~M Stack. Use github as a JSON api - Heavily leverage GH ecosystem.
- track changes to rings via git diff.
- Enforce participation / auto moderation.
## Developing
Developed with: node >= v14. [nvm](https://github.com/nvm-sh/nvm#installing-and-updating) is recommended for managing node versions.
This repository is split into multiple parts:
1. [src](/src) which contains a Next.js app hosted at [openwebring.com](https://openwebring.com).
2. [public/ring](public/ring) which contains webring schemas and data.
## Inspired By
1. [webring.org](https://web.archive.org/web/19991013135810/http://webring.org/) Circa 1999.
2. [ianww.com](http://www.ianww.com/) (probably would not have worked on this if I hadn't asked to join his webring)
3. https://github.com/topics/webring - only 8 entries - none are communities
4. https://github.com/XXIIVV/webring https://github.com/ckipp01/webring-cli - most active webring on github?
5. https://github.com/maxboeck/webring - closest to this project
6. https://github.com/hackclub/webring
7. https://github.com/susam/10kbclub