doc/plugins/contrib/showdiff.mdwn

   1 [[template id=plugin name=showdiff author="[[JeremieKoenig]]"]]
   2 [[tag type/useful]]
   3
   4 This plugin, which can be downloaded
   5 [here](http://www.jk.fr.eu.org/ikiwiki/showdiff.pm),
   6 adds a "Show Diff" button to the page edition template.
   7 When clicked, a diff between the stored page and provided content
   8 is shown in the "Page Preview" area.
   9
  10 It depends on
  11 [this patch](http://www.jk.fr.eu.org/ikiwiki/pluggable_editpage_buttons.diff),
  12 which does the following:
  13
  14   * add a title to the editpage form;
  15   * pass a reference to the list of buttons to the formbuilder_setup
  16     hooks, so we can add ours;
  17   * relax asumption about the possible submit values (use "Save Page"
  18     explicitly);
  19   * de-hardcode the submit buttons from the editpage template
  20     (was this intended to work around something?).
  21
  22 > That was there to work around a bug in CGI::FormBuilder 3.0401
  23 > that broke FORM-SUBMIT on customised templates. That seems to be
  24 > fixed in the newer version ikiwiki already depends on. Patch accepted.
  25 > --[[Joey]]
  26
  27 ## Problems
  28
  29 No special handling is done of concurrent edits: changes introduced
  30 independently will show up in the requested diff, although they will
  31 be merged when the page is saved. I suspect even detecting this case
  32 would require changes in the RCS backends.