Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rsdoiel/antenna

Finding signal through the noise of the net
https://github.com/rsdoiel/antenna

Last synced: 14 days ago
JSON representation

Finding signal through the noise of the net

Awesome Lists containing this project

README

        



Read about Antenna


The Antenna


finding signal in the noise

Anteena


Antenna demonstrates aggregating of news content via web feeds for
personal use. In effect a LinkBlog. It is where I
read the web content I follow. Antenna demonstrates that aggregating
news can be done by an individual with a little effort and a few tools.
We don’t need to rely on large internet companies to be informed or to
keep up to date.


Tools to build this
aggregation



  • Pandoc 3

  • SQLite 3

  • GNU Make

  • skimmer >= 0.0.16

  • Git + GitHub (to host your personal aggregation site)


The moving parts


skimmer is used to
collect data from RSS, Atom and JSON feeds that are listed in a URLs
file. The data collected gets stored in an SQLite 3 database.


The SQLite 3 database can be managed
with simple SQL statements execute from the command line, a script
(e.g. Bash or Python) or in this case a Makefile.
The scripts responsibility is to automatically identify the feed items
to be “saved” for generating this static website.


The skimmer programs comes with a companion program called
skim2md which will read all the saved items in an
SQLite3 database and render them in Markdown. This file is easy to then
process with Pandoc into a full web page.


Pandoc is responsible for rendering
Markdown to HTML5 via a template called front_page.tmpl


The make command is used to run the Makefile and
build the pages. You can then use your favorite web server to share them
or just open them directly in your favorite web browser.


make clean

make

Each aggregation page is populated by it’s own URLs list which builds
the skimmer database used to generate the page.


Antenna is a personal aggregation of items found around the web.
Curated with skimmer and sqlite then rendered with Pandoc.