vim syntax file linked
[ikiwiki] / doc / git.mdwn
1 Ikiwiki, and this documentation wiki, are developed in a git repository and
2 can be checked out like this:
3
4 [[!template id=note text="""
5 You can push changes back to ikiwiki's git repository over the `git://`
6 transport, to update this wiki, if you'd like, instead of editing it on the
7 web. Changes that could not be made via the web will be automatically
8 rejected.
9 """]]
10
11         git clone git://git.ikiwiki.info/
12
13 Or like this if your firewall only passes http traffic (slow):
14
15         git clone http://git.ikiwiki.info/ikiwiki.git/
16
17 The gitweb is [here](http://git.ikiwiki.info/?p=ikiwiki).
18
19 There is also a mirror [on github](http://github.com/joeyh/ikiwiki/tree/master).
20
21 Commits to this git repository are fed into [CIA](http://cia.vc), and can
22 be browsed, subscribed to etc on its
23 [project page](http://cia.vc/stats/project/ikiwiki). They're also fed into
24 [twitter](http://twitter.com/ikiwiki).
25
26 ## branches
27
28 You are of course free to set up your own ikiwiki git repository with your
29 own [[patches|patch]].
30
31 Some of the branches included in the main repository include:
32
33 * `gallery` contains the [[todo/Gallery]] plugin. It's not yet merged
34   due to license issues.  Also some bits need to be tweaked to make it
35   work with the current *master* branch again.
36 * `html` is an unfinished attempt at making ikiwiki output HTML 4.01
37   instead of xhtml.
38 * `wikiwyg` adds [[todo/wikiwyg]] support. It is unmerged pending some
39   changes.
40 * `darcs` is being used to add darcs support.
41 * `pristine-tar` contains deltas that
42   [pristine-tar](http://kitenet.net/~joey/code/pristine-tar)
43   can use to recreate released tarballs of ikiwiki
44 * `debian-stable` is used for updates to the old version included in
45   Debian's stable release, and `debian-testing` is used for updates to
46   Debian's testing release.