X-Git-Url: https://git.cweiske.de/phinde.git/blobdiff_plain/8512ec548a4f8896aa37678f44de5b88a5a85b24..3d4e82213089a7d7b2c2a17b22cb3eeba302fb7b:/README.rst diff --git a/README.rst b/README.rst index 071f42d..cd3641b 100644 --- a/README.rst +++ b/README.rst @@ -36,28 +36,27 @@ Features ============ Dependencies ============ -- PHP 5.5+ +- PHP 8.x - Elasticsearch 2.0 - MySQL or MariaDB for WebSub subscriptions - Gearman (Debian 9: ``gearman-job-server``, not ``gearman-server``) +- ``gearadmin`` command line tool (``gearman-tools`` package) - PHP Gearman extension -- Console_CommandLine -- Net_URL2 -- Twig 1.x +- Some PHP libraries that get installed with composer ===== Setup ===== #. Install and run Elasticsearch and Gearman -#. Install ``php-gearman`` +#. Install ``php-gearman`` and ``gearman-tools`` #. Get a local copy of the code:: $ git clone https://git.cweiske.de/phinde.git phinde #. Install dependencies via composer:: - $ composer install + $ composer install --no-dev #. Point your webserver's document root to phinde's ``www`` directory #. Copy ``data/config.php.dist`` to ``data/config.php`` and adjust it. @@ -144,6 +143,27 @@ That's delete-by-query 2.0, see https://www.elastic.co/guide/en/elasticsearch/plugins/2.0/delete-by-query-usage.html +Subscribe to a website/feed +=========================== +Phinde supports WebSub__ to get subscribe to changes of a website. +When phinde gets notified by the website's hub about changes, +it will immediately crawl and index the changed pages. + +Subscribe to a website's feed:: + + $ php bin/subscribe.php http://example.org/feed.atom + +Phinde will determine the website's hub and send a registration request to it. + +The status page will show the number of working, and the number of open +subscriptions. + +Unsubscribing also happens on command line:: + + $ php bin/unsubscribe.php http://example.org/feed.atom + +__ https://www.w3.org/TR/websub/ + ============ About phinde ============