CogPlanet
=========

CogPlanet is a planet server.  It aggregates content from multiple
syndication feeds and displays the feeds in chronological order on its
homepage.

More information regarding the project can be found at:
http://achievewith.us/projects/cogplanet

Please submit bugs and/or patches at the URL above.  This project is
still very new, so there are many bugs and patches to submit.

Installation
------------

This is a TurboGears (http://www.turbogears.org) project. It can be
started by running the start-cogplanet.py script.  Before doing so,
follow these steps:

0. Install dependencies:
   # easy_install BeautifulSoup Genshi SQLAlchemy "TurboGears==1.0b2"
   - download and install [http://feedparser.org/ Universal Feed Parser]
1. Set a value for sqlalchemy.dburi in your configuration file
   (dev.cfg by default)
2. Run tg-admin sql create

During your first time running start-cogplanet.py, you will be asked a
few questions to boostrap your installation.  Once answered, you will
not be bothered again.  If for some reason you would like to disable
this boostrapping process, set easy_config.enabled=False in your
configuration file.

Your help in documenting deployment via egg files is appreciated.  To
the best of our knowledge there is no way to run the 'tg-admin sql
create' command without having the project directory available.

Contacts
--------

Tim Freund:  email: "tim *at* achievewith *dot* us"
             irc:   timphnode on irc.freenode.net
             gtalk: timfreund *at* gmail *dot* com 
             aim:   tpfreund

Links
-----
[http://www.planetplanet.org/ Planet]
[http://turbogears.org TurboGears]
[http://feedparser.org/ Universal Feed Parser]