X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;ds=sidebyside;f=README;h=2d00e23c51296e9bb664738dfe3bd7a5c8d7dc70;hb=a2e53060c38a625b493b3afa109469d4032a296b;hp=f93cf6c83b78b238829fe74914085618e3b2487a;hpb=690c1c4816af675eaed32b8e178cbb100b7e46d0;p=tt-rss.git diff --git a/README b/README index f93cf6c8..2d00e23c 100644 --- a/README +++ b/README @@ -1,48 +1,86 @@ Tiny Tiny RSS ============= -Server-side RSS feed aggregator written in PHP and heavily based -on XmlHttpRequest and related technologies for user interface and -operation. +Web-based news feed aggregator, designed to allow you to read news from +any location, while feeling as close to a real desktop application as possible. -Licensed under GPL version 2. + http://tt-rss.spb.ru -Warning: I don't know how to stress it enough - please do not install -this program wide open to the whole internet. It belongs to (host or password) -protected directory on your webserver. There could be SQL-injection or other -remote vulnerabilities, so beware. +Copyright (C) 2005 Andrew Dolgov unless stated otherwise. -Version 1.1 adds experimental support for multi-user operation, disable option -SINGLE_USER_MODE to access it. Default user is "admin" with password "password", -don't forget to change it. +Portions (C): -Interface: + Bob Osola (pngfix.js) + Sundar Dorai-Raj (isNumeric() in functions.js) - There is (incomplete) support for keyboard navigation. - - "n" and "p" moves between next/previous posts when feed is opened; - "r" refreshes feed list; - "u" refreshes currently selected feed; - "a" hides or shows only unread feeds in the feedlist; +Uses Prototype javascript library, from http://prototype.conio.net/ -Requirements: - - - Magpie RSS (http://magpierss.sourceforge.net/) - place it into - magpierss/ subdirectory; - - - RDBMS backend: +Licensed under GNU GPL version 2 + +Features Overview +================= + + Updates: http://tt-rss.spb.ru/trac/wiki/FeatureList + + * Server-side application, user only needs a web browser + * Supports RSS, RDF, Atom feeds using Magpie library + * Supports OPML import/export + * Easy setup and configuration + * Streamlined interface using XmlHttpRequest (or AJAX for laypeople) + +Requirements +============ + + * Compatible browser on the client side + + Basically, Firefox, Konqueror or MSIE6 are okay. See here + for more information: + + http://tt-rss.spb.ru/trac/wiki/CompatibleBrowsers + + * Web server, for example Apache + * PHP (requires PHP4 DOMXML extension) + * MagpieRSS feed parser (http://magpierss.sourceforge.net/) + + * PostgreSQL (tested on 7.4) or MySQL (InnoDB and version 4.1+ required) + + * XML-RPC for PHP library for XML-RPC support. Optional. - a) PostgreSQL - - b) MySQL (InnoDB and server version 4.1+ required) + http://phpxmlrpc.sourceforge.net + +Installation Notes +================== + + Updates: http://tt-rss.spb.ru/trac/wiki/InstallationNotes + + * If you are upgrading from the previous version, don't forget to update + schema and logout. + + * icons directory should be writable to your httpd user if you plan on + using feed icons + + * Leave DB_HOST empty if you want to connect to database via unix socket + + * For PostgreSQL don't forget to create database with UTF-8 encoding + + createdb -E utf-8 -O owner_user database) + + * Don't forget to change your password from default value on your first login + + * Check your config.php for blank lines out of PHP code tags (e.g. + before ), See #1 + + * Default username:password for multiuser mode is admin:password. - Example DB schemas and configuration are in schema/ subdirectory. - - For PostgreSQL don't forget to create database with UTF-8 encoding - (createdb -E UTF-8 -O owner_user database). +See also +======== -Don't forget to copy config.php-dist to config.php and edit it. + * FAQ: http://tt-rss.spb.ru/trac/wiki/FrequentlyAskedQuestions + * Forum: http://tt-rss.spb.ru/forum + * Wiki: http://tt-rss.spb.ru/trac/wiki/WikiStart + * Bug Tracker: http://tt-rss.spb.ru/trac/report -icons/ directory should be writable for your httpd user. +Contact +======= Send your questions, comments, patches to Andrew Dolgov