ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / rcs / monotone.mdwn
1 [Monotone](http://monotone.ca/) is a distributed revision control system.
2 Ikiwiki supports storing a wiki in a Monotone repository and editing it
3 using the [[cgi]] interface. It will use the Monotone logs to generate the
4 [[RecentChanges]] page.
5
6 The monotone support in ikiwiki requires the Monotone perl module to be
7 installed. (It's available from the contrib/ directory in the monotone
8 source.) In particular, it needs version 0.03 or higher of that module.
9 The module is available from the monotone source repository at:
10 <http://viewmtn.angrygoats.net/branch/changes/net.venge.monotone>
11
12 Monotone support works, but there are still a few minor missing bits (listed here so they are not forgotten):
13
14 * Documentation (this page) could be improved.
15
16 There is also a mismatch between the way Ikiwiki handles conflicts and the
17 way Monotone handles conflicts.  At present, if there is a conflict, then
18 Ikiwiki will commit a revision with conflict markers before presenting it
19 to the user.  This is ugly, but there is no clean way to fix it at present.
20
21 Also note that not all recent ikiwiki features have been implemented in the
22 monotone plugin.  At the moment we're missing:
23
24   * [[todo/Untrusted_push_in_Monotone]]