Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
680 lines (594 sloc) 20.6 KB
<!DOCTYPE html>
<html lang="de-DE">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Ein grafischer Spickzettel für Git</title>
<link rel='stylesheet' type='text/css' href='visual-git-guide.css'>
<script type="text/javascript" src='visual-git-guide.js'></script>
</head>
<body onload="replace_all_PNGs();">
<h1 id="top">Ein grafischer Spickzettel für Git</h1>
<div id="language-box">
<a>Weitere Sprachen:</a>
<ul>
<li class="selected">Deutsch</li>
<li><a href='index-en.html'>English</a></li>
<li><a href='index-es.html'>Español</a></li>
<li><a href='index-fr.html'>Français</a></li>
<li><a href='index-it.html'>Italiano</a></li>
<li><a href='index-ja.html'>日本語</a></li>
<li><a href='index-ko.html'>한국어</a></li>
<li><a href='index-pl.html'>Polski</a></li>
<li><a href='index-pt.html'>Português</a></li>
<li><a href='index-ru.html'>Русский</a></li>
<li><a href='index-sk.html'>Slovenčina</a></li>
<li><a href='index-vi.html'>Tiếng Việt</a></li>
<li><a href='index-zh-cn.html'>简体中文</a></li>
<li><a href='index-zh-tw.html'>正體中文</a></li>
</ul>
</div>
<p id="link-to-png">
Sollten die
<a href="http://de.wikipedia.org/wiki/Scalable_Vector_Graphics">SVG</a>
Vektorgrafiken nicht angezeigt werden, kann die
<a
href="?no-svg">SVG freie</a>
Variante gewählt werden.
</p>
<p id="link-to-svg">
SVG Vektorgrafiken sind deaktiviert.
<a href="index.html">(SVG aktivieren)</a>
</p>
<p>
Diese Seite ist eine Sammlung elementarer git Befehle. Grundwissen sollte sich hier vertiefen lassen. Wie diese Seite erstellt wurde wird im
<a href='http://github.com/MarkLodato/visual-git-guide'>
GitHub
repository
</a>
erklärt.
</p>
<h2 id="contents">Inhalt</h2>
<ol>
<li>
<a href="#basic-usage">Grundlegende Benutzung</a>
</li>
<li>
<a href="#conventions">Konventionen</a>
</li>
<li>
<a href="#commands-in-detail">Kommandos im Detail</a>
<ol>
<li>
<a href="#diff">Diff</a>
</li>
<li>
<a href="#commit">Commit</a>
</li>
<li>
<a href="#checkout">Checkout</a>
</li>
<li>
<a href="#detached">Commit mit losgelöstem (detached) HEAD</a>
</li>
<li>
<a href="#reset">Reset</a>
</li>
<li>
<a href="#merge">Merge</a>
</li>
<li>
<a href="#cherry-pick">Cherry Pick</a>
</li>
<li>
<a href="#rebase">Rebase</a>
</li>
</ol>
</li>
<li>
<a href="#technical-notes">Technische Notizen</a>
</li>
<li>
<a href="#glossary">Glossar</a>
</li>
</ol>
<h2 id="basic-usage">Grundlegende Benutzung</h2>
<div class="center">
<img src='basic-usage.svg.png'></div>
<p>
Die vier oben in der Grafik erwähnten Kommandos kopieren Dateien zwischen dem Arbeitsverzeichnis, dem Index (stage) und dem Projektarchiv (history).
</p>
<ul>
<li>
<code>git add <em>files</em></code>
kopiert die <em>Dateien</em>
aus dem Arbeitsverzeichnis, in ihrem aktuellen Zustand, in den Index.
</li>
<li>
<code>git commit</code>
speichert einen Schnappschuss des Indexes als Commit im Projektarchiv.
</li>
<li>
<code>git reset -- <em>files</em></code>
macht Änderungen an Dateien im Index rückgängig; soll heißen es werden die
<em>Dateien</em>
des aktuellsten Commits in den Index kopiert. Hiermit werden die Änderungen von
<code>git add <em>files</em></code>
im Index rückgängig gemacht. Mit
<code>git reset</code>
kannst du alle Änderungen im Index rückgängig machen.
</li>
<li>
<code>git checkout -- <em>files</em></code>
kopiert
<em>Dateien</em>
aus dem Index in das Arbeitsverzeichnis. Damit kannst du die Änderungen im Arbeitsverzeichnis verwerfen.
</li>
</ul>
<p>
Mit der Option
<code>-p</code>
wie in
<code>git reset -p</code>
,
<code>git checkout -p</code>
, oder
<code>git add -p</code>
kann man interaktiv entscheiden welche Teile bzw. Brocken (hunks) der Änderung kopiert werden sollen.
</p>
<p>
Es ist auch möglich
<code>reset</code>
und
<code>checkout</code>
sowie
<code>add</code>
und
<code>commit</code>
jeweils zu einem Befehl zusammenzuziehen, ohne vorher explizit in den Index zu kopieren.
</p>
<div class="center">
<img src='basic-usage-2.svg.png'></div>
<ul>
<li>
<code>git commit -a </code>
ist gleichbedeutend mit
<tt>git add</tt>
auf allen seit dem letzten Commit existierenden Dateien und einem nachfolgenden
<tt>git commit</tt>
.
</li>
<li>
<code>git commit <em>files</em></code>
erzeugt einen neuen Commit mit dem Inhalt aller aufgeführten Dateien aus dem Arbeitsverzeichnis. Zusätzlich werden die
<em>Dateien</em>
in den Index kopiert.
</li>
<li>
<code>git checkout HEAD -- <em>files</em></code>
kopiert die
<em>Dateien</em>
vom letzten Commit sowohl in den Index als auch in das Arbeitsverzeichnis.
</li>
</ul>
<h2 id="conventions">Konventionen</h2>
<p>
Im weiteren werden zur Darstellung Graphen der folgenden Art verwandt.
</p>
<div class="center">
<img src='conventions.svg.png'></div>
<p>
Commits werden in Grün mit ihrem 5-Buchstaben IDs dargestellt, sie verweisen auf ihre Eltern (parent) Commits.
Branches werden in Orange dargestellt, sie zeigen auf einen einzelnen Commit, der Spitze des Branches.
Der aktuelle Branch wird mit der besonderen Referenz
<em>HEAD</em>
gekennzeichnet, diese ist dem Branch angeheftet und wandert mit zugefügten Commits mit.
In diesem Bild werden die fünf aktuellsten Commits gezeigt, wobei
<em>ed489</em>
der jüngste ist.
<em>master</em>
(current branch) zeigt auf genau diesen Commit, wohingegen
<em>maint</em>
(another branch) auf einen der Vorfahren von
<em>master</em>
verweist.
</p>
<h2 id="commands-in-detail">Kommandos im Detail</h2>
<h3 id="diff">Diff</h3>
<p>
Es gibt verschiedene Möglichkeiten die Unterschiede zwischen Commits zu betrachten.
Nachfolgend ein paar Beispiele.
An jedes dieser Kommandos können ein oder mehrere Dateinamen als Argument angehängt werden,
dies beschränkt die Darstellung der Unterschiede auf genannte Dateien.
</p>
<div class="center">
<img src='diff.svg.png'></div>
<h3 id="commit">Commit</h3>
<p>
Wenn du commitest, du dich also festlegst, erzeugt git ein neues Commit Objekt mit den Dateien des Indexes und es setzt den aktuellen Commit als Vorläufer ein.
Ebenso verschiebt es den Zeiger des aktuellen Branches auf den neuen Commit.
In dem folgenden Bild ist der aktuelle Branch
<em>master</em>
.
Vor der Ausführung des Kommandos zeigte
<em>master</em>
auf den Commit
<em>ed489</em>
.
Danach wurde ein neuer Commit
<em>f0cec</em>
mit dem Vorläufer
<em>ed489</em>
erstellt
Ausserdem wurde die Branch Referenz
<em>master</em>
auf den neuen Commit verschoben.
</p>
<div class="center">
<img src='commit-master.svg.png'></div>
<p>
Es macht dabei keinen Unterschied, ob der aktuelle Branch auf einen Commit verweist, der an der Spitze oder mitten in einem Branch hängt.
Im nachfolgenden Bild werden Änderungen an dem
<em>maint</em>
Branch, der auf einen Vorläufer Commit des Branches
<em>master</em>
verweist, commited.
Im Ergebnis entsteht der Commit
<em>1800b</em>
.
Danach ist der Branch
<em>maint</em>
nich mehr länger Vorläufer des Branches
<em>master</em>
.
Um diese wieder zusammen zu führen ist ein
<a href='#merge'>merge</a>
(oder
<a href='#rebase'>rebase</a>
) notwendig.
</p>
<div class="center">
<img src='commit-maint.svg.png'></div>
<p>
Hast du in einem Commit einen Fehler im entdeckt, so lässt sich dieser Commit einfach im Nachhinein mit
<code>git commit --amend</code>
korrigieren.
Mit diesem Befehl erstellt git einen neuen Commit der den selben Vorläufer hat wie der aktuelle Commit.
(Wird der ursprüngliche Commit von nichts anderem referenziert, so wird er für die Garbage Collection freigegben und irgendwann verworfen.)
</p>
<div class="center">
<img src='commit-amend.svg.png'></div>
<p>
Ein vierter Fall ist, wie weiter unten erläutert, das Committen mit einem
<a href="#detached">
detached
HEAD
</a>
.
</p>
<h3 id="checkout">Checkout</h3>
<p>
Mit dem
<code>checkout</code>
Befehl werden Dateien aus dem Projektarchiv oder dem Index in das Arbeitsverzeichnis kopiert. Des weiteren kann man damit den Branch wechseln.
</p>
<p>
Wird ein Dateiname (und/oder
<code>-p</code>
) angegeben, so kopiert git diese Dateien aus dem gegebenen Commit in den Index oder das Arbeitsverzeichnis . Zum Beispiel kopiert
<code>git checkout HEAD~ foo.c</code>
die Datei
<code>foo.c</code>
aus dem dem Commit, mit dem Namen
<em>HEAD~</em>
(der Vorgänger des aktuellen Commits) sowohl in das Arbeitsverzeichnis als auch in den Index.
(Wird kein Commit-Name angegeben, so werden die Dateien aus dem Index kopiert.)
Beachte: Der aktuelle Branch ändert sich nicht.
</p>
<div class="center">
<img src='checkout-files.svg.png'></div>
<p>
Wenn beim Checkout kein Dateiname sondern der Name eines (lokalen) Branches angegeben wird, so wird die Referenz
<em>HEAD</em>
auf diesen Branch verschoben.
Du wechselst "switch to" den Branch, daraufhin werden die Dateien im Index und im Arbeitsverzeichnis denen aus dem Commit angepasst.
Jede Datei die im neuen Commit (
<em>a47c3</em>
s.u.) existiert wird kopiert. Jede die im alten Commit (
<em>ed489</em>
) existiert, aber nicht im neuen, wird im Index und Arbeitsverzeichnis gelöscht. Alle weitern werden nicht angefasst.
</p>
<div class="center">
<img src='checkout-branch.svg.png'></div>
<p>
Wenn beim Checkout kein Dateiname angegeben wird und die angeführte Referenz
<em>kein</em>
(lokaler) Branch ist &mdash; also z.B. ein Tag (tag), ein Remote-Branch, eine SHA-1 ID oder etwas wie
<em>master~3</em>
&mdash; erhalten wir einen anonymen Branch, genannt
<em>detached HEAD</em>
.
Git kann schlicht dem Checkout keinen Branch-Namen zuordnen.
Mit solch einem Checkout lässt es sich einfach in der Versionsgeschichte herumspringen.
Sagen wir mal, du willst die Version 1.6.6.1 von git compilieren.
Dann kannst du einfach mit dem Befehl
<code>git checkout
v1.6.6.1</code>
(welches ein Tag und kein Branch ist) den Quellcode auschecken. Dieser lässt sich compilieren und installieren.
Danach kann man einfach zu einem weiteren Branch springen, z.B.
<code>git checkout master</code>
.
Ein Commit in einem detached HEAD verhält sich jedoch leicht anders
<a href="#detached">(s.u.)</a>
.
</p>
<div class="center">
<img src='checkout-detached.svg.png'></div>
<h3 id="detached">Commit mit losgelöstem (detached) HEAD</h3>
<p>
Ist die Referenz
<em>HEAD</em>
detached (losgelöst), so funktionieren Commits beinahe wie gehabt, es wird nur kein benannter Branch aktualisiert.
(Dies kannst du dir als anonymen Branch vorstellen.)
</p>
<div class="center">
<img src='commit-detached.svg.png'></div>
<p>
Sobald du etwas anderes auscheckst, sagen wir den Branch
<em>master</em>
, so wird der Commit (vermutlich) von keinen Zeiger mehr referenziert, der Commit ist verloren.
Beachte, nach diesem Befehl referenziert nichts mehr den Commit
<em>2eecb</em>
.
</p>
<div class="center">
<img src='checkout-after-detached.svg.png'></div>
<p>
Wenn du stattdessen diesen Zustand speichern möchtest, kannst du einen neuen Branch mit
<code>git checkout -b <em>name</em></code>
erstellen.
</p>
<div class="center">
<img src='checkout-b-detached.svg.png'></div>
<h3 id="reset">Reset</h3>
<p>
Der
<code>reset</code>
Befehl verschiebt den aktuellen Branch an eine andere Position. Optional aktualisiert er den Index und das Arbeitsverzeichnis.
Er wird auch dazu benutzt Dateien aus dem Projektarchiv in den Index zu kopieren ohne das Arbeitsverzeichnis anzufassen.
</p>
<p>
Wird ein Commit ohne Dateinamen angegeben, so wird der aktuelle Branch auf diesen Commit verschoben und der Index wird mit dem Inhalt aus diesem Commit aktualisiert.
Wird die Option
<code>--hard</code>
angegeben, so wird auch das Arbeitsverzeichnis aktualisiert. Wird stattdessen
<code>--soft</code>
angegeben, so wird weder noch aktualisiert.
</p>
<div class="center">
<img src='reset-commit.svg.png'></div>
<p>
Wird kein Commit angegeben, so wird angenommen, dass der Commit gemeint ist, auf den
<em>HEAD</em>
zeigt.
In diesem Falle wird der Branch nicht verschoben, aber es werden der Index (und gegebenenfals das Arbeitsverzeichnis, wenn der Parameter
<code>--hard</code>
angegeben ist) an den Inhalt des letzten Commits angepasst.
</p>
<div class="center">
<img src='reset.svg.png'></div>
<p>
Wird ein Dateiname (und/oder die Option
<code>-p</code>
) angegeben, so funktioniert das Kommando ähnlich wie ein
<a href='#checkout'>checkout</a>
mit einem Dateinamen, ausser, dass ausschließlich der Index (und nicht das Arbeitsverzeichnis) aktualisiert wird.
(Du kannst auch anstatt von
<em>HEAD</em>
den Commit angeben dessen Dateien genommen werden sollen.)
</p>
<div class="center">
<img src='reset-files.svg.png'></div>
<h3 id="merge">Merge</h3>
<p>
Mit
<code>merge</code>
wird ein neuer Commit erstellt, der Änderungen eines weitern Commits berücksichtigt.
Vor dem
<code>merge</code>
muss der Index dem aktuellen Commit entsprechen.
Im einfachsten Fall ist der andere Commit ein Vorläufer des aktuellen. In diesem Fall muss gar nichts getan werden.
Im nächst einfacheren Fall ist der aktuelle Commit ein Vorfahre des anderen Commits.
Die Referenz des Branches wird einfach auf den anderen Commit verschoben und dieser Commit wird ausgecheckt.
Dies wird
<em>fast-forward</em>
merge genannt.
</p>
<div class="center">
<img src='merge-ff.svg.png'></div>
<p>
In den anderen Fällen muss ein "richtiger" Merge durchgeführt werden. Du kannst dich auch für andere Strategien entscheiden,
aber standardmäßig wird ein "rekursiver" merge durchgeführt, dieser nimmt im Prinzip den aktuellen Commit (
<em>ed489</em>
s.u.), den anderen Commit (
<em>33104</em>
),
und ihren gemeinsamen Vorläufer (
<em>b325c</em>
) und führt einen
<a
href='http://en.wikipedia.org/wiki/Three-way_merge'>three-way Merge</a>
durch.
Das Ergebnis wird im Arbeitsverzeichnis und dem Index gespeichert. Dies wird dann committet, wobei der dabei erzeugte Commit zwei Eltern (
<em>33104</em>
und
<em>ed489</em>
) hat.
</p>
<div class="center">
<img src='merge.svg.png'></div>
<h3 id="cherry-pick">Cherry Pick</h3>
<p>
Der cherry-pick (Kirschen bzw. Rosinen rauspicken) Befehl "kopiert" einen Commit.
Er erzeugt einen neuen Commit auf dem aktuellen Branch mit dem selben Kommentar und Patch des anderen Commits.
</p>
<div class="center">
<img src='cherry-pick.svg.png'></div>
<h3 id="rebase">Rebase</h3>
<p>
Ein Rebase ist eine Alternative zu einem
<a href='#merge'>merge</a>
um meherere Branches zusammenzuziehen. Während ein Merge einen einzelnen neuen Commit mit zwei Eltern erzeugt und ein nicht linearen Vorgänger Historie hinterläßt,
spielt ein Rebase die Commits des aktuellen Branches auf einen anderen Branch erneut auf. Die Commit Historie bleibt linear.
Im Kern ist dies ein automatisierter Weg mehrere
<a
href='#cherry-pick'>cherry-pick</a>
Befehle nacheinander auszuführen.
</p>
<div class="center">
<img src='rebase.svg.png'></div>
<p>
Der obige Befehl nimmt sich alle Commits die im Branch
<em>topic</em>
aber nicht im Branch
<em>master</em>
existieren (konkret:
<em>169a6</em>
und
<em>2c33a</em>
), spielt dies auf den Branch
<em>master</em>
auf und verschiebt dann den
<em>HEAD</em>
auf die neue Spitze des Branches.
Beachte, die alten Commits werden verworfen, wenn nicht anderweitig Bezug auf sie genommen wird.
</p>
<p>
Mit der Option
<code>--onto</code>
läßt die Anzahl der Commits, welche neu aufgespielt werden einschränken.
Der folgende Befehl spielt auf
<em>master</em>
die aktuellsten Commits aus dem aktuellen Branch seit dem Commit
<em>169a6</em>
(ausschließlich), und zwar
<em>2c33a</em>
.
</p>
<div class="center">
<img src='rebase-onto.svg.png'></div>
<p>
Des weiteren existiert noch der Befehl
<code>git rebase --interactive</code>
, dieser ermöglicht es einem noch weit komplizierteres als ein einfaches neu aufspielen durchzuführen. Genannt sei hier das
<em>dropping</em>
,
<em>reordering</em>
,
<em>modifying</em>
, und
<em>squashing</em>
von Commits. Zu diesen lässt schwer ein schlüssiges Bild der Darstellung finden. Zur Vertiefung kann man sich an
<a
href='http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html#_interactive_mode'>git-rebase(1)</a>
versuchen.
</p>
<h2 id="technical-notes">Technische Notizen</h2>
<p>
Der Inhalt der Dateien wird nicht wirklich im Index (
<em>.git/index</em>
) oder in den Commit Objekten gespeichert.
Stattdessen wird jede Datei, identifiziert durch seinen SHA-1 Hash, in der Objekt Datenbank (
<em>.git/objects</em>
) als
<em>blob</em>
gespeichert.
Der Index führt die Dateinamen neben den Bezeichnern des assozierten Blobs, sowie weiterer Informationen, auf.
Für Commits existiert ein weiterer Datentyp, der
<em>tree</em>
. Dieser ist auch durch seinen Hash identifiziert.
Trees entsprechen den Verzeichnissen im Arbeitsverzeichnis und enthalten, entsprechend zu jedem Dateinamen und Verzeichnisnamen, eine Liste von Blobs und Trees.
Jeder Commit speichert den Bezeichner seines "top-level" Tree Elementes.
Dieser wiederum enthält alle Blobs und weitere Blobs die zu diesem Commit gehören.
</p>
<p>
Führst du einen Comit mit einem
<em>detached HEAD</em>
durch so wird der letzte Commit doch noch von etwas referenziert: Dem "reflog" von
<em>HEAD</em>
.
Allerdings verfällt diese Referenz nach einer Weile, so dass der Commit, ähnlich wie die verwaisten Commits aus
<code>git commit --amend</code>
oder
<code>git
rebase</code>
, von der "Garbage Collection" gelöscht wird.
</p>
<h2 id="glossary">Glossar</h2>
<ul>
<li> <strong>Branch :</strong>
Zweig
</li>
<li> <strong>cherry-pick :</strong>
Kirschen bzw. Rosinen rauspicken
</li>
<li>
<strong>Commit :</strong>
[Nomen] Festlegung,
<em>commit</em>
</li>
<li>
<strong>commit :</strong>
[Verb] sich auf etwas festlegen,
<em>to commit</em>
</li>
<li>
<strong>Index :</strong>
Bühne,
<em>stage, index, staging area</em>
</li>
<li>
<strong>Merge :</strong>
[Nomen] Zusammenführen,
<em>merge</em>
</li>
<li>
<strong>merge :</strong>
[Verb] etwas zusammen zu führen,
<em>to merge</em>
</li>
<li>
<strong>Projektarchiv :</strong>
<em>history</em>
</li>
<li>
<strong>Referenz :</strong>
Verweis auf etwas,
<em>reference</em>
</li>
<li>
<strong>Schnappschuss :</strong>
Momentaufnahme,
<em>snapshot</em>
</li>
<li>
<strong>Tag :</strong>
Anhänger, Etikett,
<em>tag</em>
</li>
</ul>
<hr>
<p>Copyright &copy; 2010,
<a href='mailto:lodatom@gmail.com'>Mark Lodato</a>.
German translation &copy; 2012,
<a href="mailto:mafulafunk@gmail.com">Martin Funk</a>.
</p>
<p><a rel="license"
href="https://creativecommons.org/licenses/by-nc-sa/3.0/de/"><img alt=""
src="https://i.creativecommons.org/l/by-nc-sa/3.0/de/80x15.png"></a>
Dieses Werk ist lizensiert unter <a rel="license"
href="https://creativecommons.org/licenses/by-nc-sa/3.0/de/">Creative
Commons Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 3.0 Deutschland</a>.</p>
<p><a href='translate-en.html'>Want to translate into another
language?</a></p>
</body>
</html>