X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/5fcbcd6e083616e67667b679a8524a4384b7c926..8b7c2f29bf316e78d49408b3ce4758cbaea4a42f:/doc/git.mdwn diff --git a/doc/git.mdwn b/doc/git.mdwn index eeb05d5f2..511a0a75c 100644 --- a/doc/git.mdwn +++ b/doc/git.mdwn @@ -1,7 +1,58 @@ -[[meta title="Git"]] +Ikiwiki, and this documentation wiki, are developed in a git repository and +can be checked out like this: -[Git](http://git.or.cz) is a distributed revison control system originally developed for the Linux kernel. Ikiwiki supports storing a wiki in git. +[[!template id=note text=""" +You can push changes back to ikiwiki's git repository over the `git://` +transport, to update this wiki, if you'd like, instead of editing it on the +web. Changes that could not be made via the web will be automatically +rejected. +"""]] -Ikiwiki can run as a post-update hook to update a wiki whenever commits -come in. When running as a [[cgi]] with Git, ikiwiki automatically -commits edited pages, and uses the Git history to generate the [[RecentChanges]] page. \ No newline at end of file + git clone git://git.ikiwiki.info/ + +Or like this if your firewall only passes http traffic (slow): + + git clone http://git.ikiwiki.info/ikiwiki.git/ + +The gitweb is [here](http://git.ikiwiki.info/?p=ikiwiki). + +Commits to this git repository are fed into [CIA](http://cia.vc), and can +be browsed, subscribed to etc on its +[project page](http://cia.vc/stats/project/ikiwiki). They're also fed into +[twitter](http://twitter.com/ikiwiki). + +## personal git repositories + +You are of course free to set up your own ikiwiki git repository with your +own [[patches|patch]]. If you list it here, the `gitremotes` script will +automatically add it to git remotes. Your repo will automatically be pulled +into [[Joey]]'s working tree. This is recommended. :-) + + + +* [[github]] + [browse](http://github.com/joeyh/ikiwiki/tree/master) + A mirror of the main repo, automatically updated. +* [[smcv]] +* [[intrigeri]] +* [[gmcmanus]] +* [[jelmer]] + +## branches + +Some of the branches included in the main repository include: + +* `gallery` contains the [[todo/Gallery]] plugin. It's not yet merged + due to license issues. Also some bits need to be tweaked to make it + work with the current *master* branch again. +* `html` is an unfinished attempt at making ikiwiki output HTML 4.01 + instead of xhtml. +* `wikiwyg` adds [[todo/wikiwyg]] support. It is unmerged pending some + changes. +* `darcs` is being used to add darcs support. +* `debian-stable` is used for updates to the old version included in + Debian's stable release, and `debian-testing` is used for updates to + Debian's testing release. +* `pristine-tar` contains deltas that + [pristine-tar](http://kitenet.net/~joey/code/pristine-tar) + can use to recreate released tarballs of ikiwiki