98f09014e35a167bfd482da26557afec233865dd
[ikiwiki.git] / 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 Commits to this git repository are fed into [CIA](http://cia.vc), and can
20 be browsed, subscribed to etc on its
21 [project page](http://cia.vc/stats/project/ikiwiki). They're also fed into
22 [twitter](http://twitter.com/ikiwiki).
23
24 ## personal git repositories
25
26 You are of course free to set up your own ikiwiki git repository with your
27 own [[patches|patch]]. If you list it here, the `gitremotes` script will
28 automatically add it to git remotes. Your repo will automatically be pulled
29 into [[Joey]]'s working repository where he can see your branches and
30 think about merging them. This is recommended. :-)
31
32 <!-- Machine-parsed format: * wikilink <git:url> -->
33
34 * github `git://github.com/joeyh/ikiwiki.git`
35   ([browse](http://github.com/joeyh/ikiwiki/tree/master))  
36   A mirror of the main repo, automatically updated.
37 * l10n `git://l10n.ikiwiki.info/`
38   Open push localization branch used for <http://l10n.ikiwiki.info/>
39 * [[smcv]] `git://git.pseudorandom.co.uk/git/smcv/ikiwiki.git`
40 * [[intrigeri]] `git://gaffer.ptitcanardnoir.org/ikiwiki.git`
41 * [[gmcmanus]] `git://github.com/gmcmanus/ikiwiki.git`
42 * [[jelmer]] `git://git.samba.org/jelmer/ikiwiki.git`
43 * [[hendry]] `git://webconverger.org/git/ikiwiki`
44 * [[jon]] `git://github.com/jmtd/ikiwiki.git`
45 * [[ikipostal|DavidBremner]] `git://pivot.cs.unb.ca/git/ikipostal.git`
46 * [[ikimailbox|DavidBremner]] `git://pivot.cs.unb.ca/git/ikimailbox.git`
47 * [[ikiplugins|DavidBremner]] `git://pivot.cs.unb.ca/git/ikiplugins.git`
48 * [[jonas|JonasSmedegaard]] `git://source.jones.dk/ikiwiki-upstream`
49 * [[arpitjain]] `git://github.com/arpitjain11/ikiwiki.git`
50 * [[chrysn]] `git://github.com/github076986099/ikiwiki.git`
51 * [[simonraven]] `git://github.com/kjikaqawej/ikiwiki-simon.git`
52 * [[schmonz]] `git://github.com/schmonz/ikiwiki.git`
53 * [[will]] `http://www.cse.unsw.edu.au/~willu/ikiwiki.git`
54 * [[kaizer]] `git://github.com/engla/ikiwiki.git`
55 * [[bbb]] `http://git.boulgour.com/bbb/ikiwiki.git`
56 * [[KathrynAndersen]] `git://github.com/rubykat/ikiplugins.git`
57 * [[ktf]] `git://github.com/ktf/ikiwiki.git`
58 * [[tove]] `git://github.com/tove/ikiwiki.git`
59 * [[GiuseppeBilotta]] `git://git.oblomov.eu/ikiwiki`
60 * [[roktas]] `git://github.com/roktas/ikiwiki.git`
61 * [[davrieb|David_Riebenbauer]] `git://git.liegesta.at/git/ikiwiki`
62   ([browse](http://git.liegesta.at/?p=ikiwiki.git;a=summary))
63 * [[GustafThorslund]] `http://gustaf.thorslund.org/src/ikiwiki.git`
64 * [[peteg]] `git://git.hcoop.net/git/peteg/ikiwiki.git`
65 * [[privat]] `git://github.com/privat/ikiwiki.git`
66 * [[blipvert]] `git://github.com/blipvert/ikiwiki.git`
67 * [[bzed|BerndZeimetz]] `git://git.recluse.de/users/bzed/ikiwiki.git`
68 * [[wtk|W. Trevor King]]: `git://github.com/wking/ikiwiki.git`
69
70 ## branches
71
72 In order to refer to a branch in one of the above git repositories, for
73 example when submitting a [[patch]], you can use the
74 [[templates/gitbranch]] template.
75
76 Some of the branches included in the main repository include:
77
78 * `gallery` contains the [[todo/Gallery]] plugin. It's not yet merged
79   due to license issues.  Also some bits need to be tweaked to make it
80   work with the current *master* branch again.
81 * `wikiwyg` adds [[todo/wikiwyg]] support. It is unmerged pending some
82   changes.
83 * `debian-stable` is used for updates to the old version included in
84   Debian's stable release, and `debian-testing` is used for updates to
85   Debian's testing release. (These and similar branches will be rebased.)
86 * `ignore` gets various branches merged to it that Joey wishes to ignore
87   when looking at everyone's unmerged changes.
88 * `pristine-tar` contains deltas that
89   [pristine-tar](http://kitenet.net/~joey/code/pristine-tar)
90   can use to recreate released tarballs of ikiwiki