Merge pull request #19 from max123kl/chapter-09-2

Chapter 09-2

Author: max123kl

book/09-git-and-other-scms/sections/client-hg.asc

@@ -1,19 +1,19 @@
-==== Git and Mercurial
+==== Git und Mercurial
 
 (((Interoperation with other VCSs, Mercurial)))
 (((Mercurial)))
-The DVCS universe is larger than just Git.
-In fact, there are many other systems in this space, each with their own angle on how to do distributed version control correctly.
-Apart from Git, the most popular is Mercurial, and the two are very similar in many respects.
+Das DVCS-Universum besteht nicht nur aus nur Git.
+In diesem Bereich gibt es viele andere Systeme, jedes hat seinen eigenen Ansatz, wie eine verteilte Versionskontrolle zu funktionieren hat.
+Neben Git ist Mercurial am populärsten und die beiden sind sich in vielerlei Hinsicht sehr ähnlich.
 
-The good news, if you prefer Git's client-side behavior but are working with a project whose source code is controlled with Mercurial, is that there's a way to use Git as a client for a Mercurial-hosted repository.
-Since the way Git talks to server repositories is through remotes, it should come as no surprise that this bridge is implemented as a remote helper.
-The project's name is git-remote-hg, and it can be found at https://github.com/felipec/git-remote-hg[].
+Die gute Nachricht, wenn Sie Gits clientseitiges Verhalten bevorzugen, aber mit einem Projekt arbeiten, dessen Quellcode mit Mercurial verwaltet wird, dann ist es möglich, Git als Client für ein von Mercurial gehostetes Repository zu verwenden.
+Da die Art und Weise, wie Git über Remotes mit Server-Repositories kommuniziert, sollte es nicht überraschen, dass diese Bridge als Remote-Helfer implementiert ist.
+Der Name des Projekts lautet git-remote-hg und ist unter https://github.com/felipec/git-remote-hg[] zu finden.
 
 ===== git-remote-hg
 
-First, you need to install git-remote-hg.
-This basically entails dropping its file somewhere in your path, like so:
+Zuerst müssen Sie git-remote-hg installieren.
+Im Wesentlichen geht es darum, die Datei irgendwo in Ihrem Pfad abzulegen, so wie hier:
 
 [source,console]
 ----
@@ -22,35 +22,35 @@ $ curl -o ~/bin/git-remote-hg \
 $ chmod +x ~/bin/git-remote-hg
 ----
 
-…assuming `~/bin` is in your `$PATH`.
-Git-remote-hg has one other dependency: the `mercurial` library for Python.
-If you have Python installed, this is as simple as:
+…vorausgesetzt (in einer Linux-Umgebung), `~/bin` ist in Ihrem `$PATH`.
+Git-remote-hg hat noch eine weitere Abhängigkeit: die `mercurial` Library für Python.
+Wenn Sie Python installiert schon  haben, ist das einfach:
 
 [source,console]
 ----
 $ pip install mercurial
 ----
 
-(If you don't have Python installed, visit https://www.python.org/[] and get it first.)
+(Wenn Sie Python noch nicht installiert haben, besuchen Sie https://www.python.org/[] und besorgen Sie es sich zuerst.)
 
-The last thing you'll need is the Mercurial client.
-Go to https://www.mercurial-scm.org/[] and install it if you haven't already.
+Als Letztes brauchen Sie den Mercurial-Client.
+Gehen Sie zu https://www.mercurial-scm.org/[] und installieren Sie ihn, falls Sie es noch nicht getan haben.
 
-Now you're ready to rock.
-All you need is a Mercurial repository you can push to.
-Fortunately, every Mercurial repository can act this way, so we'll just use the "hello world" repository everyone uses to learn Mercurial:
+Jetzt sind Sie bereit zu abrocken.
+Alles, was Sie benötigen, ist ein Mercurial-Repository, auf das Sie zugreifen können.
+Glücklicherweise kann sich jedes Mercurial-Repository so verhalten, also verwenden wir einfach das "hello world"-Repository, das jeder benutzt, um Mercurial zu lernen:
 
 [source,console]
 ----
 $ hg clone http://selenic.com/repo/hello /tmp/hello
 ----
 
-===== Getting Started
+===== Erste Schritte
 
-Now that we have a suitable ``server-side'' repository, we can go through a typical workflow.
-As you'll see, these two systems are similar enough that there isn't much friction.
+Nun, da wir über ein geeignetes „serverseitiges“ Repository verfügen, können wir einen typischen Workflow durchlaufen.
+Wie Sie sehen werden, sind diese beiden Systeme ähnlich genug, dass es keine große Überschneidungen gibt.
 
-As always with Git, first we clone:
+Wie immer mit Git, wir klonen zuerst:
 
 [source,console]
 ----
@@ -61,13 +61,13 @@ $ git log --oneline --graph --decorate
 * 65bb417 Create a standard "hello, world" program
 ----
 
-You'll notice that working with a Mercurial repository uses the standard `git clone` command.
-That's because git-remote-hg is working at a fairly low level, using a similar mechanism to how Git's HTTP/S protocol is implemented (remote helpers).
-Since Git and Mercurial are both designed for every client to have a full copy of the repository history, this command makes a full clone, including all the project's history, and does it fairly quickly.
+Wie Sie sehen, verwendet man bei der Arbeit mit einem Mercurial-Repository den Standardbefehl `git clone`.
+Das liegt daran, dass git-remote-hg auf einem relativ niedrigen Level arbeitet und einen ähnlichen Mechanismus verwendet, wie es die Implementierung des HTTP/S-Protokolls in Git ist (Remote-Helfer).
+Da Git und Mercurial beide so konzipiert sind, dass jeder Client eine vollständige Kopie der Repository-Historie hat, erstellt dieser Befehl relativ schnell einen vollständigen Klon, einschließlich der gesamten Projekthistorie.
 
-The log command shows two commits, the latest of which is pointed to by a whole slew of refs.
-It turns out some of these aren't actually there.
-Let's take a look at what's actually in the `.git` directory:
+Der log-Befehl zeigt zwei Commits, von denen der letzte von einer ganzen Reihe von Refs angeführt wird.
+Wie sich herausstellt, sind einige davon nicht wirklich da.
+Werfen wir einen Blick darauf, was sich wirklich im `.git` Verzeichnis befindet:
 
 [source,console]
 ----
@@ -91,13 +91,13 @@ $ tree .git/refs
 9 directories, 5 files
 ----
 
-Git-remote-hg is trying to make things more idiomatically Git-esque, but under the hood it's managing the conceptual mapping between two slightly different systems.
-The `refs/hg` directory is where the actual remote refs are stored.
-For example, the `refs/hg/origin/branches/default` is a Git ref file that contains the SHA-1 starting with ``ac7955c'', which is the commit that `master` points to.
-So the `refs/hg` directory is kind of like a fake `refs/remotes/origin`, but it has the added distinction between bookmarks and branches.
+Git-remote-hg versucht sich idiomatisch (begrifflich) an Git anzunähern, aber im Hintergrund verwaltet es die konzeptionelle Zuordnung zwischen zwei leicht unterschiedlichen Systemen.
+Im Verzeichnis `refs/hg` werden die aktuellen Remote-Referenzen gespeichert.
+Zum Beispiel ist die `refs/hg/origin/branches/default` eine Git ref-Datei, die das SHA-1 enthält und mit „ac7955c“ beginnt. Das ist der Commit, auf den `master` zeigt.
+Das Verzeichnis `refs/hg` ist also eine Art gefälschtes `refs/remotes/origin`, aber es unterscheidet zusätzlich zwischen Lesezeichen und Zweigen.
 
-The `notes/hg` file is the starting point for how git-remote-hg maps Git commit hashes to Mercurial changeset IDs.
-Let's explore a bit:
+Die Datei `notes/hg` ist der Ausgangspunkt dafür, wie git-remote-hg Git-Commit-Hashes auf Mercurial-Changeset-IDs abbildet.
+Lassen Sie uns ein wenig experimentieren:
 
 [source,console]
 ----
@@ -119,28 +119,28 @@ $ git cat-file -p ac9117f
 0a04b987be5ae354b710cefeba0e2d9de7ad41a9
 ----
 
-So `refs/notes/hg` points to a tree, which in the Git object database is a list of other objects with names.
-`git ls-tree` outputs the mode, type, object hash, and filename for items inside a tree.
-Once we dig down to one of the tree items, we find that inside it is a blob named ``ac9117f'' (the SHA-1 hash of the commit pointed to by `master`), with contents ``0a04b98'' (which is the ID of the Mercurial changeset at the tip of the `default` branch).
+So zeigt refs/notes/hg auf einen Verzeichnisbaum, der in der Git-Objektdatenbank eine Liste anderer Objekte mit Namen ist.
+`git ls-tree` gibt Modus, Typ, Objekt-Hash und Dateiname für Elemente innerhalb eines Baums aus.
+Sobald wir uns auf eines der Baumelemente festgelegt haben, stellen wir fest, dass sich darin ein „ac9117f“ Blob (der SHA-1-Hash des Commit, auf den `master` zeigt) befindet. Inhaltlich ist er identisch mit "0a04b98" (das ist die ID des Mercurial-Changesets an der Spitze der `default` Branch).
 
-The good news is that we mostly don't have to worry about all of this.
-The typical workflow won't be very different from working with a Git remote.
+Die gute Nachricht ist, dass wir uns darüber meistens keine Sorgen machen müssen.
+Der typische Arbeitsablauf unterscheidet sich nicht wesentlich von der Arbeit mit einem Git-Remote.
 
-There's one more thing we should attend to before we continue: ignores.
-Mercurial and Git use a very similar mechanism for this, but it's likely you don't want to actually commit a `.gitignore` file into a Mercurial repository.
-Fortunately, Git has a way to ignore files that's local to an on-disk repository, and the Mercurial format is compatible with Git, so you just have to copy it over:
+Noch eine Besonderheit, um die wir uns kümmern sollten, bevor wir fortfahren: Die Auslassungen.
+Mercurial und Git verwenden dafür einen sehr ähnlichen Mechanismus, aber es ist durchaus möglich, dass Sie eine `.gitignore` Datei nicht wirklich in ein Mercurial Repository übertragen wollen.
+Glücklicherweise hat Git eine Möglichkeit, Dateien zu ignorieren, die lokal in einem On-Disk-Repository liegen. Das Mercurial-Format ist kompatibel mit Git, so dass Sie es nur kopieren müssen:
 
 [source,console]
 ----
 $ cp .hgignore .git/info/exclude
 ----
 
-The `.git/info/exclude` file acts just like a `.gitignore`, but isn't included in commits.
+Die Datei `.git/info/exclude` verhält sich wie eine `.gitignore`, wird aber nicht in den Commits aufgenommen.
 
 ===== Workflow
 
-Let's assume we've done some work and made some commits on the `master` branch, and you're ready to push it to the remote repository.
-Here's what our repository looks like right now:
+Nehmen wir an, wir haben einige Arbeiten erledigt und einige Commits auf den `master` Branch gemacht und Sie sind so weit, ihn in das Remote-Repository zu pushen.
+Nun sieht unser Repository momentan so aus:
 
 [source,console]
 ----
@@ -151,8 +151,8 @@ $ git log --oneline --graph --decorate
 * 65bb417 Create a standard "hello, world" program
 ----
 
-Our `master` branch is two commits ahead of `origin/master`, but those two commits exist only on our local machine.
-Let's see if anyone else has been doing important work at the same time:
+Unser `master` Branch ist zwei Commits vor dem `origin/master`, aber diese beiden Commits existieren nur auf unserem lokalen Rechner.
+Schauen wir mal nach, ob jemand anderes zur gleichen Zeit wichtige Arbeit geleistet hat:
 
 [source,console]
 ----
@@ -171,9 +171,9 @@ $ git log --oneline --graph --decorate --all
 * 65bb417 Create a standard "hello, world" program
 ----
 
-Since we used the `--all` flag, we see the ``notes'' refs that are used internally by git-remote-hg, but we can ignore them.
-The rest is what we expected; `origin/master` has advanced by one commit, and our history has now diverged.
-Unlike the other systems we work with in this chapter, Mercurial is capable of handling merges, so we're not going to do anything fancy.
+Da wir das `--all` Flag verwendet haben, sehen wir die „notes“ Refs, die intern von git-remote-hg verwendet werden, die wir aber ignorieren können.
+Den Rest haben wir erwartet. `origin/master` ist um einen Commit fortgeschritten. Unser Verlauf hat sich dadurch verändert.
+Anders als bei anderen Systemen, mit denen wir in diesem Kapitel arbeiten, ist Mercurial in der Lage, Merges zu verarbeiten, so dass wir nichts Ausgefallenes tun müssen.
 
 [source,console]
 ----
@@ -193,8 +193,8 @@ $ git log --oneline --graph --decorate
 * 65bb417 Create a standard "hello, world" program
 ----
 
-Perfect.
-We run the tests and everything passes, so we're ready to share our work with the rest of the team:
+Perfekt.
+Wir führen die Tests durch und alles passt, also sind wir so weit, dass wir unsere Arbeit mit dem Rest des Teams teilen können:
 
 [source,console]
 ----
@@ -203,8 +203,8 @@ To hg::/tmp/hello
    df85e87..0c64627  master -> master
 ----
 
-That's it!
-If you take a look at the Mercurial repository, you'll see that this did what we'd expect:
+Das wars!
+Wenn Sie einen Blick auf das Mercurial-Repository werfen, werden Sie feststellen, dass genau das getan wurde, was wir erwarten durften:
 
 [source,console]
 ----
@@ -228,16 +228,16 @@ o  0   0a04b987be5a   2005-08-26 01:20 -0700   mpm
      Create a standard "hello, world" program
 ----
 
-The changeset numbered _2_ was made by Mercurial, and the changesets numbered _3_ and _4_ were made by git-remote-hg, by pushing commits made with Git.
+Das Change-Set mit der Nummer _2_ wurde von Mercurial vorgenommen, und die Change-Sets mit der Nummer _3_ und _4_ wurden von git-remote-hg durchgeführt, indem Commits mit Git gepusht wurden.
 
-===== Branches and Bookmarks
+===== Branches und Bookmarks
 
-Git has only one kind of branch: a reference that moves when commits are made.
-In Mercurial, this kind of a reference is called a ``bookmark,'' and it behaves in much the same way as a Git branch.
+Git hat nur eine Art von Branch: eine Referenz, die sich verschiebt, wenn Commits gemacht werden.
+In Mercurial wird diese Art von Referenz als „bookmark“ (dt. Lesezeichen) bezeichnet, und sie verhält sich ähnlich wie ein Git-Branch.
 
-Mercurial's concept of a ``branch'' is more heavyweight.
-The branch that a changeset is made on is recorded _with the changeset_, which means it will always be in the repository history.
-Here's an example of a commit that was made on the `develop` branch:
+Das Konzept von Mercurial eines „Branchs“ ist höher gewichtet.
+Der Branch, auf den ein Changeset durchgeführt wird, wird _zusammen mit dem Changeset_ aufgezeichnet, d.h. er befindet sich immer im Repository-Verlauf.
+Hier ist ein Beispiel für einen Commit, der auf dem `develop` Branch gemacht wurde:
 
 [source,console]
 ----
@@ -250,11 +250,11 @@ date:        Thu Aug 14 20:06:38 2014 -0700
 summary:     More documentation
 ----
 
-Note the line that begins with ``branch''.
-Git can't really replicate this (and doesn't need to; both types of branch can be represented as a Git ref), but git-remote-hg needs to understand the difference, because Mercurial cares.
+Achten Sie darauf, dass die Zeile mit „branch“ beginnt.
+Git kann das nicht wirklich nachahmen (und muss es auch nicht; beide Arten von Zweigen können als Git ref dargestellt werden), aber git-remote-hg muss den Unterschied erkennen, denn für Mercurial ist er wichtig.
 
-Creating Mercurial bookmarks is as easy as creating Git branches.
-On the Git side:
+Das Anlegen von Mercurial-Lesezeichen ist so einfach wie das Erstellen von Git-Branches.
+Auf der Seite vom Git machen Sie:
 
 [source,console]
 ----
@@ -265,8 +265,8 @@ To hg::/tmp/hello
  * [new branch]      featureA -> featureA
 ----
 
-That's all there is to it.
-On the Mercurial side, it looks like this:
+Das ist alles, was es dazu zu sagen gibt.
+Auf der Mercurial-Seite sieht es dann folgendermaßen aus:
 
 [source,console]
 ----
@@ -295,10 +295,10 @@ o  0   0a04b987be5a   2005-08-26 01:20 -0700   mpm
      Create a standard "hello, world" program
 ----
 
-Note the new `[featureA]` tag on revision 5.
-These act exactly like Git branches on the Git side, with one exception: you can't delete a bookmark from the Git side (this is a limitation of remote helpers).
+Beachten Sie den neuen `[featureA]` Tag auf Revision 5.
+Die verhalten sich genau wie Git-Branches auf der Git-Seite, mit einer Ausnahme: Sie können ein Lesezeichen auf der Git-Seite nicht löschen (das ist eine Einschränkung des Remote-Helfers).
 
-You can work on a ``heavyweight'' Mercurial branch also: just put a branch in the `branches` namespace:
+Sie können auch an einem „schwergewichtigen“ Mercurial-Branch arbeiten: Bringen Sie einfach einen Branch in den `branches` Namensraum:
 
 [source,console]
 ----
@@ -311,7 +311,7 @@ To hg::/tmp/hello
  * [new branch]      branches/permanent -> branches/permanent
 ----
 
-Here's what that looks like on the Mercurial side:
+So sieht das dann auf der Mercurial-Seite aus:
 
 [source,console]
 ----
@@ -344,11 +344,11 @@ o    changeset:   5:bd5ac26f11f9
 [...]
 ----
 
-The branch name ``permanent'' was recorded with the changeset marked _7_.
+Der Branch-Name „permanent“ wurde mit dem Change-Set _7_ eingetragen.
 
-From the Git side, working with either of these branch styles is the same: just checkout, commit, fetch, merge, pull, and push as you normally would.
-One thing you should know is that Mercurial doesn't support rewriting history, only adding to it.
-Here's what our Mercurial repository looks like after an interactive rebase and a force-push:
+Seitens von Git ist die Arbeit mit einem dieser Branch-Stile die gleiche: Einfach auschecken, committen, fetchen, mergen, pullen, und pushen, wie Sie es üblicherweise machen würden.
+Eine Sache, die Sie wissen sollten, ist, dass Mercurial das Überschreiben der Historie nicht unterstützt, sondern nur hinzufügt.
+Das Mercurial-Repository sieht nach einem interaktiven Rebase und einem Force-Push so aus:
 
 [source,console]
 ----
@@ -387,11 +387,11 @@ o  0   0a04b987be5a   2005-08-26 01:20 -0700   mpm
      Create a standard "hello, world" program
 ----
 
-Changesets _8_, _9_, and _10_ have been created and belong to the `permanent` branch, but the old changesets are still there.
-This can be *very* confusing for your teammates who are using Mercurial, so try to avoid it.
+Die Changesets _8_, _9_ und _10_ wurden angelegt und gehören zum `permanent` Branch, aber die alten Changesets sind immer noch vorhanden.
+Das kann für Ihre Teamkollegen, die Mercurial verwenden, *sehr verwirrend* sein, also versuchen Sie es zu vermeiden.
 
 
-===== Mercurial Summary
+===== Mercurial Zusammenfassung
 
-Git and Mercurial are similar enough that working across the boundary is fairly painless.
-If you avoid changing history that's left your machine (as is generally recommended), you may not even be aware that the other end is Mercurial.
+Git und Mercurial sind sich ähnlich genug, um über die eigene Umgebung hinaus schmerzlos zu arbeiten.
+Wenn Sie vermeiden, den Verlauf zu ändern, der Ihren Computer verlässt (was allgemein empfohlen wird), merken Sie wahrscheinlich nicht einmal, dass am anderen Ende Mercurial verwendet wird.

status.json

@@ -85,7 +85,7 @@
     },
     "09-git-and-other-scms": {
       "1-git-and-other-scms.asc": 100,
-      "sections/client-hg.asc": 0,
+      "sections/client-hg.asc": 100,
       "sections/client-p4.asc": 0,
       "sections/client-svn.asc": 100,
       "sections/client-tfs.asc": 0,