From: joey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Date: Fri, 17 Aug 2007 00:57:11 +0000 (+0000)
Subject: web commit by http://jeremie.koenig.myopenid.com/: add a plugin page for "showdiff"
X-Git-Tag: 2.6~105
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=52cd9ae4bb891efb73a999d02dc2dffa0fc083be;p=ikiwiki.git

web commit by jeremie.koenig.myopenid.com/: add a plugin page for "showdiff"
---

diff --git a/doc/plugins/contrib/showdiff.mdwn b/doc/plugins/contrib/showdiff.mdwn
new file mode 100644
index 000000000..cedc4311c
--- /dev/null
+++ b/doc/plugins/contrib/showdiff.mdwn
@@ -0,0 +1,27 @@
+[[template id=plugin name=showdiff author="[[JeremieKoenig]]"]]
+[[tag type/useful]]
+
+This plugin, which can be downloaded
+[here](http://www.jk.fr.eu.org/ikiwiki/showdiff.pm),
+adds a "Show Diff" button to the page edition template.
+When clicked, a diff between the stored page and provided content
+is shown in the "Page Preview" area.
+
+It depends on
+[this patch](http://www.jk.fr.eu.org/ikiwiki/pluggable_editpage_buttons.diff),
+which does the following:
+
+  * add a title to the editpage form;
+  * pass a reference to the list of buttons to the formbuilder_setup
+    hooks, so we can add ours;
+  * relax asumption about the possible submit values (use "Save Page"
+    explicitly);
+  * de-hardcode the submit buttons from the editpage template
+    (was this intended to work around something?).
+
+## Problems
+
+No special handling is done of concurrent edits: changes introduced
+independently will show up in the requested diff, although they will
+be merged when the page is saved. I suspect even detecting this case
+would require changes in the RCS backends.