update readme
authorChristian Weiske <cweiske@cweiske.de>
Tue, 22 Oct 2013 17:06:22 +0000 (19:06 +0200)
committerChristian Weiske <cweiske@cweiske.de>
Tue, 22 Oct 2013 17:06:22 +0000 (19:06 +0200)
README.rst

index 108c90cb4e9c8e64a2bd61628ff9bb22382afba6..67d9ac556b05ab449ffebbc63b80b1606a389c08 100644 (file)
@@ -3,6 +3,9 @@ stapibas
 ********
 The standalone Pingback server, written in PHP.
 
 ********
 The standalone Pingback server, written in PHP.
 
+- Receives linkbacks (webmention and pingbacks)
+- Watches your website's Feed to send out linkbacks to all linked URLs
+
 Alternative to `Trackback ‘em All`__
 
 __ http://scott.yang.id.au/code/trackback-em-all/
 Alternative to `Trackback ‘em All`__
 
 __ http://scott.yang.id.au/code/trackback-em-all/
@@ -16,26 +19,30 @@ Dependencies
 - `Console_CommandLine`__
 - `Net_URL2`__
 - `HTTP_Request2`__
 - `Console_CommandLine`__
 - `Net_URL2`__
 - `HTTP_Request2`__
-- `PEAR2 Services_Pingback`__
+- `PEAR2 Services_Linkback`__
 - `SimplePie`__
 
 __ http://pear.php.net/package/Console_CommandLine
 __ http://pear.php.net/package/Net_URL2
 __ http://pear.php.net/package/HTTP_Request2
 - `SimplePie`__
 
 __ http://pear.php.net/package/Console_CommandLine
 __ http://pear.php.net/package/Net_URL2
 __ http://pear.php.net/package/HTTP_Request2
-__ https://github.com/pear2/Services_Pingback
+__ https://github.com/pear2/Services_Linkback
 __ http://simplepie.org/
 
 __ http://simplepie.org/
 
+
 =================
 Pingback receiver
 =================
 stapibas receives pingbacks for your website and puts them into a database.
 
 =================
 Pingback receiver
 =================
 stapibas receives pingbacks for your website and puts them into a database.
 
+It also sends them as email to a configured address.
+
 
 Setup
 =====
 
 Setup
 =====
-Let your website send out the following HTTP header::
+Let your website send out the following HTTP headers::
 
   X-Pingback: http://stapibas.example.org/xmlrpc.php
 
   X-Pingback: http://stapibas.example.org/xmlrpc.php
+  Header set Link '<http://stapibas.example.org/xmlrpc.php>; rel="webmention"'
 
 That's all.
 
 
 That's all.
 
@@ -46,19 +53,23 @@ Pingback sender
 stapibas is able to send pingbacks out to other websites at behalf of
 your website.
 
 stapibas is able to send pingbacks out to other websites at behalf of
 your website.
 
-It does this by watching your website's Atom feed.
+It does this by watching your website's Atom (or RSS) feed.
 Whenever it changes, it fetches the articles that are new or got updated and
 sends out pingbacks to the remote websites.
 
 
 Setup
 =====
 Whenever it changes, it fetches the articles that are new or got updated and
 sends out pingbacks to the remote websites.
 
 
 Setup
 =====
-Insert your feed URL in the ``feeds`` database table.
+Add your feed URL::
+
+  $ ./bin/stapibas feed add http://example.org/feed.atom
 
 Whenever you update your website, tell stapibas about it via a
 
 Whenever you update your website, tell stapibas about it via a
-HTTP POST request::
+HTTP POST request, sending the feed URL::
+
+  $ curl -d url=http://example.org/feed.atom http://stapibas.example.org/request-feed-update.php
 
 
-  $ curl -d url=http://example.org/feed/ http://stapibas.example.org/request-feed-update.php
+This tells stapibas to check this feed the next time the pinger runs.
 
 
 Run the pinger
 
 
 Run the pinger