en/preface.txt

   1 = Git Magic =
   2 Ben Lynn
   3 August 2007
   4
   5 == Preface ==
   6
   7 http://git-scm.com/[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  - link:/\~blynn/gitmagic/intl/zh_cn/[Simplified Chinese]: by JunJie, Meng and JiangWei. Converted to link:/~blynn/gitmagic/intl/zh_tw/[Traditional Chinese] via +cconv -f UTF8-CN -t UTF8-TW+.
  16  - link:/~blynn/gitmagic/intl/fr/[French]: by Alexandre Garel, Paul Gaborit, and Nicolas Deram.
  17  - link:/~blynn/gitmagic/intl/de/[German]: by Benjamin Bellee and Armin Stebich; also http://gitmagic.lordofbikes.de/[hosted on Armin's website].
  18  - link:/~blynn/gitmagic/intl/it/[Italian]: by Mattia Rigotti.
  19  - link:/~blynn/gitmagic/intl/ko/[Korean]: by Jung-Ho (John) Han; also https://sites.google.com/site/drinkhanjohn/useful-links/[hosted on John's website].
  20  - link:/~blynn/gitmagic/intl/pl/[Polish]: by Damian Michna.
  21  - link:/~blynn/gitmagic/intl/pt_br/[Brazilian Portuguese]: by José Inácio Serafini and Leonardo Siqueira Rodrigues.
  22  - link:/~blynn/gitmagic/intl/ru/[Russian]: by Tikhon Tarnavsky, Mikhail Dymskov, and others.
  23  - link:/~blynn/gitmagic/intl/es/[Spanish]: by Rodrigo Toledo and Ariset Llerena Tapia.
  24  - link:/~blynn/gitmagic/intl/uk/[Ukrainian]: by Volodymyr Bodenchuk.
  25  - link:/~blynn/gitmagic/intl/vi/[Vietnamese]: by Trần Ngọc Quân; also http://vnwildman.users.sourceforge.net/gitmagic/[hosted on his website].
  26
  27 .Other Editions
  28
  29  - link:book.html[Single webpage]: barebones HTML, with no CSS.
  30  - link:book.pdf[PDF file]: printer-friendly.
  31  - link:book.epub[EPUB file]: E-reader-friendly.
  32  - 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].
  33  - 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.
  34
  35 === Thanks! ===
  36
  37 I'm humbled that so many people have worked on translations of these pages. I
  38 greatly appreciate having a wider audience because of the efforts of those
  39 named above.
  40
  41 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, Tyler Breisacher, Sonia Hamilton, Julian Haagsma, Romain Lespinasse, Sergey Litvinov, Oliver Ferrigni, David Toca, Сергей Сергеев, Joël Thieffry, and Baiju Muthukadan contributed corrections and improvements.
  42
  43 François Marier maintains the Debian package originally created by Daniel
  44 Baumann.
  45
  46
  47 My gratitude goes to many others for your support and praise. I'm tempted to
  48 quote you here, but it might raise expectations to ridiculous heights.
  49
  50 If I've left you out by mistake, please tell me or just send me a patch!
  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://git.assembla.com/gitmagic.git
  63  $ git clone git@bitbucket.org:blynn/gitmagic.git
  64
  65 GitHub, Assembla, and Bitbucket support private repositories, the latter two
  66 for free.