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 tree. This is recommended. :-)
  30
  31 <!-- Machine-parsed format: * wikilink <git:url> -->
  32
  33 * github `git://github.com/joeyh/ikiwiki.git`
  34   ([browse](http://github.com/joeyh/ikiwiki/tree/master))
  35   A mirror of the main repo, automatically updated.
  36 * l10n `git://l10n.ikiwiki.info/`
  37   Open push localization branch used for <http://l10n.ikiwiki.info/>
  38 * [[smcv]] `git://git.pseudorandom.co.uk/git/smcv/ikiwiki.git`
  39 * [[intrigeri]] `git://gaffer.ptitcanardnoir.org/ikiwiki.git`
  40 * [[gmcmanus]] `git://github.com/gmcmanus/ikiwiki.git`
  41 * [[jelmer]] `git://git.samba.org/jelmer/ikiwiki.git`
  42 * [[hendry]] `git://webconverger.org/git/ikiwiki`
  43 * [[jon]] `git://github.com/jmtd/ikiwiki.git`
  44 * [[ikipostal|DavidBremner]] `git://pivot.cs.unb.ca/git/ikipostal.git`
  45 * [[ikimailbox|DavidBremner]] `git://pivot.cs.unb.ca/git/ikimailbox.git`
  46 * [[ikiplugins|DavidBremner]] `git://pivot.cs.unb.ca/git/ikiplugins.git`
  47 * [[jonas|JonasSmedegaard]] `git://source.jones.dk/ikiwiki-upstream`
  48 * [[arpitjain]] `git://github.com/arpitjain11/ikiwiki.git`
  49 * [[chrysn]] `git://github.com/github076986099/ikiwiki.git`
  50 * [[simonraven]] `git://github.com/kjikaqawej/ikiwiki-simon.git`
  51 * [[schmonz]] `git://github.com/schmonz/ikiwiki.git`
  52 * [[will]] `http://www.cse.unsw.edu.au/~willu/ikiwiki.git`
  53 * [[kaizer]] `git://github.com/engla/ikiwiki.git`
  54 * [[bbb]] `http://git.boulgour.com/bbb/ikiwiki.git`
  55 * [[KathrynAndersen]] `git://github.com/rubykat/ikiplugins.git`
  56
  57 ## branches
  58
  59 Some of the branches included in the main repository include:
  60
  61 * `gallery` contains the [[todo/Gallery]] plugin. It's not yet merged
  62   due to license issues.  Also some bits need to be tweaked to make it
  63   work with the current *master* branch again.
  64 * `html` is an unfinished attempt at making ikiwiki output HTML 4.01
  65   instead of xhtml.
  66 * `wikiwyg` adds [[todo/wikiwyg]] support. It is unmerged pending some
  67   changes.
  68 * `debian-stable` is used for updates to the old version included in
  69   Debian's stable release, and `debian-testing` is used for updates to
  70   Debian's testing release. (These and similar branches will be rebased.)
  71 * `ignore` gets various branches merged to it that Joey wishes to ignore
  72   when looking at everyone's unmerged changes.
  73 * `pristine-tar` contains deltas that
  74   [pristine-tar](http://kitenet.net/~joey/code/pristine-tar)
  75   can use to recreate released tarballs of ikiwiki