From fbedc2169fbb02312d5de8e33c59da2de2e28f1c Mon Sep 17 00:00:00 2001 From: Cédric Bonhomme Date: Wed, 9 Apr 2014 08:13:50 +0200 Subject: Updated README. --- README.md | 99 --------------------------------------------------------------- 1 file changed, 99 deletions(-) delete mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md deleted file mode 100644 index 856bd08d..00000000 --- a/README.md +++ /dev/null @@ -1,99 +0,0 @@ -pyAggr3g470r -============ - -#### A simple Python news aggregator. - -Presentation ------------- -[pyAggr3g470r](https://bitbucket.org/cedricbonhomme/pyaggr3g470r/) is a news aggregator with a web interface -based on [Flask](http://flask.pocoo.org/). - -Features --------- - -* the database is managed with [SQLAlchemy](http://www.sqlalchemy.org/); -* feeds batch import with OPML files; -* export all your feeds to OPML; -* e-mail notification; -* export articles to HTML; -* favorite articles; -* share articles with Google +, Pinboard and reddit. - - -Deployment ----------- - -This application can be deployed both on Heroku and on a traditional server. - -Deploying the application on Heroku -''''''''''''''''''''''''''''''''''' - -.. code:: bash - - $ git clone https://bitbucket.org/cedricbonhomme/pyaggr3g470r.git - $ cd pyaggr3g470r - $ heroku create - $ heroku addons:add heroku-postgresql:dev - $ heroku config:set HEROKU=1 - $ git push heroku master - $ heroku run init - $ heroku ps:scale web=1 - - -Deploying the application on a traditional server -''''''''''''''''''''''''''''''''''''''''''''''''' - -.. code:: bash - - $ git clone https://bitbucket.org/cedricbonhomme/pyaggr3g470r.git - $ cd pyaggr3g470r - $ sudo apt-get install postgresql postgresql-server-dev-9.1 postgresql-client - $ sudo pip install --upgrade -r requirements.txt - $ sudo -u postgres createuser - Enter name of role to add: username - Shall the new role be a superuser? (y/n) n - Shall the new role be allowed to create databases? (y/n) y - Shall the new role be allowed to create more new roles? (y/n) n - $ createdb pyAggr3g470r - $ sudo -u postgres psql - postgres=# ALTER USER username WITH ENCRYPTED PASSWORD 'password'; - postgres=# GRANT ALL PRIVILEGES ON DATABASE pyAggr3g470r TO username; - postgres=# \q - $ export DATABASE_URL="postgres://username:password@127.0.0.1:5432/pyAggr3g470r" - $ cp conf/conf.cfg-sample conf/conf.cfg - $ python db_create.py - $ python runserver.py - * Running on http://0.0.0.0:5000/ - * Restarting with reloader - -Configuration (email, proxy, user agent, etc.) is done via the file *conf/conf.cfg*. -For example if you want to use pyAggr3g470r with Tor/Privoxy, you just have to set the value of -*http_proxy* (most of the time: ``http_proxy = 127.0.0.1:8118``). Else leave the value blank. - - -You can connect with the email *root@pyAggr3g470r.localhost* and the password *root*. You should change these information. - - -Automatic updates ------------------ - -You can fetch new articles with [cron](https://en.wikipedia.org/wiki/Cron) and the script *fetch.py*. -For example if you want to check for updates every 30 minutes, add this line to your cron rules (``crontab -e``): - - */30 * * * * cd ~/.pyaggr3g470r/ ; python fetch.py firstname.lastname@mail.com - -You must give the email address you use to login to pyAggr3g470r. - -Donation --------- -If you wish and if you like pyAggr3g470r, you can donate via bitcoin -[1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ](https://blockexplorer.com/address/1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ). -Thank you! - -License -------- -[pyAggr3g470r](https://bitbucket.org/cedricbonhomme/pyaggr3g470r/) is under [GPLv3](http://www.gnu.org/licenses/gpl-3.0.txt) license. - -Contact -------- -[My home page](http://cedricbonhomme.org/). -- cgit