summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/ping.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive/ping.mdwn')
-rw-r--r--ikiwiki/directive/ping.mdwn19
1 files changed, 19 insertions, 0 deletions
diff --git a/ikiwiki/directive/ping.mdwn b/ikiwiki/directive/ping.mdwn
new file mode 100644
index 0000000..424a848
--- /dev/null
+++ b/ikiwiki/directive/ping.mdwn
@@ -0,0 +1,19 @@
+The `ping` directive is supplied by the [[!iki plugins/pinger desc=pinger]]
+plugin.
+
+This directive 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 [[!iki
+plugins/pingee desc=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.
+
+[[!meta robots="noindex, follow"]]