X-Git-Url: https://git.cweiske.de/phinde.git/blobdiff_plain/4fa1d0022a87079f77eddb6a55ad67c82e9c1be3..d35cf6a284f57392ef33703ded46174cc48b6bf5:/README.rst

diff --git a/README.rst b/README.rst
index 3ce17e0..e52581d 100644
--- a/README.rst
+++ b/README.rst
@@ -38,7 +38,9 @@ Dependencies
 ============
 - PHP 5.5+
 - Elasticsearch 2.0
-- Gearman
+- MySQL or MariaDB for WebSub subscriptions
+- Gearman (Debian 9: ``gearman-job-server``, not ``gearman-server``)
+- PHP Gearman extension
 - Console_CommandLine
 - Net_URL2
 - Twig 1.x
@@ -48,19 +50,19 @@ Dependencies
 Setup
 =====
 #. Install and run Elasticsearch and Gearman
+#. Install ``php-gearman``
 #. Get a local copy of the code::
 
      $ git clone https://git.cweiske.de/phinde.git phinde
 
-#. Install dependencies via PEAR::
+#. Install dependencies via composer::
 
-     $ pear install console_commandline net_url2
-     $ pear channel-discover pear.twig-project.org
-     $ pear install twig/Twig
+     $ composer install
 
 #. Point your webserver's document root to phinde's ``www`` directory
 #. Copy ``data/config.php.dist`` to ``data/config.php`` and adjust it.
    Make sure your add your domain to the crawl whitelist.
+#. Create a MySQL database and import the schema from ``data/schema.sql``
 #. Run ``bin/setup.php`` which sets up the Elasticsearch schema
 #. Put your homepage into the queue::
 
@@ -142,6 +144,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
 ============