add awesome feeds

Author: geraldb

README.md

@@ -9,3 +9,11 @@ Gem Familiy
 
 
 
+
+
+
+
+More
+
+[**awesome-feeds**](awesome-feeds) - a collection of awesome feeds (formats, readers, services & tools, templates 'n' more) - JSON Feed, RSS, Atom, HTML w/ Microformats, Feed.TXT
+

awesome-feeds/FORMATS.md

@@ -0,0 +1,104 @@
+
+# Awesome Feeds > Formats
+
+
+Note: (†) used for historic formats (no longer in use or obsolete or were just experimental)
+
+
+## RSS "Family"
+
+
+### RSS 0.9 (†)  (RDF Site Summary) 
+
+by Netscape
+
+
+### RDF / RSS 1.0 (†) (RDF Site Summary)
+
+by rdf-dev-group 
+
+
+### RSS 2.0, 0.92 (†), 0.91 (†)   (Really Simple Syndication)
+
+by Dave Winer (DW) - formerly UserLand
+
+#### RSS.js / RSS.json / RSS-in-JSON / RSS-in-JS by Dave Winer
+
+See [`rssjs.org`](http://rssjs.org).
+
+- [RSS-in-JSON is a feed format](https://github.com/scripting/Scripting-News/blob/master/rss-in-json/README.md) by Dave Winer, June 2017
+
+
+### RSS 3.0 (†)
+
+by Aaron Swartz
+
+See [RSS 3.0](http://www.aaronsw.com/2002/rss30), 2002
+
+- [The Road to RSS 3.0](http://www.aaronsw.com/weblog/000574) by Aaron Swartz, September 2002
+
+Plain Text with key value pairs and multi-line values with indentation.
+
+
+
+### RSS 5.0   (Really Simple, Stupid or Really Simple Sharing)
+
+See Feed.TXT
+
+
+### More RSS
+
+- [RSS @ Wikipedia](https://en.wikipedia.org/wiki/RSS)
+
+
+## Atom
+
+- [Atom (standard) @ Wikipedia](https://en.wikipedia.org/wiki/Atom_(standard))
+
+
+
+## JSON Formats
+
+### JSON Feed
+
+See [`jsonfeed.org`](https://jsonfeed.org).
+
+### Activity Streams
+
+See [`activitystrea.ms`](http://activitystrea.ms)
+
+- [Activity_Streams (format) @ Wikipedia](https://en.wikipedia.org/wiki/Activity_Streams_(format))
+
+### Collection+JSON
+
+See [Collection+JSON - Hypermedia Type](http://amundsen.com/media-types/collection/)
+
+Collection+JSON is a JSON-based read/write hypermedia-type designed to support management and querying of simple collections. It is similar to the The Atom Syndication Format (RFC4287) and the The Atom Publishing Protocol (RFC5023) . However, Collection+JSON defines both the format and the semantics in a single media type. It also includes support for Query Templates and expanded write support through the use of a Write Template.
+
+
+
+
+## YAML Feed (†)
+
+- [YAMLFeed @ Indie Web](https://indieweb.org/YAMLFeed) (twitter: [yamlfeed](https://twitter.com/yamlfeed)) - Launched as a "practical" lulz joke - keep the formats wars (eg. rss vs atom) alive (e.g. now json vs yaml).
+
+
+## Microformats
+
+### Microformats V1  hentry/hatom
+
+### Microformats V2  h-entry/h-feed
+
+
+
+## Feed.TXT
+
+See [Feed.TXT](https://feedtxt.github.io).
+
+A Free Feeds Format in Plain Text w/ Structured Meta Data
+
+
+
+
+## More
+

awesome-feeds/METADATA.md

@@ -0,0 +1,152 @@
+
+# Awesome Feeds > Meta Data
+
+How many ways to add
+
+- Author
+- Title
+- Date 
+
+Let's count ;-)
+
+
+
+## Person / People
+
+- **creator**            -- Dublin Core Meta Data
+- **publisher**          -- Dublin Core Meta Data
+- **author**             -- RSS 2.0, Atom, JSON Feed
+- **contributor**        -- Atom
+- **managingEditor**     -- RSS 2.0 Channel
+- **webMaster**          -- RSS 2.0 Channel
+
+
+## Dates
+
+- **published**         -- Atom
+- **pubDate**           -- RSS 2.0
+- **date_published**    -- JSON Feed
+- **date**              -- Dublin Core Meta Data
+- **updated**           -- Atom
+- **date_modified**     -- JSON Feed
+- **lastBuildDate**     -- RSS 2.0 Channel
+
+
+## Title
+
+- **title**             -- Atom / RSS 2.0 / JSON Feed
+- **name**
+
+
+_2nd Level Title_
+
+- **subtitle**          -- Atom  
+- **tagline**
+
+
+## Summary
+
+- **summary**          -- Atom / JSON Feed
+- **description**      -- RSS 2.0
+- **abstract**    
+- **excerpt**
+
+
+## Content
+
+- **content**          -- Atom (Defaults to Text!), RSS Yahoo! Search (Media) Extension 
+- **content type="text|html|xhtml"**   -- Atom (Defaults to Text!)
+- **content_text**     -- JSON Feed
+- **content_html**     -- JSON Feed
+- **content:encoded**  -- RDF Content Module
+
+
+
+## Tags / Categories
+
+- **category**   -- RSS 2.0
+- **category term=**  -- Atom
+- **tags[]**     -- JSON Feed
+- **keywords**
+
+_Scheme_
+
+- **scheme**     -- Atom
+- **domain**     -- RSS 2.0
+
+
+## Link
+
+- **url**      -- JSON Feed
+- **link**     -- RSS 2.0
+- **link href=**   -- Atom 
+
+
+_More Links_
+
+- **home_page_url**   -- JSON Feed (site url)
+- **feed_url**        -- JSON Feed (feed url)
+- **link href= rel="self"**        -- Atom (feed url)
+- **link href= rel="alternate"**   -- Atom (site url)
+
+
+## ID
+
+- **id**      -- Atom, JSON Feed
+- **guid**    -- RSS 2.0
+- **permalink**
+
+
+## Attachments
+
+- **attachments[] url=**            -- JSON Feed
+- **enclosure url=**              -- RSS 2.0
+- **link href= rel="enclosure"**   -- Atom
+
+_Examples_
+
+JSON Feed:
+
+``` json
+"attachments": [
+                {
+                    "url": "http://therecord.co/downloads/The-Record-sp1e1-ChrisParrish.m4a",
+                    "mime_type": "audio/x-m4a",
+                    "size_in_bytes": 89970236,
+                    "duration_in_seconds": 6629
+                }
+            ]
+```
+
+RSS 2.0:
+
+``` xml
+<enclosure url="http://www.example.org/myaudiofile.mp3"
+                 length="12345"
+                 type="audio/mpeg" />
+```
+
+Atom:
+
+``` xml
+   <link rel="enclosure"
+          type="audio/mpeg"
+          title="MP3"
+          href="http://www.example.org/myaudiofile.mp3"
+          length="1234" />
+    <link rel="enclosure"
+          type="application/x-bittorrent"
+          title="BitTorrent"
+          href="http://www.example.org/myaudiofile.torrent"
+          length="1234" />
+```
+
+
+## More - What's Missing?
+
+- add banner image for item / entry?
+- add image / cover for feed / channel?
+- add (fav)icon for feed / channel?
+- add language ?
+- add expired yes/no or with date?
+