aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins
diff options
context:
space:
mode:
authorintrigeri <intrigeri@boum.org>2010-12-20 15:21:49 +0100
committerintrigeri <intrigeri@boum.org>2012-04-28 00:18:59 +0200
commit5b494e1b636f4c26c14c9cf8f964bef0a70c784a (patch)
tree61f73f8c4cae2357c6f2f5a4a37f71ab402931ad /doc/plugins
parente09eeb24363a3e0033102c894cef347afd89b0c2 (diff)
downloadikiwiki-5b494e1b636f4c26c14c9cf8f964bef0a70c784a.tar
ikiwiki-5b494e1b636f4c26c14c9cf8f964bef0a70c784a.tar.gz
mirrorlist: new mirrorlist_use_cgi boolean setting.
When set to true, let each mirror's ikiwiki CGI find out the correct target page url themselves. This resolves the usecase described on [[todo/mirrorlist_with_per-mirror_usedirs_settings]]. Signed-off-by: intrigeri <intrigeri@boum.org>
Diffstat (limited to 'doc/plugins')
-rw-r--r--doc/plugins/mirrorlist.mdwn15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/plugins/mirrorlist.mdwn b/doc/plugins/mirrorlist.mdwn
index aedc1f4a0..b63685813 100644
--- a/doc/plugins/mirrorlist.mdwn
+++ b/doc/plugins/mirrorlist.mdwn
@@ -5,3 +5,18 @@ This plugin allows adding links a list of mirrors to each page in the
wiki. For each mirror, a name and an url should be specified. Pages are
assumed to exist in the same location under the specified url on each
mirror.
+
+In case the `usedirs` setting is not the same on all your mirrors, or
+if it is not the same on your local wiki as on the mirror a
+possibility is to let each mirror's ikiwiki CGI find out the correct
+target page url themselves; in that case the mirrors urls must be set
+to their ikiwiki CGI url instead of their base url. Example:
+
+ mirrorlist_use_cgi => 1,
+ mirrorlist => {
+ 'mirror1' => 'https://mirror.example.org/ikiwiki.cgi',
+ 'mirror2' => 'https://mirror2.example.org/ikiwiki.cgi',
+ },
+
+The mirrors must have the ikiwiki CGI and the [[goto]] plugin enabled
+for this to work.