en/preface.txt

   1 = Git Magic =
   2 Ben Lynn
   3 August 2007
   4
   5 == Preface ==
   6
   7 http://git.or.cz/[Git] is a version control Swiss army knife. A reliable versatile multipurpose revision control tool whose extraordinary flexibility makes it tricky to learn, let alone master.
   8
   9 As Arthur C. Clarke observed, any sufficiently advanced technology is indistinguishable from magic. This is a great way to approach Git: newbies can ignore its inner workings and view Git as a gizmo that can amaze friends and infuriate enemies with its wondrous abilities.
  10
  11 Rather than go into details, we provide rough instructions for particular effects. After repeated use, gradually you will understand how each trick works, and how to tailor the recipes for your needs.
  12
  13 .Translations
  14
  15  - http://docs.google.com/View?id=dfwthj68_675gz3bw8kj[Chinese (Simplified)]: by JunJie, Meng and JiangWei.
  16  - link:/~blynn/gitmagic/intl/es/[Spanish]: by Rodrigo Toledo and Ariset Llerena Tapia.
  17  - link:/~blynn/gitmagic/intl/de/[German]: by Benjamin Bellee and Armin Stebich. Armin also hosts http://gitmagic.lordofbikes.de/[the German translation on his website].
  18  - link:/~blynn/gitmagic/intl/ru/[Russian]: by Tikhon Tarnavsky, Mikhail Dymskov, and others.
  19  - link:/~blynn/gitmagic/intl/fr/[French]: by Alexandre Garel. Also hosted at http://tutoriels.itaapy.com/[itaapy].
  20  - http://www.slideshare.net/slide_user/magia-git[Portuguese]: by Leonardo Siqueira Rodrigues [http://www.slideshare.net/slide_user/magia-git-verso-odt[ODT version]].
  21
  22 .Other Editions
  23
  24  - link:book.html[Single webpage]: barebones HTML, with no CSS.
  25  - link:book.pdf[PDF file]: printer-friendly.
  26  - http://packages.debian.org/gitmagic[Debian package], http:://packages.ubuntu.com/gitmagic[Ubuntu package]: get a fast and local copy of this site. Handy http://csdcf.stanford.edu/status/[when this server is offline].
  27  - http://www.amazon.com/Git-Magic-Ben-Lynn/dp/1451523343/[Physical book [Amazon.com]]: 64 pages, 15.24cm x 22.86cm, black and white. Handy when there is no electricity.
  28
  29 === Thanks! ===
  30
  31 Dustin Sallings, Alberto Bertogli, James Cameron, Douglas Livingstone, Michael Budde, Richard Albury, Tarmigan, Derek Mahar, Frode Aannevik, Keith Rarick, Andy Somerville, Ralf Recker, Øyvind A. Holm, Miklos Vajna, Sébastien Hinderer, Thomas Miedema, Joe Malin, and Tyler Breisacher contributed corrections and improvements.
  32
  33 François Marier maintains the Debian package originally created by Daniel
  34 Baumann.
  35
  36 JunJie, Meng, JiangWei, Rodrigo Toledo, Leonardo Siqueira Rodrigues,
  37 Benjamin Bellee, and Armin Stebich worked on translations of this guide.
  38
  39 My gratitude goes to many others for your support and praise. I'm tempted to
  40 quote you here, but it might raise expectations to ridiculous heights.
  41
  42 If I've left you out by mistake, please tell me or just send me a patch!
  43
  44 .Free Git hosting
  45
  46  - http://repo.or.cz/[http://repo.or.cz/] hosts free projects. The first Git hosting site. Founded and maintained by one of the earliest Git developers.
  47  - http://gitorious.org/[http://gitorious.org/] is another Git hosting site aimed at open-source projects.
  48  - http://github.com/[http://github.com/] hosts open-source projects for free, and private projects for a fee.
  49
  50 Many thanks to each of these sites for hosting this guide.
  51
  52 === License ===
  53
  54 This guide is released under http://www.gnu.org/licenses/gpl-3.0.html[the GNU General Public License version 3]. Naturally, the source is kept in a Git
  55 repository, and can be obtained by typing:
  56
  57  $ git clone git://repo.or.cz/gitmagic.git  # Creates "gitmagic" directory.
  58
  59 or from one of the mirrors:
  60
  61  $ git clone git://github.com/blynn/gitmagic.git
  62  $ git clone git://gitorious.org/gitmagic/mainline.git