Project

harvester

0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
The harvester collects your favourite feeds and generates static html/feed pages
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Project Readme

Harvester 0.8¶ ↑

The Harvester is a web-based Feed-Aggregator

Running instances can be seen at: blog-harvester.de or rubynetz.de

The Harvester eats the feeds you want and produces a static html/feed page that aggregates all those.

Warning¶ ↑

Harvester 0.8 is alpha quality! There are still some unfixed bugs (e.g. database stuff)

Installation¶ ↑

Install the harvester with

gem install harvester --pre

You can now create a new harvester project with

harvester new <project_directory>

Then you will need to configure config.yaml, collections.yaml and the templates to suit your needs (see below). You also have to run harvester db create (in that directory) to create your initial database structure.

Configuration¶ ↑

config.yaml contains general configuration, like paths, logs and timeouts. You can also configure your database there. The default database backend is SQLite3, but all the following ones are supported:

  • SQLite3

  • PostgreSQL

  • MySQL

The collections.yaml file contains the links to your desired feeds.

Usage¶ ↑

Then run

harvester run

in the project directory or run

harvester run -c path/to/config.yaml

This will create the output files. That’s it ;).

Usually, you want to run this command automatically every x seconds/minutes. You can use a program like cron or simply run

harvester clock <time>

to start a simple scheduler.

There some more harvester commands to explore. Run

harvester

to get a command list.

Customizing the templates¶ ↑

Todo¶ ↑

  • Still some things broken after update

  • Fix database issues

  • Fix wrong tweet escaping (sometimes: ä–>&auml;)

  • Improve/fix feed parsing (especially atom)

  • Fix chart generation

  • Tidy up templates / remove astro-specific links

  • Extract mrss.rb into extra gem

  • Security issues

  • Optimize performance

  • Fix jabber bot

  • Implement some kind of tag filters

Credits¶ ↑

  • Astro (2005-2008)

  • Neingeist

  • Tigion

  • Josef Spillner

  • J-_-L

  • Others (MySQL patch)