Table of Contents
darcspatch Plugin
Compatible with DokuWiki
No compatibility info given!
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to darcs
According to his website (2012-06-29), the author of this plugin died in 2011 so this plugin is no longer maintained. Feel free to adopt it if you have any use for it.
This Admin Plugin is a plugin that apply darcs-style “raw” patches to an existing DokuWiki installation.
See darcs for information about darcs.
This plugin only applies “raw” patches (not darcs “patchsets”, “changelogs”, or “diffs”). For instance, raw patches may be found by browsing http://dev.splitbrain.org/darcsweb/darcsweb.cgi?r=dokuwiki;a=summary and selecting the “raw” link. You should only apply patches on release targets which the patch is expecting—there is no versioning within a raw patch. No files are updated unless the grouped changes can be successfully applied. If the application fails, the first error is shown.1) Multiple patches may exist in one file, and are applied independently. You can reverse a patch to essentially un-apply it.
Admin
Apply darcs-style raw patches by providing their URL.2)
Configuration
Optional: Stored patch URLs may be set in Admin Configuration Settings: place each URL on a sepatate line.
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Revision History
- 2007-08-07 — “Reverse” also applies multiple patches in reverse order.
- 2007-08-06 — Added capability to “reverse” (un-apply) the patch.
- 2007-08-05 — Released.
WARNING!
- Repeatedly applying patches may have undesirable effects if the patch does not have sufficient info to recognize that it's been changed before—there is no “history” as there would be in a darcs “patchset”.
- darcs “patchsets” do not work! If you need to use the info from a patchset, you'll probably have to manually create a “raw” patch which only has the final changes.3)
- Most patches require a particular release as a target—make sure you are applying a patch designed for your specific release
- This plugin only modifies existing files—it does not create or delete.
- I use PHP5—I did not test this on PHP4.
Tips
I use this plugin to maintain my own customization of a current DokuWiki installation. I regularly install the latest snapshot, then apply my patches.
I also frequently test another person's modifications or patches to see whether their code works suitably for my needs. If so, I keep it in my saved list of URLs for later reapplication.