Datei subtree-merges.asc übersetzt

Author: max123kl

book/07-git-tools/sections/subtree-merges.asc

@@ -1,13 +1,13 @@
 [[_subtree_merge]]
 ===== Subtree Merging
 
-The idea of the subtree merge is that you have two projects, and one of the projects maps to a subdirectory of the other one.
-When you specify a subtree merge, Git is often smart enough to figure out that one is a subtree of the other and merge appropriately.
+Der Grundgedanke des Teilbaum-Merge besteht darin, dass Sie zwei Projekte haben und eines der Projekte auf ein Unterverzeichnis des anderen Projekts verweist.
+Wenn Sie einen Teilbaum-Merge durchführen, ist Git so versiert zu erkennen, dass das ein Unterverzeichnis ein Teilbaum des anderen ist und es entsprechend mergen.
 
-We'll go through an example of adding a separate project into an existing project and then merging the code of the second into a subdirectory of the first.
+Wir werden ein Beispiel durcharbeiten, bei dem ein separates Projekt in ein bestehendes Projekt eingefügt und dann der Code des zweiten Projekts in ein Unterverzeichnis des ersten Projekts gemergt wird.
 
-First, we'll add the Rack application to our project.
-We'll add the Rack project as a remote reference in our own project and then check it out into its own branch:
+Zunächst werden wir die Anwendung „Rack“ zu unserem Projekt hinzufügen.
+Wir werden das Rack-Projekt in unserem eigenen Projekt als Remote-Referenz einbinden und es dann in einem eigenen Branch auschecken:
 
 [source,console]
 ----
@@ -29,8 +29,8 @@ Branch rack_branch set up to track remote branch refs/remotes/rack_remote/master
 Switched to a new branch "rack_branch"
 ----
 
-Now we have the root of the Rack project in our `rack_branch` branch and our own project in the `master` branch.
-If you check out one and then the other, you can see that they have different project roots:
+Jetzt haben wir das Root-Verzeichnis des Rack-Projekts in unserem `rack_branch` und unser eigenes Projekt im `master`-Branch.
+Wenn Sie die beiden Branches prüfen, können Sie sehen, dass sie unterschiedliche Projekt-Roots haben:
 
 [source,console]
 ----
@@ -43,33 +43,33 @@ $ ls
 README
 ----
 
-This is sort of a strange concept.
-Not all the branches in your repository actually have to be branches of the same project.
-It's not common, because it's rarely helpful, but it's fairly easy to have branches contain completely different histories.
+Das ist ein irgendwie merkwürdiges Konzept.
+Nicht alle Branches in Ihrem Repository müssen unbedingt Branches desselben Projektes sein.
+Es ist nicht allgemein üblich, weil es selten hilfreich ist. Allerdings ist es ziemlich wahrscheinlich, dass die Branches völlig unterschiedliche Verläufe enthalten.
 
-In this case, we want to pull the Rack project into our `master` project as a subdirectory.
-We can do that in Git with `git read-tree`.
-You'll learn more about `read-tree` and its friends in <<ch10-git-internals#ch10-git-internals>>, but for now know that it reads the root tree of one branch into your current staging area and working directory.
-We just switched back to your `master` branch, and we pull the `rack_branch` branch into the `rack` subdirectory of our `master` branch of our main project:
+In unserem Fall wollen wir das Rack-Projekt als Unterverzeichnis in unser Projekt `master` einbringen.
+Das können wir in Git mit `git read-tree` tun.
+Mehr über den Befehl `read-tree` und seiner Verwandten erfahren Sie in <<ch10-git-internals#ch10-git-internals>>. Vorab sollen Sie erfahren, dass er den Root-Tree eines Branchs in Ihre aktuelle Staging-Area und Ihr aktuelles Arbeitsverzeichnis einliest.
+Wir sind gerade zu Ihrem Branch `master` zurückgewechselt und ziehen den Zweig `rack_branch` in das Unterverzeichnis `rack` unseres `master`-Branchs des Hauptprojektes:
 
 [source,console]
 ----
 $ git read-tree --prefix=rack/ -u rack_branch
 ----
 
-When we commit, it looks like we have all the Rack files under that subdirectory – as though we copied them in from a tarball.
-What gets interesting is that we can fairly easily merge changes from one of the branches to the other.
-So, if the Rack project updates, we can pull in upstream changes by switching to that branch and pulling:
+Bei einem Commit sieht es so aus, als befänden sich alle Rack-Dateien unterhalb dieses Unterverzeichnisses – als ob wir sie aus einem Tarball hineinkopiert hätten.
+Interessant ist, dass wir Änderungen in einem der Branches relativ leicht mit anderen Branches mergen können.
+Falls das Rack-Projekt aktualisiert wird, können wir die Änderungen einbinden, indem wir zu diesem Branch wechseln und pullen:
 
 [source,console]
 ----
 $ git checkout rack_branch
 $ git pull
 ----
 
-Then, we can merge those changes back into our `master` branch.
-To pull in the changes and prepopulate the commit message, use the `--squash` option, as well as the recursive merge strategy's `-Xsubtree` option.
-(The recursive strategy is the default here, but we include it for clarity.)
+Dann können wir diese Änderungen wieder in unserem Branch `master` zusammenführen.
+Um die Änderungen zu pullen und die Commit-Nachricht vorzubereiten, verwendet man die Option `--squash` sowie die Option `-Xsubtree` der rekursiven Merge-Strategie.
+(Die rekursive Strategie ist hier die Voreinstellung, aber wir fügen sie der Klarheit halber ein.)
 
 [source,console]
 ----
@@ -79,23 +79,23 @@ Squash commit -- not updating HEAD
 Automatic merge went well; stopped before committing as requested
 ----
 
-All the changes from the Rack project are merged in and ready to be committed locally.
-You can also do the opposite – make changes in the `rack` subdirectory of your `master` branch and then merge them into your `rack_branch` branch later to submit them to the maintainers or push them upstream.
+Alle Änderungen aus dem Rack-Projekt werden in das Projekt gemergt und können lokal committet werden.
+Sie können auch das Gegenteil tun – Änderungen im Unterverzeichnis `rack` Ihres `master`-Branchss vornehmen und sie dann später in Ihren Branch `rack_branch` mergen, um sie den Autoren zu übermitteln oder sie zum Upstream zu pushen.
 
-This gives us a way to have a workflow somewhat similar to the submodule workflow without using submodules (which we will cover in <<ch07-git-tools#_git_submodules>>).
-We can keep branches with other related projects in our repository and subtree merge them into our project occasionally.
-It is nice in some ways, for example all the code is committed to a single place.
-However, it has other drawbacks in that it's a bit more complex and easier to make mistakes in reintegrating changes or accidentally pushing a branch into an unrelated repository.
+Dadurch haben wir einen Workflow, der dem Submodul-Workflow ähnelt, ohne Submodule zu verwenden (das wir in <<ch07-git-tools#_git_submodules>> behandeln werden).
+Wir können Branches mit anderen verwandten Projekten in unserem Repository vorhalten und sie gelegentlich in unserem Projekt verschmelzen.
+In gewisser Weise ist das nützlich. Beispielsweise kann der gesamte Code an einen einzigen Ort übermittelt werden.
+Allerdings gibt es auch Nachteile. Es ist etwas komplizierter und somit leichter, Fehler bei der Re-Integration von Änderungen zu machen oder versehentlich einen Branch in ein nicht relevantes Repository zu pushen.
 
-Another slightly weird thing is that to get a diff between what you have in your `rack` subdirectory and the code in your `rack_branch` branch – to see if you need to merge them – you can't use the normal `diff` command.
-Instead, you must run `git diff-tree` with the branch you want to compare to:
+Eine weitere etwas eigenartige Eigenschaft ist, dass Sie den Unterschied zwischen dem, was in Ihrem Unterverzeichnis `rack` steht, und dem Code in Ihrem Branch `rack_branch` nicht mit dem normalen `diff`-Befehl erhalten können ( um zu prüfen, ob Sie sie mergen müssen).
+Stattdessen müssen Sie `git diff-tree` auf dem Branch, mit dem Sie vergleichen wollen, ausführen:
 
 [source,console]
 ----
 $ git diff-tree -p rack_branch
 ----
 
-Or, to compare what is in your `rack` subdirectory with what the `master` branch on the server was the last time you fetched, you can run
+Um den Inhalt Ihres `rack`-Unterverzeichnisses mit dem Branch `master` auf dem Remote-Server zu vergleichen, können Sie auch folgendes ausführen:
 
 [source,console]
 ----