X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=README;h=2d00e23c51296e9bb664738dfe3bd7a5c8d7dc70;hb=7d43b483b89733abe5b16a3f8f3f1d1380f2010e;hp=7be279d167ec0308f4ace31ce87b4de3171c6468;hpb=fbd94c5386d0f150af7e3594669a626150f075e6;p=tt-rss.git diff --git a/README b/README index 7be279d1..2d00e23c 100644 --- a/README +++ b/README @@ -4,51 +4,83 @@ Tiny Tiny RSS 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. + http://tt-rss.spb.ru + Copyright (C) 2005 Andrew Dolgov unless stated otherwise. -Portions: +Portions (C): Bob Osola (pngfix.js) Sundar Dorai-Raj (isNumeric() in functions.js) - -Licensed under GPL version 2. -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. +Uses Prototype javascript library, from http://prototype.conio.net/ -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. +Licensed under GNU GPL version 2 -Interface: +Features Overview +================= - 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; + Updates: http://tt-rss.spb.ru/trac/wiki/FeatureList -Requirements: - - - Magpie RSS (http://magpierss.sourceforge.net/) - place it into - magpierss/ subdirectory; - - - RDBMS backend: + * 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