From b144831e462e0d2ba8225f6e5f7d9138efb03c77 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Tue, 6 May 2008 19:06:53 -0400 Subject: pinger/pingee now tested and working --- doc/plugins/pingee.mdwn | 11 +++++++++++ doc/plugins/pinger.mdwn | 26 ++++++++++++++++++++++++++ 2 files changed, 37 insertions(+) create mode 100644 doc/plugins/pingee.mdwn create mode 100644 doc/plugins/pinger.mdwn (limited to 'doc/plugins') diff --git a/doc/plugins/pingee.mdwn b/doc/plugins/pingee.mdwn new file mode 100644 index 000000000..03eeb581c --- /dev/null +++ b/doc/plugins/pingee.mdwn @@ -0,0 +1,11 @@ +[[template id=plugin name=pingee author="[[Joey]]"]] +[[tag type/special-purpose]] + +This plugin causes ikiwiki to listen for pings, typically delivered from +another ikiwiki instance using the [[pinger]] plugin. When a ping is +recieved, ikiwiki will update the wiki, the same as if `ikiwiki --refresh` +were ran at the command line. + +An url such as the following is used to trigger a ping: + + http://mywiki.com/ikiwiki.cgi?do=ping diff --git a/doc/plugins/pinger.mdwn b/doc/plugins/pinger.mdwn new file mode 100644 index 000000000..f747a9f0b --- /dev/null +++ b/doc/plugins/pinger.mdwn @@ -0,0 +1,26 @@ +[[template id=plugin name=pinger author="[[Joey]]"]] +[[tag type/special-purpose]] + +This plugin allows ikiwiki to be configured to hit a URL each time it +updates the wiki. One way to use this is in conjunction with the [[pingee]] +plugin to set up a loosely coupled mirror network, or a branched version of +a wiki. By pinging the mirror or branch each time the main wiki changes, it +can be kept up-to-date. + + \[[!ping from="http://mywiki.com/" + to="http://otherwiki.com/ikiwiki.cgi?do=ping"]] + +The "from" parameter must be identical to the url of the wiki that is doing +the pinging. This is used to prevent ping loops. + +The "to" parameter is the url to ping. The example shows how to ping +another ikiwiki instance. + +The [[cpan LWP]] perl module is used for pinging. Or the [[cpan +LWPx::ParanoidAgent]] perl module is used if available, for added security. +Finally, the [[cpan Crypt::SSLeay]] perl module is needed to support pinging +"https" urls. + +By default the pinger will try to ping a site for 15 seconds before timing +out. This timeout can be changed by setting the `pinger_timeout` +configuration setting in the setup file. -- cgit v1.2.3